触控适配套件命令行工具 (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。

要求

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

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

命令

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

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

选项

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

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

另请参阅

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