统一开发 API

Appearance

镜头控制事件 ​

目录 ​

1. 开始镜头漫游 ​

引入版本：3.1 起支持

功能描述 ​

开始镜头漫游

调用方法 ​

JavaScript
appInstance.uniCall(
  'addEventListener',
  {
    eventName: 'onCameraRoamingStart',
    callback: function (event) {
      console.log(event);
    },
  },
  (result) => {
    console.log(result);
  }
);

返回本章目录

2. 结束镜头漫游 ​

引入版本：3.1 起支持

功能描述 ​

结束镜头漫游

调用方法 ​

JavaScript
appInstance.uniCall(
  'addEventListener',
  {
    eventName: 'onCameraRoamingEnd',
    callback: function (event) {
      console.log(event);
    },
  },
  (result) => {
    console.log(result);
  }
);

返回本章目录

3. 开始镜头路径移动 ​

引入版本：3.1 起支持

功能描述 ​

开始镜头路径移动

调用方法 ​

JavaScript
appInstance.uniCall(
  'addEventListener',
  {
    eventName: 'onCameraToMoveStart',
    callback: function (event) {
      console.log(event);
    },
  },
  (result) => {
    console.log(result);
  }
);

返回本章目录

4. 结束镜头路径移动 ​

引入版本：3.1 起支持

功能描述 ​

结束镜头路径移动

调用方法 ​

JavaScript
appInstance.uniCall(
  'addEventListener',
  {
    eventName: 'onCameraToMoveEnd',
    callback: function (event) {
      console.log(event);
    },
  },
  (result) => {
    console.log(result);
  }
);

返回本章目录

5. 开始设置镜头视界 ​

引入版本：3.1 起支持

功能描述 ​

开始设置镜头视界

调用方法 ​

JavaScript
appInstance.uniCall(
  'addEventListener',
  {
    eventName: 'onSetCameraStart',
    callback: function (event) {
      console.log(event);
    },
  },
  (result) => {
    console.log(result);
  }
);

返回本章目录

6. 结束设置镜头视界 ​

引入版本：3.1 起支持

功能描述 ​

结束设置镜头视界

调用方法 ​

JavaScript
appInstance.uniCall(
  'addEventListener',
  {
    eventName: 'onSetCameraEnd',
    callback: function (event) {
      console.log(event);
    },
  },
  (result) => {
    console.log(result);
  }
);

返回本章目录

7. 同步镜头当前视角 ​

引入版本：3.1 起支持

功能描述 ​

同步镜头当前视角

调用方法 ​

JavaScript
appInstance.uniCall(
  'addEventListener',
  {
    eventName: 'onCameraMove',
    callback: function (event) {
      console.log(event);
    },
  },
  (result) => {
    console.log(result);
  }
);

回调数据 ​

JSON
{
  "coordType": 0,
  "coordTypeZ": 0,
  "centerCoord": [
    113.9470838,
    22.5221844
  ],
  "coordZ": -496.48,
  "distance": 2450.98,
  "pitch": 6.5,
  "heading": 294.83
}

回调数据参数描述 ​

属性类型说明
coordTypeNumberXY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y 米，相对世界 00 点
coordTypeZNumberZ 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米）
centerCoordArray中心点的坐标 lng,lat
coordZNumberZ 轴高度（单位：米）
distanceNumber镜头距中心点距离(单位:米)
pitchNumber镜头俯仰角(1~89)
headingNumber镜头偏航角(0 正北, 0~359)

返回本章目录

8. 镜头状态改变事件 端 ​

引入版本：3.1 起支持

功能描述 ​

改变当前镜头状态

调用方法 ​

JavaScript
appInstance.uniCall(
  'addEventListener',
  {
    eventName: 'onFollowingCameraChanged',
    callback: function (event) {
      console.log(event);
    },
  },
  (result) => {
    console.log(result);
  }
);

回调数据 ​

JSON
{
  "relative": "self",
  "enableRotate": true
}

回调数据参数描述 ​

属性类型说明
relativeString视角的相对位置，"self"，视角相对模型固定，"world"，视角相对世界固定。
enableRotateNumber是否开启了环绕

返回本章目录