常见开发任务
首次接入请先完成快速入门。下表列出常见需求的接口入口；具体参数、返回值与代码示例可在对应方法页中查阅。
建立场景连接
| 任务 | 接口与说明 |
|---|---|
| 创建云渲染窗口 | DigitalTwinPlayer |
| 取得当前窗口的 API 实例 | getAPI · DigitalTwinAPI 功能入口 |
| 响应窗口大小变化 | resize |
| 结束当前播放器连接 | destroy |
在 onReady 回调后调用场景接口。依赖前一步结果的操作，应按异步调用约定组织执行顺序。
添加标注和弹窗
| 任务 | 接口与说明 |
|---|---|
| 添加图标与文字标注 | Marker.add |
| 更新标注文字或位置 | setText · setCoordinate |
| 配置并显示弹窗 | setPopupURL · showPopupWindow |
| 使用三维标注或分层标注 | Marker3D · MarkerLayer |
弹窗和图片路径的写法参见外部资源。新功能优先使用 Marker；Tag 和 CustomTag 已停止更新。
加载图层与模型
| 任务 | 接口与说明 |
|---|---|
| 加载 GeoJSON 并定位要素 | GeoJSONLayer.add · focusFeature |
| 加载三维瓦片和地图服务 | TileLayer · Cesium3DTileset · ImageryLayer |
| 加载模型并设置位置 | CustomObject.add · setLocation |
| 控制模型移动 | moveTo · startMove |
| 管理图层树 | InfoTree |
先确认工程坐标系，再准备对象坐标和资源路径。参见基础概念、坐标数组格式和坐标转换。
控制相机与交互
| 任务 | 接口与说明 |
|---|---|
| 读取或设置相机位置 | Camera.get · Camera.set |
| 查看指定位置或包围盒 | lookAt · lookAtBBox |
| 环绕查看场景 | flyAround |
| 制作相机导览 | CameraTour |
| 处理点击、悬停等场景事件 | 事件交互 · setMousePickMask |
相机位置有不同的参数形式，使用前可对照相机位置说明。
量算、分析和可视化
| 任务 | 接口与说明 |
|---|---|
| 开始交互量算 | Tools.startMeasurement |
| 使用剖切和分析工具 | Tools |
| 绘制线与面 | Polyline · Polygon · Polygon3D |
| 展示热力数据 | HeatMap · HeatMap3D |
| 设置天气和环境 | Weather · Settings |
颜色参数参见颜色格式；水利、仿真等能力可从功能分类继续查找，并核对单独授权的接口。
多窗口和高频更新
| 任务 | 推荐入口 |
|---|---|
| 同一页面显示多个云渲染窗口 | 多窗口视频流 |
| 按帧执行逻辑 | 逐帧回调 |
| 批量更新标注 | updateBegin · update · updateEnd |
| 接入 Explorer 的 WebUI | Explorer 交互开发 |
多窗口场景应保存各窗口 getAPI() 返回的实例，避免将操作发送到其他窗口。本机示例入口提供相应示例的位置说明。