Vuforia离线模型目标生成器静默失败问题排查求助

可能的错误原因 #

• 路径与权限问题
  • 确认-i指定的JSON文件路径真实存在，路径中避免空格、中文或特殊字符，优先使用绝对路径
  • 检查-o的输出文件夹是否存在，且当前用户有写入权限——权限不足时程序常静默终止无提示
• 账号验证失效
  • 核对-vu和-vp的账号密码是否正确，确保账号拥有Vuforia Model Target的生成权限（需绑定有效订阅）
  • 若账号开启两步验证，必须使用应用专用密码而非普通登录密码
• 第三方转换工具兼容性差
  • Automapki AutoConverter或FileStar的转换结果可能缺失OMTG所需的关键几何信息，或格式不符合官方规范，这类工具的输出无法被OMTG正确解析

OMTG要求的标准JSON格式 #

OMTG仅识别包含结构化几何数据的特定JSON格式，核心结构示例如下：

{
  "version": "1.0",
  "name": "SampleModel",
  "units": "millimeters",
  "meshes": [
    {
      "name": "MainMesh",
      "vertices": [0.0, 0.0, 0.0, 10.0, 0.0, 0.0, 0.0, 10.0, 0.0],
      "triangles": [0, 1, 2]
    }
  ]
}

• 必填字段说明：
  • version：固定值"1.0"，标识格式版本
  • units：必须是millimeters/centimeters/meters/inches/feet之一，需与原始CAD模型单位一致
  • meshes：数组类型，每个元素需包含网格的顶点坐标数组(vertices)和三角面索引数组(triangles，每三个整数为一组表示一个三角面)
  • name：模型及网格名称仅支持英文、数字和下划线

额外验证步骤 #

• 优先使用Vuforia官方推荐的流程：通过Unity的Model Target Creator插件导出合规JSON，再用OMTG执行命令，验证是否能生成文件
• 查看程序运行目录下的隐藏日志文件，部分场景下OMTG会在该目录生成日志，记录具体失败原因

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