setVideoDigitalZoomControl method
@valid since 3.51
@detail api
@hiddensdk(audiosdk)
@author likai.666
@brief 控制本地摄像头数码变焦,缩放或移动一次。设置对本地预览画面和发布到远端的视频都生效。
@param direction 数码变焦操作类型,参看 ByteRTCZoomDirectionType{@link #ByteRTCZoomDirectionType}。
@return
- 0: 调用成功。
- < 0 : 调用失败。查看 ByteRTCReturnStatus{@link #ByteRTCReturnStatus} 获得更多错误说明。
@note
- 由于默认步长为 0,调用该方法前需通过 setVideoDigitalZoomConfig:size:{@link #ByteRTCEngine#setVideoDigitalZoomConfig:size} 设置参数。
- 调用该方法进行移动前,应先使用本方法或 startVideoDigitalZoomControl:{@link #ByteRTCEngine#startVideoDigitalZoomControl} 进行放大,否则无法移动。
- 当数码变焦操作超出范围时,将置为临界值。例如,移动到了图片边界、放大到了 8 倍、缩小到原图大小。
- 如果你希望实现持续数码变焦操作,调用 startVideoDigitalZoomControl:{@link #ByteRTCEngine#startVideoDigitalZoomControl}。
- 移动端可对摄像头进行光学变焦控制,参看 setCameraZoomRatio:.
Implementation
FutureOr<int> setVideoDigitalZoomControl(
ByteRTCZoomDirectionType direction) async {
return await nativeCall('setVideoDigitalZoomControl:', [direction.$value]);
}