开发者必看！图观™统一开发API及API调试器入门 第四讲

课程4：镜头操作

小伙伴们大家好，欢迎大家来到图观统一开发API及API调试器入门课程的第4课。

上节内容，我们为大家详细介绍了如何获取已发布的场景、如何获取和引用图观统一开发API的SDK、服务/场景/状态的关系以及端渲染场景操作等内容。

本节课程，我们主要讲解“镜头操作“，主要包含“获取镜头的视界 、设置镜头的视界、限制镜头视界的操作、接口操作镜头”4部分内容，并会在统一API调试器中进行相关的演示操作。

本节课程安排

第一部分：获取镜头视界

第二部分：设置镜头视界

第三部分：限制镜头视界的操作

第四部分：接口操作镜头

图观™引擎 统一API调试器零基础入门课程4《镜头操作》

（点击视频，观看本节完整版教程）

本节课程详解

一、获取镜头视界

首先，先要给大家讲解的是“获取镜头视界”，调用的是getCameraInfo这个方法。

点击执行，会在返回参数里看到：坐标系的类型、视角的中心点，可以看到场景围绕这中间这棵树的位置来进行旋转，这就是视角中心点，如果拖动场景，那中心点对应场景的位置也会发生变化。

• coordZ是中心点的高度

• distance是镜头距离

• pitch是镜头的俯仰角（如果设置成负数，视野将在水平线以下）

• Heading 是镜头的旋转参数

以上，我们就获取了当前场景的镜头基本参数。

二、设置镜头视界的操作

接下来我们来介绍一下如何设置镜头的视界。

，时长00:40

设置镜头视界我们使用setCamera这个方法，然后传入参数，点击执行，就可以完成视角的设置。

给大家介绍一下设置镜头视界的参数：

属性	类型	说明
coordType	Number	XY 轴坐标模式 坐标类型(0:X 经度 Y 纬度；1:X 米 Y 米，相对世界 00 点) 目前该属性仅支持属性值为 0
coordTypeZ	Number	Z 轴坐标模式 坐标高度类型，单位：米(0:相对 3D 世界 0 海拔；1:相对 3D 世界地表；2:相对 3D 模型表面) 目前该属性