人像锁定
enableCameraCenterStage:
开启或关闭人像锁定功能。
Objective-C
- (int)enableCameraCenterStage:(BOOL)enabled NS_SWIFT_NAME(enableCameraCenterStage(_:));
自从
v4.3.1
人像锁定功能默认关闭，你需要调用该方法开启。如果需要关闭该功能，则需重新调用该方法并将 enabled 设置为 NO。
适用场景
人像锁定功能可广泛应用于在线会议、秀场、在线教育等场景。主播可以开启该功能，确保无论移动与否，自己始终在画面中心，以便取得良好的展示效果。
调用时机
该方法必须在摄像头成功开启后调用，即 SDK 触发 rtcEngine:localVideoStateChangedOfState:reason:sourceType: 回调，返回本地视频状态为 AgoraVideoLocalStateCapturing (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
- 是否开启人像锁定功能：
YES：开启人像锁定。NO：关闭人像锁定。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
isCameraCenterStageSupported
查询摄像头是否支持人像锁定。
Objective-C
- (BOOL)isCameraCenterStageSupported NS_SWIFT_NAME(isCameraCenterStageSupported());
自从
v4.3.1
在调用 enableCameraCenterStage: 开启人像锁定功能前，建议你先调用该方法查询当前设备是否支持人像锁定。
调用时机
该方法必须在摄像头成功开启后调用，即 SDK 触发 rtcEngine:localVideoStateChangedOfState:reason:sourceType: 回调，返回本地视频状态为 AgoraVideoLocalStateCapturing (1) 后。
调用限制
无。
返回值
YES: 当前摄像头支持人像锁定。NO: 当前摄像头不支持人像锁定。