人像锁定
enableCameraCenterStage
开启或关闭人像锁定功能。
TypeScript
abstract enableCameraCenterStage(enabled: boolean): number;
人像锁定功能默认关闭,你需要调用该方法开启。如果需要关闭该功能,则需重新调用该方法并将 enabled 设置为 false
。
注意
该方法仅适用于 macOS。
适用场景
人像锁定功能可广泛应用于在线会议、秀场、在线教育等场景。主播可以开启该功能,确保无论移动与否,自己始终在画面中心,以便取得良好的展示效果。
调用时机
该方法必须在摄像头成功开启后调用,即 SDK 触发 onLocalVideoStateChanged 回调,返回本地视频状态为 LocalVideoStreamStateCapturing (1) 后。
调用限制
由于该功能对设备性能要求较高,你需要在以下类型或更高性能的设备上使用该功能:
- iPad:
- 12.9 英寸 iPad Pro(第五代)
- 11 英寸 iPad Pro(第三代)
- iPad(第九代)
- iPad mini(第六代)
- iPad Air(第五代)
- 2020 年 M1 MacBook Pro 13 英寸 + iPhone 11(将 iPhone 作为 MacBook 的外接摄像头使用)
声网建议你在开启该功能前,先调用 isCameraCenterStageSupported 查询当前设备是否支持人像锁定。
参数
- enabled
- 是否开启人像锁定功能:
true
:开启人像锁定。false
:关闭人像锁定。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
isCameraCenterStageSupported
查询摄像头是否支持人像锁定。
TypeScript
abstract isCameraCenterStageSupported(): boolean;
注意
该方法仅适用于 macOS。
在调用 enableCameraCenterStage 开启人像锁定功能前,建议你先调用该方法查询当前设备是否支持人像锁定。
调用时机
该方法必须在摄像头成功开启后调用,即 SDK 触发 onLocalVideoStateChanged 回调,返回本地视频状态为 LocalVideoStreamStateCapturing (1) 后。
调用限制
无。
返回值
true
: 当前摄像头支持人像锁定。false
: 当前摄像头不支持人像锁定。