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