场景渲染工具批注集成
1. 场景渲染工具批注交互流程图
场景渲染工具批注交互流程图如下图所示。

2. 批注相关控制类nd_viewCtrl属性说明
使用场景:业务端可设置初始化参数、方法和场景渲染工具进行交互。
属性 | 类型 | 说明 | 回调参数 |
---|---|---|---|
allTags | Arrary | 用于在初始化时渲染批注数据。请参考4.1 tag参数。 | --- |
getTempPicFile(i, cc) | Function | 用于将图文批注中的图片资源置换成可预览地址。 | i:图片文件流,base64格式。 cc(url):回传给工具,图片文件路径。 |
getTempVideoFile(i, v, cc) | Function | 用于将视频批注中的首帧截图和视频文件流置换成可预览地址。 | i:视频首帧截图文件流,base64格式。 v:视频文件流,FormData格式。 cc(url, vUrl): url:回传图片文件路径。 vUrl:回传视频文件路径。 |
3. 批注相关提供方法说明
使用场景:业务端可主动调用方法和场景渲染工具进行数据交互。
属性 | 类型 | 说明 | 入参 | 返回值 |
---|---|---|---|---|
nd_initAlltag([tag, tag, ...]) | Function | 主动调用场景渲染工具批注。 | 批注数据集合。请参考4.1 tag参数。 | --- |
nd_getSenceAllTag() | Function | 获取场景渲染工具批注集合。 | --- | 批注数据集合。请参考4.2 returnTags参数。 |
nd_clearTagStaus() | Function | 可用于获取临时文件失败时调用,清理内部批注状态。 | --- | --- |
4. 批注相关属性参数说明
4.1 tag参数
tag参数:{ tagId: ‘cms123456’, ... }
类型:对象
属性:
tagId:批注的唯一id,viewer用于区分批注唯一性,业务端也可以用作唯一标识。
state.origiType:批注类型。ImageAnno:图文批注;VideoAnno:视频批注;
imgURL:图片文件路径。
videoURL:视频文件路径。
...:其它批注相关信息,业务端一般只需做存储即可。
示例参考:

4.2 returnTags参数
returnTags参数:{ addTags: [tag, tag, ...], editTags: [tag, tag, ...], delTags: [tagId, tagId, ...] }
类型:对象
属性:
addTags:新增的批注集合。
editTags:编辑的批注集合。
delTags:删除批注id集合。
示例参考:
