截图信息获取说明

1. 概要说明

对应3D、2D模型轻量化转换后，可以在门户网站进行预览，同时轻量化引擎服务会对对应的转换任务生成该模型轻量化预览的缩略图，并提供给业务端查看和下载。

2. 集成业务场景

2.1 截图生成前置条件

  • 使用InsertTask、BatchInsertTask插入的3D、2D、PDF模型
  • 插入模型任务转换完成
  • 插入模型预览可以正常显示
  • 部署环境存在截图转换服务
  • 截图转换成功

2.2 截图获取方式

  • 通过查询接口获取
    1. 使用任务id（taskID）通过查询接口QueryTask，获取转换任务信息。
    2. 当返回转换任务的status=2，并且imgURL不为空时停止查询。
    3. 获取imgURL信息，使用base64解密获取截图url路径。
    4. 下载url图片。
  • 通过回调获取，参考API-回调处理 returnURL
    1. 插入InsertTask、BatchInsertTask任务时，如果参数设置了returnURL，轻量化引擎服务在截图完成后会回调returnURL，传递截图信息。
    2. returnURL回调接口接收参数，判断参数 returnType=3 。
    3. 获取回调参数 imgURL信息，使用base64解密获取截图url路径。
    4. 下载url图片。