摄像头变焦

---

1 功能简介

ZEGO 提供摄像头变焦功能，通过 SDK 设置摄像头的变焦倍数，可实现拍摄时放大远方物体的效果。

2 示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “/ZegoExpressExample/Examples/Others/Zoom” 目录下的文件。

3 前提条件

在实现变焦功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目管理。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始。

4 使用步骤

4.1 获取摄像头最大变焦倍数

调用 getCameraMaxZoomFactor 接口获取摄像头的最大变焦倍数，接口仅在成功启动摄像头后生效。推荐在收到 onPublisherCapturedVideoFirstFrame 回调后调用。

- (void)onPublisherCapturedVideoFirstFrame:(ZegoPublishChannel)channel {
    self.maxZoomFactor = [[ZegoExpressEngine sharedEngine] getCameraMaxZoomFactor];
}

4.2 设置摄像头变焦倍数

调用 setCameraZoomFactor 接口设置摄像头的变焦倍数，最小值为 “1.0”，最大值可参考 3.1 获取摄像头最大变焦倍数 获得。

[[ZegoExpressEngine sharedEngine] setCameraZoomFactor:self.maxZoomFactor];

5 API 参考列表