概述

前端引擎SDK简介

三维重建 SDK 主要提供了平台生成的三维模型的：模型播放能力、与模型进行互动的能力、全景单图播放与互动能力、全景视频播放能力、以及标签标注能力。整个 SDK 分为 ：

• Meshviewer 提供了基本模型加载，全景视频加载、模型交互（如场景漫游，飞入标签，多视图切换，事件监听等能力）
• TransitionAPI 提供了模型在不同视图下的视角切换能力以及在全景模式下的场景切换能力
• CameraAPI 提供了场景中全局相机的交互能力
• ElementsAPI 提供了热点标签的添加、编辑、修改、删除能力
• HotSpotAPI 提供了场景地面标识的交互能力
• ProgressAPI 提供了视图初始化加载进度的感知能力

该 SDK 与框架无关，您可在 React 框架中使用，也可嵌入到 Angular\Vue 等任何框架中使用。本文档将以嵌入 React 的方式演示如何利用该 SDK 加载三维模型以及如何与三维模型进行交互

• 模型：用户将全景照片上传到三维重建（TDSR）平台，利用平台的模型重建能力创造出来的模型；用户可以通过 3D 交互的方式查看该模型的结构。也可以飞入到模型中以全景视角产看场景。

• 场景：场景跟模型是一一对应的

• 子场景：与平台子场景含义相同，一张全景图即一个子场景，用户可以在不同子场景进行漫游。

• 鸟瞰模式：即三维模式。传说中的“上帝视角“，在该模式下，用户可以较清晰看到模型结构，以及各个子场景之间的关联关系

• 漫游模式：即全景模式。子场景模型，可通过鼠标点击/SDK 提供的 API 的操作实现场景间切换从而实现场景漫游

• 标签：SDK 允许在编辑模式下进行图像的标注，标注后会一标签的形势存在，目前支持标注模式有图片，文本，音频、视频、链接、嵌入视频。

• 全景图片：与平台全景图片含义相同。不通过模型重建，直接加载单张全景图片，仅有全景模式且不支持三维模式和子场景间跳转。

• 全景视频：与平台全景视频含义相同。直接加载单个全景视频文件，仅有全景模式且不支持三维模式和子场景间跳转。