模型目标CLI | Vuforia库

使用模型目标生成器的命令行界面（CLI）将软件集成到自动化工作流程和工具链中。

模型目标CLI允许在整个过程需要自动化或需要更严格的使用指南和数据保护的情况下生成模型目标，即防止上传任何CAD数据。。

另请参见模型目标Web API用于与模型目标生成器进行替代交互。

前提条件

使用模型目标CLI使用和验证模型目标生成有不同的方法。

将CLI与以下内容一起使用：

OAuth2客户端凭据使用范围“datasetsignature.create”对模型目标数据库进行签名。
用于签署模型目标数据库生成的Vuforia开发人员凭据。具有基本计划的开发人员限于20代Model Target。

注意：使用客户端凭据或Vuforia Developer凭据时，您只需与云通信以进行身份验证、共享分析和数据库签名；没有上传CAD模型。

如果您对CLI版本感兴趣，并且对数据保护有其他问题，请联系Vuforia支持部门vuforia-feedback@ptc.com。在电子邮件中，请包括您的客户帐户详细信息和您的用例描述。

Model Target CLI仅适用于Windows和Linux操作系统，并作为命令行工具分发，该工具位于Vuforia开发人员下载第页。

限制

我们推荐对单位进行编码的文件格式。这些包括：全球金融流量基金, 联邦调查局, dae公司, 光伏不包含单位信息的3D文件格式可能无法在运行时正确显示导向视图。

模型目标CLI不支持生成高级模型目标，也不支持简化功能，因为这需要将CAD数据上载到PTC和Vuforia服务器。

请记住在应用程序中添加Premium计划中的许可证密钥。

模型目标数据库生成

模型目标CLI需要一个JSON文件作为输入，用于描述模型目标的数据集和配置。

有关支持的3D文件格式和准备3D模型的完整列表，请参阅最佳实践文章。对于每个模型目标，一个或多个意见需要进行配置，以定义跟踪将在什么位置初始化。请参阅导向视图有关更多详细信息，请参阅下面的部分。

两者都有模型和意见是数组，支持加载多个模型和引导视图来填充数据集。
cadDataUrl是要使用的三维模型的位置。这可以是绝对路径，也可以是相对于当前工作目录的路径。
优化跟踪对象可以设置为“default”、“low_feature_object”或“ar_controller”。如果该字段为空，它将被指定为“默认”。请参见模型目标的优化跟踪了解详细信息。
自动着色可以设置为“自动”、“从不”或“始终”。如果保留为空，则默认为“从不”。
向上矢量应该在模型空间中定义上方向向量。对于常见格式（包括glTF），它将是Y向上[0.0，1.0，0.0]。
统一刻度是预处理3D模型的比例因子。其参数默认设置为1。当三维模型需要放大或缩小以匹配它所表示的对象的真实大小时，请使用它。

##创建数据集{“name”：“数据集名称”，“模型”：[{“name”：“3D-model”，“cadDataUrl”：“C:/Development/My Models/3D-model.obj”，“optimizeTrackingFor”：“默认”，“automaticColoring”：“自动”，“upVector”：[0.0，1.0，0.0]，“视图”：[{“name”：“viewpoint-name”，“guideViewPosition”（指南视图位置）：{“翻译”：[0,0,5]，“旋转”：[0,0,0,1]}}]}]}