setCameraZoomFactor abstract method

Future<void> setCameraZoomFactor(
  1. double factor
)

设置摄像头放大比例。

部分 iOS 设备的后置摄像头为多个摄像头组成的融合镜头，如双摄（广角和超广角）或三摄（广角、超广角和长焦），对于这种具备超广角能力的融合镜头，你可以调用 setCameraCapturerConfiguration 将 cameraFocalLengthType 设置为 cameraFocalLengthDefault (0)（标准镜头），然后调用该方法将摄像头缩放比例设置为小于 1.0 的数值，从而实现超广角的拍摄效果。 该方法仅适用于 Android 和 iOS。 该方法必须在 enableVideo 后调用，设置结果在摄像头成功开启后生效，即 SDK 触发 onLocalVideoStateChanged 回调返回本地视频状态为 localVideoStreamStateCapturing (1) 后。

  • factor 摄像头放大比例。对不支持超广角的设备，取值范围从 1.0 到最大放大比例；对支持超广角的设备，取值范围从 0.5 到最大放大比例。你可以通过 getCameraMaxZoomFactor 方法获取设备支持的最大放大比例。

Returns 方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。 方法调用失败: 返回值 < 0。

Implementation

Future<void> setCameraZoomFactor(double factor);