人像锁定
enableCameraCenterStage
开启或关闭人像锁定功能。
Dart
Future<void> enableCameraCenterStage(bool enabled);
人像锁定功能默认关闭,你需要调用该方法开启。如果需要关闭该功能,则需重新调用该方法并将 enabled 设置为 false
。
注意
该方法仅适用于 iOS 和 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
:关闭人像锁定。
返回值
方法成功调用时,无返回值;方法调用失败时,会抛出 AgoraRtcException 异常,你需要捕获异常并进行处理。
所属接口类isCameraCenterStageSupported
查询摄像头是否支持人像锁定。
Dart
Future<bool> isCameraCenterStageSupported();
注意
该方法仅适用于 iOS 和 macOS。
在调用 enableCameraCenterStage 开启人像锁定功能前,建议你先调用该方法查询当前设备是否支持人像锁定。
调用时机
该方法必须在摄像头成功开启后调用,即 SDK 触发 onLocalVideoStateChanged 回调,返回本地视频状态为 localVideoStreamStateCapturing (1) 后。
调用限制
无。
返回值
true
: 当前摄像头支持人像锁定。false
: 当前摄像头不支持人像锁定。