startVideoDigitalZoomControl 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} 设置参数。
- 调用该方法进行移动前,应先使用本方法或 setVideoDigitalZoomControl:{@link #ByteRTCEngine#setVideoDigitalZoomControl} 进行放大,否则无法移动。
- 当数码变焦操作超出范围时,将置为临界值并停止操作。例如,移动到了图片边界、放大到了 8 倍、缩小到原图大小。
- 你也可以调用 stopVideoDigitalZoomControl{@link #ByteRTCEngine#stopVideoDigitalZoomControl} 手动停止控制。
- 如果你希望实现单次数码变焦操作,调用 setVideoDigitalZoomControl:{@link #ByteRTCEngine#setVideoDigitalZoomControl}。
- 如果你希望实现单次数码变焦操作,调用 setVideoDigitalZoomControl:。
Implementation
FutureOr<int> startVideoDigitalZoomControl(
ByteRTCZoomDirectionType direction) async {
return await nativeCall(
'startVideoDigitalZoomControl:', [direction.$value]);
}