自采集自渲染

setExternalVideoCapture

virtual int setExternalVideoCapture(bool enable, HRTCVideoFrameFormat format)

【功能说明】

设置是否开启外部视频采集。

【请求参数】

• enable：true表示开启视频自采集，false表示取消视频自采集。默认值为false。
• format：设置外部采集的视频格式，默认为I420（即yuv420P）。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

• 加入房间前调用，不支持房间内切换。
• 视频支持格式：I420，texture2d。
• 开启视频自采集后不支持视频预览。

pushExternalVideoFrame

virtual int pushExternalVideoFrame(HRTCVideoFrame* videoFrame)

【功能说明】

推送外部视频数据。

【请求参数】

videoFrame：视频自采集数据格式。具体请参见HRTCVideoFrame。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

• 此方法调用前，需要先调用setExternalVideoCapture设置开启外部视频采集。
• 数据输入周期：同视频周期，1/帧率。

setExternalVideoFrameOutput

virtual int setExternalVideoFrameOutput(bool localEnable, bool remoteEnable, HRTCImageBufferFormat format = HRTCImageBufferFormat())

【功能说明】

设置是否开启视频流自渲染。开启后，回调onRenderExternalVideoFrame中会有视频帧数据上报。

【请求参数】

• localEnable：开启本地视频自渲染，默认sdk渲染。
• remoteEnable：开启远端视频自渲染，默认sdk渲染。
• format：默认imageFormat为HRTC_VIDEO_IMAGE_FORMAT_YUV420P，bufferType为HRTC_VIDEO_IMAGE_BUFFER_BYTE_ARRAY。具体请参见HRTCImageBufferFormat。

自渲染模式下，仍需要调用startRemoteStreamView，接收到远端视频数据。

setAuxiliaryExternalVideoFrameOutput

virtual int setAuxiliaryExternalVideoFrameOutput(bool localEnable, bool remoteEnable)

【功能说明】

设置是否开启辅流自渲染。开启后，回调onRenderAuxiliaryExternalVideoFrame中会有辅流数据上报。

【请求参数】

• localEnable：开启本地辅流自渲染，默认sdk渲染。
• remoteEnable：开启远端辅流自渲染，默认sdk渲染。

辅流暂不支持本地渲染，该方法只对远端辅流生效。

setExternalAudioCapture

virtual int setExternalAudioCapture(int enabled, int sampleRate, int channels)

【功能说明】

设置是否开启外部音频采集。

【请求参数】

• enable：true表示开启音频自采集，false表示取消音频自采集。
• sampleRate：音频采样率，支持16k/48k。
• channels：音频声道数，支持单声道。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

pushExternalAudioFrame

virtual int pushExternalAudioFrame(void* audioData, int size)

【功能说明】

推送外部音频数据。

【请求参数】

• audioData：音频数据。
• size：音频输入数据大小。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

• 此方法调用前，需要先调用setExternalAudioCapture设置开启外部音频采集。
• 数据输入周期：10ms。
• 音频输入数据大小：10 * sampleRate * channels * 16 / 8 / 1000。

setExternalAudioFrameOutput

virtual int setExternalAudioFrameOutput(bool localEnable, bool remoteEnable)

【功能说明】

设置是否开启音频自渲染。开启后，回调onPlaybackExternalAudioFrame中会有音频帧数据上报。

【请求参数】

• localEnable：开启本地音频自渲染，默认sdk渲染。
• remoteEnable：开启远端音频自渲染，默认sdk渲染