场景渲染工具批注集成

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集合。

示例参考