视频设备管理
介绍跟视频设备管理相关的方法和回调。
getCameraMaxZoomFactor
获取摄像头支持最大缩放比例。
ArkTS
public abstract getCameraMaxZoomFactor():number;
详情
注意
- 该方法必须在摄像头成功开启后调用,即 SDK 触发 onLocalVideoStateChanged 回调,返回本地视频状态为 CAPTURING (1) 后。
返回值
设备摄像头支持的最大缩放比例。
isCameraFocusSupported
检测设备是否支持手动对焦功能。
ArkTS
public abstract isCameraFocusSupported(): boolean;
详情
注意
- 该方法必须在摄像头成功开启后调用,即 SDK 触发 onLocalVideoStateChanged 回调,返回本地视频状态为 CAPTURING (1) 后。
返回值
true
: 设备支持手动对焦功能。false
: 设备不支持手动对焦功能。
setCameraCapturerConfiguration
设置摄像头采集配置。
ArkTS
public abstract setCameraCapturerConfiguration(config: CameraCapturerConfiguration): number;
详情
注意
- 该方法必须在开启本地摄像头采集前调用,如 startPreview 和 joinChannelWithOptions 前调用。
参数
- config
- 摄像头采集配置,详见 CameraCapturerConfiguration。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setCameraFocusPositionInPreview
设置手动对焦位置,并触发对焦。
ArkTS
public abstract setCameraFocusPositionInPreview(positionX: number, positionY: number): number;
详情
注意
- 该方法必须在 enableVideo 后调用,设置结果在摄像头成功开启后生效,即 SDK 触发 onLocalVideoStateChanged 回调返回本地视频状态为 CAPTURING (1) 后。
- 成功调用该方法后,本地会触发 回调。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setCameraTorchOn
设置是否打开闪光灯。
ArkTS
public abstract setCameraTorchOn(isOn:boolean):number;
详情
注意
- 该方法必须在 enableVideo 后调用,设置结果在摄像头成功开启后生效,即 SDK 触发 onLocalVideoStateChanged 回调返回本地视频状态为 CAPTURING (1) 后。
参数
- isOn
- 是否打开闪光灯:
true
: 打开闪光灯。false
:(默认)关闭闪光灯。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setCameraZoomFactor
设置摄像头缩放比例。
ArkTS
public abstract setCameraZoomFactor(factor:number):number;
详情
注意
- 该方法必须在 enableVideo 后调用,设置结果在摄像头成功开启后生效,即 SDK 触发 onLocalVideoStateChanged 回调返回本地视频状态为 CAPTURING (1) 后。
返回值
- 方法调用成功: 返回设置的 factor 值。
- 方法调用失败: 返回值 < 0。
switchCamera
切换前置/后置摄像头。
ArkTS
public abstract switchCamera(): number;
详情
你可以调用该方法在 App 运行期间基于可用摄像头的实际情况来动态切换摄像头,而无需重启视频流或重新配置视频源。
注意
- 该方法必须在摄像头成功开启后调用,即 SDK 触发 onLocalVideoStateChanged 回调,返回本地视频状态为 CAPTURING (1) 后。
- 该方法仅会对第一路摄像头采集的视频流进行摄像头切换操作,即调用 startCameraCapture 时设置为 (0) 的视频源。
- 该方法和 均用于切换摄像头,区别在于 通过指定摄像头 ID 切换到特定的摄像头,该方法则切换摄像头的方向(前置或后置)。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。