Autodesk Forge图片转3D处理失败 报ERROR未返回具体错误原因

问题描述 #

• 基于recap-walkthrough-photo.to.3d项目实现图片转3D功能，程序执行到最终图片处理环节抛出错误，接口仅返回处理进度100%、状态为ERROR的响应，未返回具体错误原因。

接口返回的错误数据如下：

data: {
  Usage: '0.44537496566772',
  Resource: '/photoscene/jsjshdfjsdhgjfsdjf/progress',
  Photoscene: {
    photosceneid: 'jsjshdfjsdhgjfsdjf',
    progressmsg: 'ERROR',
    progress: '100'
  }
}

排查&解决方法 #

• 优先校验上传素材合规性，这是80%以上该错误的触发原因
  • 图片数量最少3张，建议20-50张覆盖建模物体全角度，相邻两张照片的画面重叠度保持在70%以上，不要出现角度跳变
  • 所有图片分辨率不低于1000px，无严重模糊、拖影、过曝/欠曝问题，不要带水印、黑边、大面积无关背景
  • 拍摄全程保持建模物体静止，不要有行人、晃动物体入镜，不要中途切换相机焦距、曝光参数
  • 不要选高反光（镜面、亮面金属）、全透明（玻璃、亚克力）、无纹理（纯白墙面、纯色石膏体）的物体建模，这类素材空三计算基本都会失败
• 检查接口调用逻辑
  • 确认创建photoscene时传入的输出格式参数是服务端支持的类型，不要传错枚举值
  • 必须等所有图片全部上传成功、文件校验通过后，再触发场景处理接口，不要漏传图片、传损坏的文件，图片文件名不要用中文、特殊字符
  • 确认使用的Forge应用密钥已经开通ReCap Photo服务权限，没有超出当月调用配额
• 获取明确错误信息的方法
  • 进度接口本身不会返回错误明细，当进度接口返回ERROR状态时，直接调用photoscene详情查询接口，响应里会带具体失败原因，比如某张图片识别失败、参数非法等
  • 如果详情接口也没有返回明确错误，直接拿着报错的photosceneid找Autodesk Forge支持团队查后台处理日志，能直接定位根因

内容的提问来源于stack exchange，提问作者pooja singh