setCameraCapturerConfiguration method
- CameraCapturerConfiguration config
设置摄像头的采集偏好。
一般的视频通话或直播中,默认由 SDK 自动控制摄像头的输出参数。在如下特殊场景中,默认的参数通常无法满足需求, 或可能引起设备性能问题,我们推荐调用该接口设置摄像头的采集偏好:
- 使用裸数据自采集接口时,如果 SDK 输出的分辨率和帧率高于 RtcEngine.setVideoEncoderConfiguration 中指定的参数,在后续处理视频帧的时候,比如美颜功能时, 会需要更高的 CPU 及内存,容易导致性能问题。在这种情况下,我们推荐将摄像头采集偏好设置为 CameraCaptureOutputPreference.Performance, 避免性能问题。
- 如果没有本地预览功能或者对预览质量没有要求,我们推荐将采集偏好设置为 CameraCaptureOutputPreference.Performance,以优化 CPU 和 内存的资源分配。
- 如果用户希望本地预览视频比实际编码发送的视频清晰,可以将采集偏好设置为 CameraCaptureOutputPreference.Preview。
Note
请在启动摄像头之前调用该方法,如 RtcEngine.joinChannel,RtcEngine.enableVideo 或者 RtcEngine.enableLocalVideo。
Parameter config
摄像头采集偏好。详见 CameraCapturerConfiguration。
Implementation
@override
Future<void> setCameraCapturerConfiguration(
CameraCapturerConfiguration config) {
return _invokeMethod(
'setCameraCapturerConfiguration', {'config': config.toJson()});
}