触控适配套件命令行工具 (tak.exe)

本文使用 TAK) 触摸适配套件 (创建和验证触摸控件布局。

takxconfig.json 和 .takx 文件

tak.exe 命令行工具作的主要文件类型是解压缩的捆绑配置文件 (takxconfig.json) 或打包捆绑包 (.takx) 文件。 根据运行的命令,其中一种文件类型始终可用,表示整个触控捆绑包。 为了向后兼容并使某些内部循环方案更容易,旧参数(如) --layout-path 仍受支持,并将替代 中 takxconfig.json的内容。

属性

$schema - 字符串。 触控捆绑包配置文件的 JSON 架构。 这应类似于 https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json,具体取决于所选的架构版本。

version - 字符串。 (四个部分,例如,1.0.0.0) 捆绑包的版本号。

versionName - 字符串可选。 捆绑包版本的描述性名称。

layouts - 对象。 定义捆绑包的布局选项的对象。 其中的 path 属性指定布局所在的相对路径。

assets - 对象可选。 定义捆绑包的资产选项的对象。 其中的 path 属性指定资产所在的相对路径。

context - 对象可选。 定义捆绑包的上下文选项的对象。 其中的 path 属性指定上下文文件所在的相对路径。

languages - 对象可选。 定义捆绑包的语言选项的对象。 此 items 中的 属性是一个数组,指定捆绑包支持的语言。

示例

{
  "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json",
  "layouts": {
    "path": "./layouts"
  },
  "assets": {
    "path": "./assets"
  },
  "context": {
    "path": "./context.json"
  },
  "languages": [
    "en",
    "en-US"
  ],
  "version": "2.0.0.0"
}

有关使用 文件的完整示例,takxconfig.json请参阅 GitHub

要求

文件的版本由 $schema .json 文件中的 属性指定。 这将指定可用的特定属性集,并在某些编辑器中启用 IntelliSense。

上述属性对最新支持的架构版本有效。 有关较旧的架构属性,请参阅 GitHub

命令

使用下表中显示的命令,确保在使用 Xbox 游戏流式处理玩游戏时触摸控件按预期工作。

命令 说明
创建 创建触摸适配捆绑包的源内容或向现有布局添加布局。
convert 将旧式布局集文件转换为符合服务支持的最新格式标准的布局文件。
许可证 显示或接受触摸适配套件命令行工具的最终用户许可协议 (EULA)。
notice 显示有关此软件中包含的第三方材料的信息。
打包 从一组源内容构建一个触控适配捆绑包。
服务 提供触控适配捆绑包,以便客户端应用程序可以下载并使用它。
settings 查看并设置应用程序设置。
takx-version 确定触控适配捆绑包的版本和包含的布局的最大架构版本。
解压 将现有的触控适配捆绑包解包为它的组件文件。
验证 验证触控适配包的内容是否有效。
version 显示触摸适配套件命令行工具的相关版本信息。

选项

使用下表中的信息对所有命令应用适当的标志。

选项 说明
-v, --verbosity 设置命令的输出详细级别。 这些标志的有效值为 CriticalDebugErrorInformationNoneTraceWarning。 默认详细程度为 Information
--version 显示版本信息。
--accept-license 在运行命令之前接受应用程序的许可协议。 对自动化很有用。
--reset-appId 重置与计算机关联的应用程序 ID。
-?, -h, --help 显示帮助和使用情况信息。

另请参阅

开始使用触控
Web 内容测试应用程序 (CTA)