PLDroidCameraStreaming 是一个适用于 Android 的 RTMP 直播推流 SDK，可高度定制化和二次开发。特色是同时支持 H.264 软编／硬编和 AAC 软编／硬编。支持 Android Camera 画面捕获，并进行 H.264 编码，以及支持 Android 麦克风音频采样并进行 AAC 编码；还实现了一套可供开发者选择的编码参数集合，以便灵活调节相应的分辨率和码率；同时，SDK 提供数据源回调接口，用户可进行 Filter 处理。借助 PLDroidCameraStreaming ，开发者可以快速构建一款类似 Meerkat 或 Periscope 的 Android 直播应用。

• 支持 H.264 和 AAC 软编（推荐）
• 支持 H.264 和 AAC 硬编
• 软编支持 Android Min API 15（Android 4.0.3）及其以上版本
• 硬编支持 Android Min API 18（Android 4.3）及其以上版本
• 支持构造带安全授权凭证的 RTMP 推流地址
• 支持 RTMP 封包及推流
• 支持 RTMP 推流自适应网络质量动态切换码率或自定义策略
• 支持数据源回调接口，可自定义 Filter (滤镜) 特效处理
• 支持前后置摄像头，以及动态切换
• 支持自动对焦
• 支持手动对焦
• 支持 Encoding Mirror 设置
• 支持 Zoom 操作
• 支持 Mute/Unmute
• 支持闪光灯操作
• 支持纯音频推流，以及后台运行
• 支持截帧功能
• 支持动态更改 Encoding Orientation
• 支持动态切换横竖屏
• 支持蓝牙麦克风
• 支持 ARM, ARMv7a, ARM64v8a, X86 主流芯片体系架构

以下是目前已经在真机上验证通过的机型列表，您也可以在 Issue 中添加您测试通过的机型信息，感谢！

• 使用方法
  • 配置工程
  • 权限
  • 示例代码
  • 混淆
• 版本历史

从 releases/ 目录获取：

pldroid-camera-streaming-xxx.jar

arm64-v8a/libpldroid_streaming_aac_encoder.so
arm64-v8a/libpldroid_streaming_core.so
arm64-v8a/libpldroid_streaming_h264_encoder.so

armeabi/libpldroid_streaming_aac_encoder.so
armeabi/libpldroid_streaming_core.so
armeabi/libpldroid_streaming_h264_encoder.so

armeabi-v7a/libpldroid_streaming_aac_encoder.so
armeabi-v7a/libpldroid_streaming_core.so
armeabi-v7a/libpldroid_streaming_h264_encoder.so

x86/libpldroid_streaming_aac_encoder.so
x86/libpldroid_streaming_core.so
x86/libpldroid_streaming_h264_encoder.so

并在项目中加入对应的 jar / so 文件的依赖关系，可参考 PLDroidCameraStreamingDemo 中的做法。

在项目开始前，您需要在 AndroidManifest.xml 中添加如下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-feature android:glEsVersion="0x00020000" android:required="true" />

可参考 PLDroidCameraStreamingDemo 中的做法。

1. 编写布局文件

<com.pili.pldroid.streaming.widget.AspectFrameLayout
    android:id="@+id/cameraPreview_afl"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_centerInParent="true" >

    <android.opengl.GLSurfaceView
        android:id="@+id/cameraPreview_surfaceView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_gravity="center" />
</com.pili.pldroid.streaming.widget.AspectFrameLayout>

2. 初始化 Layout 和 View

AspectFrameLayout afl = (AspectFrameLayout) findViewById(R.id.cameraPreview_afl);
GLSurfaceView glSurfaceView = (GLSurfaceView) findViewById(R.id.cameraPreview_surfaceView);

3. 实例化并初始化 StreamingProfile、Stream、CameraStreamingSetting

streamJsonStrFromServer 是由服务端返回的一段 JSON String，该 JSON String 描述了 Stream 的结构。通常，您可以使用 Pili 服务端 SDK 的 getStream(streamId) 方法来获取一个 Stream 对象，在服务端并将该对象以 JSON String 格式输出，该输出即是 streamJsonStrFromServer 变量的内容。从业务服务器获取对应的 Stream 可参考 MainActivity.java 中的 requestByHttpPost 方法。

然后根据 streamJsonStrFromServer 构造 JSONObject 类型的对象 streamJson。

String streamJsonStrFromServer = "stream json string from your server";

JSONObject streamJson = null;
try {
    streamJson = new JSONObject(streamJsonStrFromServer);
} catch (JSONException e) {
    e.printStackTrace();
}

Stream stream = new Stream(streamJson);

StreamingProfile profile = new StreamingProfile();
profile.setVideoQuality(StreamingProfile.VIDEO_QUALITY_MEDIUM1)
       .setAudioQuality(StreamingProfile.AUDIO_QUALITY_HIGH2)
       .setStream(stream);

CameraStreamingSetting setting = new CameraStreamingSetting();
setting.setCameraId(Camera.CameraInfo.CAMERA_FACING_BACK)
       .setContinuousFocusModeEnabled(true)
       .setCameraPrvSizeLevel(CameraStreamingSetting.PREVIEW_SIZE_LEVEL.MEDIUM)
       .setCameraPrvSizeRatio(CameraStreamingSetting.PREVIEW_SIZE_RATIO.RATIO_4_3);

用户可调用 profile.setPreferredVideoEncodingSize(int w, int h) 设置一个偏好 Video Encoding size。

• SDK 预定义的 Video Quality 列表：

public static final int VIDEO_QUALITY_LOW1;
public static final int VIDEO_QUALITY_LOW2;
public static final int VIDEO_QUALITY_LOW3;

public static final int VIDEO_QUALITY_MEDIUM1;
public static final int VIDEO_QUALITY_MEDIUM2;
public static final int VIDEO_QUALITY_MEDIUM3;

public static final int VIDEO_QUALITY_HIGH1;
public static final int VIDEO_QUALITY_HIGH2;
public static final int VIDEO_QUALITY_HIGH3;

• SDK 预定义的 Audio Quality 列表：

public static final int AUDIO_QUALITY_LOW1;
public static final int AUDIO_QUALITY_LOW2;

public static final int AUDIO_QUALITY_MEDIUM1;
public static final int AUDIO_QUALITY_MEDIUM2;

public static final int AUDIO_QUALITY_HIGH1;
public static final int AUDIO_QUALITY_HIGH2;

• SDK 预定义的 Video Encoding Size 列表：

public static final int VIDEO_ENCODING_HEIGHT_240;
public static final int VIDEO_ENCODING_HEIGHT_480;
public static final int VIDEO_ENCODING_HEIGHT_544;
public static final int VIDEO_ENCODING_HEIGHT_720;
public static final int VIDEO_ENCODING_HEIGHT_1088;

• Video Quality 配置表

• Audio Quality 配置表

• Video Encoding Size 配置表

若设置一个未被 SDK 支持的 quality，将会得到 IllegalArgumentException("Cannot support the quality:" + quality) 异常。

• SDK 预定义的 preivew size level 列表：

CameraStreamingSetting.PREVIEW_SIZE_LEVEL.SMALL
CameraStreamingSetting.PREVIEW_SIZE_LEVEL.MEDIUM
CameraStreamingSetting.PREVIEW_SIZE_LEVEL.LARGE

• SDK 预定义的 preview size ratio 列表：

CameraStreamingSetting.PREVIEW_SIZE_RATIO.RATIO_4_3
CameraStreamingSetting.PREVIEW_SIZE_RATIO.RATIO_16_9

SDK 会根据您设置的 ratio 、 level 从系统支持的 preview size 列表中找到最佳的 size

若缺少上述步骤，SDK 默认使用如下设置：

Camera Id      : Camera.CameraInfo.CAMERA_FACING_BACK
Publish Url    : Environment.getExternalStorageDirectory().getAbsolutePath() + "/pldroid-recording.mp4"
Audio Quality  : StreamingProfile.AUDIO_QUALITY_LOW1
Video Quality  : StreamingProfile.VIDEO_QUALITY_LOW1
Prv Size Level : MEDIUM
Prv Size Ratio : RATIO_16_9

4. 实例化并初始化核心类 CameraStreamingManager

• Camera Streaming

硬编初始化

mCameraStreamingManager = new CameraStreamingManager(this, afl, glSurfaceView, EncodingType.HW_VIDEO_WITH_HW_AUDIO_CODEC);
mCameraStreamingManager.prepare(setting, profile);
mCameraStreamingManager.setStreamingStateListener(this);

软编初始化

mCameraStreamingManager = new CameraStreamingManager(this, afl, glSurfaceView, EncodingType.SW_VIDEO_WITH_SW_AUDIO_CODEC);
mCameraStreamingManager.prepare(setting, profile);
mCameraStreamingManager.setStreamingStateListener(this);

• 纯音频推流

软编初始化

mCameraStreamingManager = new CameraStreamingManager(this, EncodingType.SW_AUDIO_CODEC);
mCameraStreamingManager.prepare(profile);
mCameraStreamingManager.setStreamingStateListener(this);

硬编初始化

mCameraStreamingManager = new CameraStreamingManager(this, EncodingType.HW_AUDIO_CODEC);
mCameraStreamingManager.prepare(setting, profile);
mCameraStreamingManager.setStreamingStateListener(this);

目前支持的 EncodingType 有：

HW_VIDEO_WITH_HW_AUDIO_CODEC,
SW_VIDEO_WITH_HW_AUDIO_CODEC,
SW_VIDEO_WITH_SW_AUDIO_CODEC,
SW_AUDIO_CODEC,
HW_AUDIO_CODEC,
SW_VIDEO_CODEC,
HW_VIDEO_CODEC

您需要实现 StreamingStateListener， 以便通过回调函数 onStateChanged 接收如下消息：

• STATE.PREPARING
• STATE.READY
• STATE.CONNECTING
• STATE.STREAMING
• STATE.SHUTDOWN
• STATE.IOERROR
• STATE.NETBLOCKING
• STATE.CAMERA_SWITCHED
• STATE.TORCH_INFO
• STATE.CONNECTION_TIMEOUT
• STATE.SENDING_BUFFER_EMPTY
• STATE.SENDING_BUFFER_FULL
• STATE.DISCONNECTED
• STATE.NO_SUPPORTED_PREVIEW_SIZE

通过 onStateHandled 接收如下消息：

• STATE.SENDING_BUFFER_HAS_FEW_ITEMS
• STATE.SENDING_BUFFER_HAS_MANY_ITEMS

您需要注意的是，onStateChanged 回调函数可能被非 UI 线程调用，可参考 CameraStreamingActivity

5. 开始推流

// should be invoked after getting STATE.READY message and in non-ui thread
mCameraStreamingManager.startStreaming();

6. 停止推流

mCameraStreamingManager.stopStreaming();

7. CameraStreamingManager 另外几个重要的状态周期函数 resume()、pause()、destory()

如果 CameraStreamingManager 存在于某一个 Activity 中，建议在 Activity 的 resume()、pause()、destory() 中分别进行调用 CameraStreamingManager 的周期函数，即：

@Override
protected void onResume() {
  super.onResume();
  mCameraStreamingManager.resume();
}

@Override
protected void onPause() {
  super.onPause();
  mCameraStreamingManager.pause();
  getWindow().clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
}

@Override
protected void onDestroy() {
  super.onDestroy();
  mCameraStreamingManager.destroy();
}

纯音频推流支持后台运行，只需要控制好 pause() 及 destory() 周期函数即可。

8. 自适应码率

下面是 SendingBufferProfile 的相关配置：

public static final float LOW_THRESHOLD_MIN = 0;
public static final float LOW_THRESHOLD_MAX = 1.0f;
public static final float LOW_THRESHOLD_DEFAULT = 0.2f;

public static final float HIGH_THRESHOLD_MIN = 0;
public static final float HIGH_THRESHOLD_MAX = 1.0f;
public static final float HIGH_THRESHOLD_DEFAULT = 0.8f;

public static final float DURATION_LIMIT_MIN = HIGH_THRESHOLD_MAX + 0.1f;
public static final float DURATION_LIMIT_MAX = 5.0f;
public static final float DURATION_LIMIT_DEFAULT = 3.0f;

public static final long LOW_THRESHOLD_TIMEOUT_MIN     = 10 * 1000; // ms
public static final long DEFAULT_LOW_THRESHOLD_TIMEOUT = 60 * 1000; // ms

// [LOW_THRESHOLD_MIN, LOW_THRESHOLD_MAX] && [LOW_THRESHOLD_MIN, high - 0.1)
private float mLowThreshold;

// [HIGH_THRESHOLD_MIN, HIGH_THRESHOLD_MAX] && (low + 0.1, HIGH_THRESHOLD_MAX]
private float mHighThreshold;

// [DURATION_LIMIT_MIN, DURATION_LIMIT_MAX]
private float mDurationLimit;

// [LOW_THRESHOLD_TIMEOUT_MIN, Long.MAX_VALUE)
// To measure the low buffering case
private long mLowThresholdTimeout;

您需要首先构造 SendingBufferProfile ，并传入 LowThreshold(s), HighThreshold(s), DurationLimit(s) 和 LowThresholdTimeout(ms)

• LowThreshold 是 SENDING_BUFFER_HAS_FEW_ITEMS 消息的阀值。在收到 SENDING_BUFFER_HAS_FEW_ITEMS 后，表明 SendingBuffer 中有 LowThreshold 的 buffer，您可以在此回调中添加提升 quality 的相关逻辑。

• HighThreshold 是 SENDING_BUFFER_HAS_MANY_ITEMS 消息的阀值。在收到 SENDING_BUFFER_HAS_MANY_ITEMS 后，表明 SendingBuffer 中有 HighThreshold 的 buffer，您可以在此回调中添加降低 quality 的相关逻辑。

• DurationLimit 是 SENDING_BUFFER_FULL 消息的阀值。在收到 FULL 之后，SDK 将会开始进行丢帧处理。

• SDK 检测到 SendingBuffer 达到 LowThreshold 后，会通过 LowThresholdTimeout 来决定何时回调 SENDING_BUFFER_HAS_FEW_ITEMS。当前 LowThresholdTimeout 最低为 LOW_THRESHOLD_TIMEOUT_MIN，默认为 DEFAULT_LOW_THRESHOLD_TIMEOUT。

下面是 Demo 中的处理逻辑，在接收到 SENDING_BUFFER_HAS_FEW_ITEMS 后，会提升 quality，设定之后，需要调用 notifyProfileChanged ；在接收到 SENDING_BUFFER_HAS_MANY_ITEMS 后，会降低 quality，同理，需要调用 notifyProfileChanged。

在 onStateHandled 中，您可以直接返回 false，表明不执行自适应码率的策略

case CameraStreamingManager.STATE.SENDING_BUFFER_HAS_FEW_ITEMS:
    mProfile.improveVideoQuality(1);
    mCameraStreamingManager.notifyProfileChanged(mProfile);
    return true;
case CameraStreamingManager.STATE.SENDING_BUFFER_HAS_MANY_ITEMS:
    mProfile.reduceVideoQuality(1);
    mCameraStreamingManager.notifyProfileChanged(mProfile);
    return true;

9. 截帧

在调用 captureFrame 的时候，您需要传入 width 和 height，以及 FrameCapturedCallback，如果传入的 width 或者 height 小于等于 0，SDK 返回的 Bitmap 将会是预览的尺寸 。SDK 完成截帧之后，会回调 onFrameCaptured，并将结果以参数的形式返回给调用者。

注意：调用者有义务对 Bitmap 进行回收释放

mCameraStreamingManager.captureFrame(w, h, new FrameCapturedCallback() {
    @Override
    public void onFrameCaptured(Bitmap bmp) {

    }
}

10. Filter 实现

您可以通过如下 Callback 获取数据源或 Texture id，并定制化滤镜效果。

• onPreviewFrame 会回调 NV21 格式的 YUV 数据，您 Filter 之后，会进行后续的编码和封包等操作。
• 该过程是一个同步过程。
• onPreviewFrame 仅在 Streaming 状态下被回调。

public interface StreamingPreviewCallback {
    public boolean onPreviewFrame(byte[] bytes, int width, int height)
}

onDrawFrame 会回调 Texture id，您处理完之后，返回新的 Texture id 进行显示。该过程是一个同步过程。

• 如下四个回调均执行在 GL rendering thread
• 如果 onDrawFrame 直接返回 texId，代表放弃 Filter 处理；否则 onDrawFrame 应该返回一个您处理过的纹理 ID
• 自定义的 Texture id 应该是 GLES20.GL_TEXTURE_2D 类型

public interface SurfaceTextureCallback {
    void onSurfaceCreated();
    void onSurfaceChanged(int width, int height);
    void onSurfaceDestroyed();
    int onDrawFrame(int texId, int width, int height);
}

注意：

• 软编模式下：推流端预览具有滤镜效果需实现 SurfaceTextureCallback；播放端具有滤镜效果需实现 StreamingPreviewCallback。
• 硬编模式下：预览和播放端具有滤镜效果仅需实现 SurfaceTextureCallback。

11. FULL & REAL mode

在获得 AspectFrameLayout 对象之后，您可以调用 setShowMode 方法来选择您需要的显示方式。

• SHOW_MODE.FULL，可以全屏显示（没有黑边），但是预览的图像和播放的效果有出入
• SHOW_MODE.REAL，所见即所得

AspectFrameLayout afl = (AspectFrameLayout) findViewById(R.id.cameraPreview_afl);
afl.setShowMode(AspectFrameLayout.SHOW_MODE.FULL);

12. 自定义 SDK 涉及的 Shared Library Name

如果您将 so 更名如下（前者为更新前的 so，后者为您更新后的 so）：

• libpldroid_streaming_aac_encoder.so -> libpldroid_streaming_aac_encoder_xxx.so
• libpldroid_streaming_core.so -> libpldroid_streaming_core_xxx.so
• libpldroid_streaming_h264_encoder.so -> libpldroid_streaming_h264_encoder_xxx.so

那么您需要在 CameraStreamingManager 构造前调用如下代码：

SharedLibraryNameHelper.getInstance().renameSharedLibrary(
        SharedLibraryNameHelper.PLSharedLibraryType.PL_SO_TYPE_AAC, "pldroid_streaming_aac_encoder_xxx");

SharedLibraryNameHelper.getInstance().renameSharedLibrary(
        SharedLibraryNameHelper.PLSharedLibraryType.PL_SO_TYPE_CORE, "pldroid_streaming_core_xxx");

SharedLibraryNameHelper.getInstance().renameSharedLibrary(
        SharedLibraryNameHelper.PLSharedLibraryType.PL_SO_TYPE_H264, "pldroid_streaming_h264_encoder_xxx");

或带路径的方式

SharedLibraryNameHelper.getInstance().renameSharedLibrary(
        SharedLibraryNameHelper.PLSharedLibraryType.PL_SO_TYPE_AAC, getApplicationInfo().nativeLibraryDir + "/libpldroid_streaming_aac_encoder_xxx.so");

SharedLibraryNameHelper.getInstance().renameSharedLibrary(
        SharedLibraryNameHelper.PLSharedLibraryType.PL_SO_TYPE_CORE, getApplicationInfo().nativeLibraryDir + "/libpldroid_streaming_core_xxx.so");

SharedLibraryNameHelper.getInstance().renameSharedLibrary(
        SharedLibraryNameHelper.PLSharedLibraryType.PL_SO_TYPE_H264, getApplicationInfo().nativeLibraryDir + "/libpldroid_streaming_h264_encoder_xxx.so");

13）软编的 EncoderRCModes

目前支持的类型：

• EncoderRCModes.QUALITY_PRIORITY: 质量优先，实际的码率可能高于设置的码率
• EncoderRCModes.BITRATE_PRIORITY: 码率优先，更精确地码率控制

可通过 StreamingProfile 的 setEncoderRCMode 方法进行设置，如下：

StreamingProfile profile;
profile.setEncoderRCMode(StreamingProfile.EncoderRCModes.QUALITY_PRIORITY);

14）StreamingSessionListener

该 Listener 的原型如下：

public interface StreamingSessionListener {
    boolean onRecordAudioFailedHandled(int code);
    boolean onRestartStreamingHandled(int code);
    Size onPreviewSizeSelected(List<Size> supportedList);
}

您可以实现 StreamingSessionListener，比如：

@Override
public boolean onRecordAudioFailedHandled(int err) {
    mCameraStreamingManager.updateEncodingType(CameraStreamingManager.EncodingType.SW_VIDEO_CODEC);
    mCameraStreamingManager.startStreaming();
    return true;
}

@Override
public boolean onRestartStreamingHandled(int err) {
    return mCameraStreamingManager.startStreaming();
}

@Override
public Camera.Size onPreviewSizeSelected(List<Camera.Size> list) {
    if (list != null) {
        for (Camera.Size s : list) {
            Log.i(TAG, "w:" + s.width + ", h:" + s.height);
        }
//            return "your choice";
    }
    return null;
}

在消费了 onRecordAudioFailedHandled 或 onRestartStreamingHandled 之后，您应该返回 true 通知 SDK；若不做任何处理，返回 false。

• onRecordAudioFailedHandled：在 Audio 数据读取失败后，会回调该方法，如前面的代码，您可以继续继续纯视频推流
• onRestartStreamingHandled：在网络链接失败之后，SDK 会回调 STATE.DISCONNECTED 消息，并在合适的时刻回调 onRestartStreamingHandled 方法，您可以在此方法中安全地实现重连策略。若网络不可达，会回调 STATE.IOERROR。
• onPreviewSizeSelected：可以在此回调中选择您认为合适的 preview size；否则，返回 null 告知 SDK，放弃选择，SDK 将会采取默认的策略进行选择 camera preview size。若在初始化 CameraStreamingSetting 时，
  • 未指定 preview size ratio，onPreviewSizeSelected 方法的行参 list 将会是该系统所有支持的 camera preview size 全集
  • 指定了 preview size ratio，即调用了 setCameraPrvSizeRatio 并传入合法 ratio 后，onPreviewSizeSelected 方法的行参 list 将是该系统所有支持的 camera preview size 并匹配 ratio 的子集。这种情况下，可能返回 null。

15. 动态更改 Orientation

包括动态更改 Encoding Orientation 以及动态切换横竖屏

• 动态更改 Encoding Orientation

本质上更改的是编码后图像的方向，但需要重新推流才会生效；目前支持的 ENCODING_ORIENTATION 的类型有：PORT 和 LAND

用户不设置的情况下， Encoding Orientation 会依赖 Activity 的 Orientation，即有如下对应关系：

// 不调用 setEncodingOrientation 情况下，SDK 会默认根据如下关系进行设置 Encoding Orientation

设置 ENCODING_ORIENTATION.PORT 之后，播放端会观看竖屏的画面； 设置 ENCODING_ORIENTATION.LAND 之后，播放端会观看横屏的画面。

其设置方式如下：

mProfile.setEncodingOrientation(StreamingProfile.ENCODING_ORIENTATION.PORT);
mCameraStreamingManager.setStreamingProfile(mProfile); // notify CameraStreamingManager that StreamingProfile had been changed.

• 动态切换横竖屏 本质上是用户切换 Activity 方向后，相应地调整 Camera 的预览显示效果。 在更改了 Activity Orientation 之后，需要调用 notifyActivityOrientationChanged 通知 CameraStreamingManager。

比如：

setRequestedOrientation(isEncOrientationPort ? ActivityInfo.SCREEN_ORIENTATION_PORTRAIT : ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);
mCameraStreamingManager.notifyActivityOrientationChanged();

需要注意的是，为了防止 setRequestedOrientation 调用后 Activity 的重建，需要在 AndroidManifest.xml 里面配置对应的 Activity 的如下属性：

android:configChanges="orientation|screenSize"

可查看 Demo 中的 .SWCodecCameraStreamingActivity 的配置。

16. 获取 StreamStatus 信息

您可以获取 StreamStatus 信息，其定义如下：

public static class StreamStatus {
  public int audioFps;
  public int videoFps;
  public int totalAVBitrate; // bps
}

如果需要获取该信息，您需要实现 StreamStatusCallback 接口的 notifyStreamStatusChanged(final StreamStatus) 方法：

public class SWCodecCameraStreamingActivity implements StreamStatusCallback {
    // register StreamStatusCallback by setStreamStatusCallback
    // should be called after prepare()
    mCameraStreamingManager.setStreamStatusCallback(this);

    // set the StreamStatusConfig of StreamStatus , only including interval time (the unit is second) at present
    // 3 means notifyStreamStatusChanged will be invoked per 3 seconds
    mStreamingProfileProfile.setStreamStatusConfig(new StreamStatusConfig(3))

    @Override
    public void notifyStreamStatusChanged(final StreamStatus streamStatus) {
        runOnUiThread(new Runnable() {
            @Override
            public void run() {
                mStreamStatus.setText("bitrate:" + streamStatus.totalAVBitrate / 1024 + " kbps"
                        + "\naudio:" + streamStatus.audioFps + " fps"
                        + "\nvideo:" + streamStatus.videoFps + " fps");
            }
        });
    }
}

需要注意的是，notifyStreamStatusChanged 不在 UI 线程中。

17. HappyDns 支持

为了防止 Dns 被劫持，SDK 加入了 HappyDns 支持，可以从这里查阅源码。 从 v1.4.6 版本开始，需要在宿主项目中的 build.gradle 中加入如下语句：

dependencies {
    ...
    compile 'com.qiniu:happy-dns:0.2.5'
    ...
}

通过 StreamingProfile 设定自定义 DnsManager，如下：

  public static DnsManager getMyDnsManager() {
      IResolver r0 = new DnspodFree();
      IResolver r1 = AndroidDnsServer.defaultResolver();
      IResolver r2 = null;
      try {
          r2 = new Resolver(InetAddress.getByName("119.29.29.29"));
      } catch (IOException ex) {
          ex.printStackTrace();
      }
      return new DnsManager(NetworkInfo.normal, new IResolver[]{r0, r1, r2});
  }


  StreamingProfile mProfile = new StreamingProfile();
  // Setting null explicitly, means give up {@link DnsManager} and access by the original host.
  mProfile.setDnsManager(getMyDnsManager()); // set your DnsManager

如果不进行设置，SDK 会默认的设置一个 DnsManager; 若显示地设置 null，SDK 不使用 DNS 解析。

18. 高 FPS 推流

可以通过 CameraStreamingSetting 对象设置 Recording hint，以此来提升数据源的帧率。

CameraStreamingSetting setting = new CameraStreamingSetting();
setting.setRecordingHint(false);

需要注意的是，在部分机型开启 Recording Hint 之后，会出现画面卡帧等风险，所以请慎用该 API。如果需要实现高 fps 推流，可以考虑开启并加入白名单机制。

19. Mute/Unmute

SDK 支持推流过程中静音和取消静音的操作。

// mute
// You should call this after {@link #prepare(CameraStreamingSetting, StreamingProfile)}
mCameraStreamingManager.mute(true);

// unmute
// You should call this after {@link #prepare(CameraStreamingSetting, StreamingProfile)}
mCameraStreamingManager.mute(false);

20. 手动对焦

对焦之前传入 Focus Indicator , 如果不进行设置，对焦过程中将会没有对应的 UI 显示。

// You should call this after getting {@link STATE#READY}.
mCameraStreamingManager.setFocusAreaIndicator(mRotateLayout,
                    mRotateLayout.findViewById(R.id.focus_indicator));

点击屏幕触发手动对焦，并设置对应的坐标值。

// You should call this after getting {@link STATE#READY}.
mCameraStreamingManager.doSingleTapUp((int) e.getX(), (int) e.getY());

21. Zoom 操作

// mCurrentZoom must be in the range of [0, mCameraStreamingManager.getMaxZoom()]
// You should call this after getting {@link STATE#READY}.
if (mCameraStreamingManager.isZoomSupported()) {
  mCameraStreamingManager.setZoomValue(mCurrentZoom);
}

22. 设置 AVProfile

当需要自定义 video 的 fps/video bitrate/GOP size 或者 audio 的 sample rate/audio bitrate，可以通过设置 AVProfile。

// audio sample rate is 44100, audio bitrate is 96 * 1024 bps
StreamingProfile.AudioProfile aProfile = new StreamingProfile.AudioProfile(44100, 96 * 1024);

// fps is 30, video bitrate is 1000 * 1024 bps, maxKeyFrameInterval is 48
StreamingProfile.VideoProfile vProfile = new StreamingProfile.VideoProfile(30, 1000 * 1024, 48);

StreamingProfile.AVProfile avProfile = new StreamingProfile.AVProfile(vProfile, aProfile);

mStreamingProfile.setAVProfile(avProfile)

23. setNativeLoggingEnabled(enabled)

当 enabled 设置为 true ，SDK Native 层的 log 将会被打开；当设置为 false，SDK Native 层的 log 将会被关闭。默认处于打开状态。

mCameraStreamingManager.setNativeLoggingEnabled(false);

建议 Release 版本置为 false。

为了保证正常使用 SDK ，请在 proguard-rules.pro 文件中添加以下代码：

-keep class com.pili.pldroid.streaming.** { *; }

• 1.6.2 (Release Notes)

  • 发布 pldroid-camera-streaming-1.6.2.jar
  • 修复特殊情况下导致的 crash 问题
  • 更新 Demo 代码

• 1.6.1 (Release Notes)

  • 发布 pldroid-camera-streaming-1.6.1.jar
  • 新增 libpldroid_mmprocessing.so
  • 更新 libpldroid_streaming_core.so 和 libpldroid_streaming_h264_encoder.so
  • 增加水印支持
  • 优化软编 codec，提升画质和码控能力
  • 兼容特殊的直播设备
  • 新增 TransformMatrix 到 SurfaceTextureCallback#onDrawFrame
  • 修复 CameraStreamingManager#pause 耗时较长
  • 修复硬编纯音频无法正常停止推流
  • 修复硬编推流过程中特殊步骤导致的概率性 crash
  • 更新 Demo 代码

• 1.6.0 (Release Notes)

  • 发布 pldroid-camera-streaming-1.6.0.jar
  • 更新 libpldroid_streaming_core.so 和 libpldroid_streaming_h264_encoder.so
  • 新增 mirror 支持
  • 新增 StreamingEnv
  • 修复特殊机型硬编闪屏问题
  • 修复禁播导致的 crash 问题
  • 改善部分机型硬编 tearing 现象
  • 兼容异常输入的情况，并提供回调
  • 新增质量上报支持
  • 修复资源泄漏问题
  • 修复特殊机型 crash 问题
  • 重构 Demo 代码

• 1.5.3 (Release Notes)

  • 发布 pldroid-camera-streaming-1.5.3.jar
  • 修复特殊机型概率性 crash 问题
  • 优化 Jar 包体积

• 1.5.1 (Release Notes)

  • 发布 pldroid-camera-streaming-1.5.1.jar
  • 更新 libpldroid_streaming_core.so 和 libpldroid_streaming_h264_encoder.so
  • 新增蓝牙麦克风支持
  • 优化启用／关闭输入法弹框导致的屏闪现象
  • 修复部分机型手动对焦引起的 crash 问题
  • 修复部分机型推流过程中概率性 crash 问题
  • 修复部分机型频繁切换输入法导致黑屏问题
  • 修复特殊机型硬编音画不同步问题
  • 更新 demo 样例代码

• 1.5.0 (Release Notes)

  • 发布 pldroid-camera-streaming-1.5.0.jar
  • 更新 libpldroid_streaming_core.so 和 libpldroid_streaming_h264_encoder.so
  • 支持手动对焦
  • 支持 Zoom
  • 支持 mute/unmute
  • 新增 setSendTimeoutInSecond API
  • 对回调方法 sortCameraPrvSize 的行参 supportedPreviewSizeList 进行从小到大排序
  • 当 DnsManager 设置为 null 后，不进行 Dns 解析，Issue 78
  • 优化数据源采集和显示效率，避免 UI 卡顿
  • 修复硬编模式下，重连导致概率性 crash 问题
  • 方法 onPrepare(), onResume(), onPause(), onDestroy() 分别重命名为 prepare(), resume(), pause(), destroy()
  • 更新 demo 样例代码

• 1.4.6 (Release Notes)

  • 发布 pldroid-camera-streaming-1.4.6.jar
  • 更新 libpldroid_streaming_core.so，libpldroid_streaming_aac_encoder.so 和 libpldroid_streaming_h264_encoder.so
  • 提升软编编码帧率
  • 优化推流过程中前后置摄像头切换体验
  • 新增 happydns 支持，并提供 setDnsManager API，用户可自定义 DnsManager
  • 新增 StreamStatus 回调，实现 StreamStatusCallback 获取音视频帧率和码率
  • 新增 setRecordingHint API，可实现高帧率推流
  • 修复推流过程中，特殊操作后，推流无图像问题
  • 修复推流过程中，HOME 键退出，再次启动 app，无法切换 camera 问题
  • 修复部分机型音画不同步，包括切换前后置
  • 修复推流过程中，概率性 crash 问题
  • 更新 demo 样例代码

• 1.4.5 (Release Notes)

  • 发布 pldroid-camera-streaming-1.4.5.jar
  • 更新 libpldroid_streaming_core.so，libpldroid_streaming_aac_encoder.so 和 libpldroid_streaming_h264_encoder.so
  • 新增动态更改 Encoding Orientation 支持
  • 新增动态切换横竖屏支持
  • 新增 onPreviewSizeSelected 支持
  • 新增 setPreferredVideoEncodingSize 支持
  • 新增 VIDEO_ENCODING_HEIGHT_544 支持
  • 优化网络传输
  • 提升画质
  • 优化前后置切换
  • 标记 VIDEO_ENCODING_SIZE_QVGA 等 Deprecated
  • 标记 onPreviewFrame(byte[] datas, Camera camera) Deprecated
  • 修复部分机型概率性 ANR
  • 更新 demo 样例代码

• 1.4.3 (Release Notes)

  • 发布 pldroid-camera-streaming-1.4.3.jar
  • 更新 libpldroid_streaming_core.so，libpldroid_streaming_aac_encoder.so 和 libpldroid_streaming_h264_encoder.so
  • 新增 SharedLibraryNameHelper 绝对路径加载方式
  • 新增 StreamingSessionListener，可方便安全地实现重连策略及 Audio 数据获取失败时的策略
  • 新增 EncodingType 支持
  • 修复硬编模式下，多次切换前后置摄像头 crash 问题
  • 修复硬编模式下，部分机型截图 crash 问题
  • 修复 metadata 格式问题
  • 修复软编模式下，推流过程中概率性 crash 问题
  • 修复概率性无视频帧问题
  • 更新 demo 展示代码
  • 增加支持的机型信息

• 1.4.1 (Release Notes)

  • 发布 pldroid-camera-streaming-1.4.1.jar
  • 更新 libpldroid_streaming_core.so
  • 新增 libpldroid_streaming_aac_encoder.so 和 libpldroid_streaming_h264_encoder.so
  • 新增 H.264 和 AAC 软编支持
  • 新增软编数据源回调接口，可定制化 Filter (滤镜) 特效处理
  • 修复硬编部分机型 crash 问题
  • 修复硬编切换前后置时长异常问题
  • 更新 demo 样例代码

• 1.3.9 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.9.jar
  • 更新 libpldroid_streaming_core.so
  • 增加 x86 支持
  • 新增 x86/libpldroid_streaming_core.so
  • 优化内存，减少内存抖动，增强稳定性
  • 修复 onResume 之后快速 onPause 导致的 crash 问题
  • 修复部分机型截图 crash 问题
  • 修复部分机型切换前后置摄像头之后，导致切片异常问题
  • 修复网络异常导致的 crash 问题(issue 54)

• 1.3.8 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.8.jar
  • 更新 libpldroid_streaming_core.so
  • 优化切换前后置摄像头数据重发时间，增强推流过程中切换前后置摄像头的稳定性
  • 优化内存使用，避免 OOM
  • 修复部分机型概率性 crash 问题
  • 兼容 supportedPreviewSizeList 为空的机型

• 1.3.7 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.7.jar
  • 更新 libpldroid_streaming_core.so
  • 修复部分机型概率性 crash 问题
  • 修复部分机型前后置 camera 切换的 crash 问题
  • 兼容无前置 camera 的机型

• 1.3.6 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.6.jar
  • 更新 libpldroid_streaming_core.so
  • 优化 video stream 流畅度
  • 修复概率性断流问题
  • 修复部分机型推流过程中，概率性 crash 问题
  • 修复部分机型切换前后置摄像头过程中，概率性 crash 问题

• 1.3.5 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.5.jar
  • 更新 libpldroid_streaming_core.so
  • 修复部分机型音视频不同步问题
  • 分离 preview size 与 encoding size
  • 新增 setEncodingSizeLevel API，并提供 encoding size 参数列表
  • 修复部分机型花屏问题
  • 修复前后置摄像头切换概率性断流问题
  • 修复概率性 crash 问题

• 1.3.4 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.4.jar
  • 更新 libpldroid_streaming_core.so
  • 修复采用 ART 运行时的 Android 机型的 crash 问题
  • 修复封包不兼容的问题

• 1.3.3 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.3.jar
  • 删除 arm64-v8a/libpldroid_ffmpegbridge.so 以及 armeabi-v7a/libpldroid_ffmpegbridge.so
  • 新增 armeabi 支持
  • 新增 arm64-v8a/libpldroid_streaming_core.so, armeabi-v7a/libpldroid_streaming_core.so 和 armeabi/libpldroid_streaming_core.so
  • 体积裁剪数十倍，动态链接库裁剪至 69KB
  • 完全移除 FFmpeg 依赖
  • 修复推流过程中，切换前后置断流问题
  • 修复自适应码率过程中，切换 quality 断流问题
  • 修复前后置切换概率性 crash 问题

• 1.3.2 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.2.jar
  • 修复输入法弹起导致预览画面调整的问题

• 1.3.1 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.1.jar
  • 增加 arm64-v8a 支持，新增 arm64-v8a/libpldroid_ffmpegbridge.so
  • 更新 armeabi-v7a/libpldroid_ffmpegbridge.so
  • 新增切换 Stream 接口：setStreamingProfile
  • 新增 setLocalFileAbsolutePath 接口
  • 修复横屏下，经过特殊操作，Camera 预览显示异常的问题

• 1.3.0 (Release Notes)

  • 发布 pldroid-camera-streaming-1.3.0.jar
  • 新增自适应码率功能
  • 新增截帧接口
  • 新增 Preview Layout REAL/FULL mode，解决显示黑边问题
  • 修复 IOS 和 Android 使用同一个 stream 时，导致 IOS 无法正常推流的问题
  • 修复部分机型切换前后置 crash 问题
  • 新增自适应码率演示代码
  • 新增截帧演示代码
  • 新增 REAL/FULL mode 演示代码

• 1.2.3 (Release Notes)

  • 发布 pldroid-camera-streaming-1.2.3.jar
  • 新增 Audio quality 和 Video quality 配置项，可自由组合音视频码率参数
  • 新增 Video quality 设置接口 setVideoQuality
  • 新增 Audio quality 设置接口 setAudioQuality
  • 优化 jar 包，减少约 30% 体积

• 1.2.2 (Release Notes)

  • 发布 pldroid-camera-streaming-1.2.2.jar
  • 更新 libpldroid_ffmpegbridge.so
  • 修复概率性的 crash 问题
  • 添加 STATE.CONNECTION_TIMEOUT 状态
  • 修复部分机型因连接错误而导致屏幕 Hang 住
  • 在 UI 层对点击事件加入保护逻辑，避免快速点击导致应用 crash

• 1.2.1 (Release Notes)

  • 发布 pldroid-camera-streaming-1.2.1.jar
  • 更新 libpldroid_ffmpegbridge.so
  • 优化内存问题，修复 OOM 异常
  • 优化 Quality 配置
  • 添加 setNativeLoggingEnabled() 接口

• 1.2.0 (Release Notes)

  • 发布 pldroid-camera-streaming-1.2.0.jar
  • 更新 libpldroid_ffmpegbridge.so
  • 更新 Stream 设置接口：setStream(stream)
  • 添加 Camera 切换接口：switchCamera
  • 修复 Android L crash 问题
  • 添加 Camera 切换状态：STATE.CAMERA_SWITCHED
  • 添加 Torch 是否支持状态：STATE.TORCH_INFO
  • 更新状态回调接口：onStateChanged(state, extra)
  • 修复特殊操作的概率性 crash 问题
  • 修复部分机型 turnLightOn 及 turnLightOff 接口无效问题
  • 修复部分机型点击 Home 按键 crash 问题
  • 修复部分机型因 PREVIEW_SIZE_LEVEL 导致 crash 问题
  • 添加 Camera 切换操作演示代码
  • 更新 Torch 组件显示逻辑

• 1.1.0 (Release Notes)

  • 发布 pldroid-camera-streaming-1.1.0.jar
  • 更新 libpldroid_ffmpegbridge.so
  • 优化 ffmpegbridge 模块，降低 libpldroid_ffmpegbridge.so 文件大小
  • 添加纯音频推流支持：添加纯音频推流 CameraStreamingManager(Context ctx) 构造函数
  • 纯音频推流支持后台运行
  • 添加 preview size 设定接口：setCameraPrvSizeLevel 及 setCameraPrvSizeRatio
  • 添加 torch 操作接口： turnLightOn 及 turnLightOff
  • 添加控制连续自动对焦的接口：setContinuousFocusModeEnabled
  • 废弃 setCameraPreviewSize 接口
  • 修复部分机型因 preivew size 不支持而导致的 crash 问题
  • 添加 AudioStreamingActivity 及 StreamingBaseActivity，用来演示纯音频推流
  • 添加 torch 操作演示代码

• 1.0.2 (Release Notes)

  • 发布 pldroid-camera-streaming-1.0.2.jar
  • 修复无 StreamingStateListener 情况下的 Crash 问题
  • 修复正常启动后无 READY 消息返回问题
  • 更新 Stream 定义，并与服务端保持一致
  • 增加相机正常启动后即开始推流功能

• 1.0.1 (Release Notes)

  • 发布 pldroid-camera-streaming-1.0.1.jar
  • 更新 Stream 类结构
  • 更新 Stream 的构造方式

• 1.0.0 (Release Notes)

  • 发布 PLDroidCameraStreaming v1.0.0