自定义视频采集和渲染

// 首先通知 SDK 现在开始使用外部视频源
rtcEngine.setExternalVideoSource(
    true，      // 是否使用外部视频源
    false,       // 是否使用 Texture作为输出
    true         // true 为使用推送模式，false 为拉取模式，但目前不支持
);

// 在获得视频数据的时候调用 Push 方法将数据传送出去
rtcEngine.pushExternalVideoFrame(new ARVideoFrame(
    // 在构造方法传入帧数据的参数，比如格式，宽高等
    // 具体的请查看 ARVideoFrame 类的说明
));

IVideoFrameConsumer mConsumer;
boolean mHasStarted;

// 先创建一个实现 VideoSource 接口的实例
VideoSource source = new VideoSource() {
    @Override
    public int getBufferType() {
        // 返回当前帧数据的 Buffer 类型，每种数据类型在 SDK 内部会经过不同的处理，所以必须与帧数据的类型保持一致
        // 若切换 VideoSource 的类型，必须重新创建另一个实例
        // 有三种类型：BYTE_BUFFER(1)；BYTE_ARRAY(2)；TEXTURE(3)
        return BufferType.BYTE_ARRAY;
    }

    @Override
    // 初始化视频源。你需要在该方法中传入一个 IVideoFrameConsumer 对象
     public boolean onInitialize(IVideoFrameConsumer consumer) {
        // Consumer 是由 SDK 创建的，在 VideoSource 生命周期中注意保存它的引用
        mConsumer = consumer;
    }

    @Override
    // 启动视频源。你可以在该方法中启动视频帧捕捉。输入 true，表示自定义视频源已成功启动。
     public boolean onStart() {
        mHasStarted = true;
    }

     @Override
    // 停止视频源。你可以在该方法中停止采集视频。
   public void onStop() {
     mHasStarted = false;
    }

    @Override
    // 释放视频源。你可以在该方法中关闭视频源设备。同时 SDK 会销毁 IVideoFrameConsumer 对象。
     public void onDispose() {
        // 释放对 Consumer 的引用
        mConsumer = null;
    }
};

// 将输出流切换到刚创建的 VideoSource 实例
rtcEngine.setVideoSource(source);

// 在得到视频帧数据之后，可以调用 Consumer 类的方法传送数据
// 必须根据帧数据的类型来选择用不同的方法
// 假设从视频源中得到的视频为 Data, 从 Android 相机中获取的帧类型可能是 NV21，假设当前类型为 byte array，即 NV21
if (mHasStarted && mConsumer != null) {
    mConsumer.consumeByteArrayFrame(data, ARVideoFrame.NV21, width, height, rotation, timestamp);
}

// 先创建一个实现 IVideoSink 接口的实例
IVideoSink sink = new IVideoSink() {
    @Override
    // 初始化渲染器。你可以在该方法中对渲染器进行初始化，也可以提前初始化好。将返回值设为 true，表示已完成初始化
    public boolean onInitialize () {
        return true;
    }

    @Override
    // 启动渲染器
    public boolean onStart() {
        return true;
    }

    @Override
    // 停止渲染器
    public void onStop() {

    }

    @Override
    // 释放渲染器
    public void onDispose() {

    }

    @Override
    public long getEGLContextHandle() {
        // 构造你的 Egl context
        // 返回 0 代表渲染器中并没有创建 Egl context
        return 0;
    }

    // 返回当前渲染器需要的数据 Buffer 类型
    // 若切换 VideoSink 的类型，必须重新创建另一个实例
    // 有三种类型：BYTE_BUFFER(1)；BYTE_ARRAY(2)；TEXTURE(3)
    @Override
    public int getBufferType() {
        return BufferType.BYTE_ARRAY;
    }

    // 返回当前渲染器需要的 Pixel 格式
    @Override
    public int getPixelFormat() {
        return PixelFormat.NV21;
    }

   // SDK 调用该方法将获取到的视频帧传给渲染器
   // 根据获取到的视频帧的格式，选择相应的回调
   @Override
   public void consumeByteArrayFrame(byte[] data, int format, int width, int height, int rotation, long timestamp) {

   // 渲染器在此渲染
   }
   public void consumeByteBufferFrame(ByteBuffer buffer, int format, int width, int height, int rotation, long timestamp) {


   // 渲染器在此渲染
   }
   public void consumeTextureFrame(int textureId, int format, int width, int height, int rotation, long timestamp, float[] matrix) {

   // 渲染器在此渲染
   }

}

rtcEngine.setLocalVideoRenderer(sink);