人像锁定

  • C++

更新时间不可用

enableCameraCenterStage

启用或关闭人像锁定功能。

C++
virtual int enableCameraCenterStage(bool enabled) = 0;

默认情况下,人像锁定功能处于关闭状态。你需要调用此方法来开启该功能。如需关闭该功能,请再次调用该方法并将 enabled 设置为 false。

注: 该方法仅适用于 iOS 和 macOS 平台。 由于该功能对设备性能要求较高,建议在以下设备或性能更高的设备上使用:

  • iPad:

    • 12.9 英寸 iPad Pro(第 5 代)
    • 11 英寸 iPad Pro(第 3 代)
    • iPad(第 9 代)
    • iPad mini(第 6 代)
    • iPad Air(第 5 代)
  • 2020 款 M1 芯片 13 英寸 MacBook Pro + iPhone 11(将 iPhone 用作 MacBook 的外部摄像头)

声网建议在启用该功能前调用 isCameraCenterStageSupported 方法,检查当前设备是否支持人像锁定功能。

适用场景

人像锁定功能适用于在线会议、演出、在线教育等场景。主持人可以使用该功能确保无论是否移动,始终处于画面中央,从而获得更好的展示效果。

调用时机

必须在成功启用摄像头之后调用此方法,即 SDK 触发 onLocalVideoStateChanged 回调并返回本地视频状态为 LOCAL_VIDEO_STREAM_STATE_CAPTURING(1)之后。

参数

参数名描述
enabled

是否启用人像锁定功能:

  • true:启用人像锁定功能。
  • false:关闭人像锁定功能。
表格内容超出当前宽度,可横向滚动查看更多列。

返回值

  • 0:方法调用成功。
  • < 0:方法调用失败。详见错误码了解详情和解决建议。

所属接口类

isCameraCenterStageSupported

检查当前摄像头是否支持人像锁定功能。

C++
virtual bool isCameraCenterStageSupported() = 0;

建议在调用 enableCameraCenterStage 启用人像锁定功能前,先调用该方法确认当前设备是否支持此功能。你必须在摄像头成功启用后调用该方法,即 SDK 触发 onLocalVideoStateChanged 回调并返回本地视频状态为 LOCAL_VIDEO_STREAM_STATE_CAPTURING(1)之后。

注: 该方法仅适用于 iOS 和 macOS 平台。

调用时机

必须在摄像头成功启用后调用,即 SDK 触发 onLocalVideoStateChanged 回调并返回本地视频状态为 LOCAL_VIDEO_STREAM_STATE_CAPTURING(1)之后。

返回值

  • true:当前摄像头支持人像锁定功能。
  • false:当前摄像头不支持人像锁定功能。

所属接口类