本文概述了如何使用 TAK 编辑器预览触摸适应布局,以及可用于自定义预览的各种选项。
先决条件
预览版式
预览布局非常简单,只需通过 VS Code Explorer 在编辑器中打开布局文件即可。 只需单击捆绑包目录中 layouts
的布局文件,布局的 JSON 内容就会显示在一个选项卡中,并且布局的实时预览将自动显示在其旁边的选项卡中。
重要
如果布局文件中存在 错误 ,它们将显示在 VS Code 问题面板中。 在解决错误之前,预览版不会更新。 在 “状态”、“错误”和“警告 ”部分对此进行了更详细的探讨。
预览是交互式的,这意味着,如果使用支持触摸的设备) ,可以使用鼠标 (或触摸输入与触摸控件进行交互。 预览将响应你的输入,就像在实际游戏流上呈现一样。
保存文件时,对布局 JSON 文件所做的更改将反映在预览中。 这允许快速迭代设计过程,你可以在其中更改布局并立即看到结果。
如果预览选项卡已关闭,可以通过以下两种方式之一重新打开它:
单击布局文件右上角的“打开预览”按钮:
通过命令面板执行“触摸适配套件:打开侧边预览”命令。
请注意,仅当 (1) 布局文件处于打开状态, (2) 预览尚未打开时,命令和按钮才可用。
状态、错误和警告
验证状态
在对捆绑包中的布局、资产和其他文件进行修改时,扩展将针对所有捆绑包必须遵循的预定义规则集持续验证捆绑包的内容的有效性。 此作在后台完成,并在以任何其他方式保存或更改嵌套在捆绑包中的文件时重新评估, (重命名为) 。
此验证的状态通过窗口右下边缘的状态栏项报告。
仅当编辑器中至少打开一个布局文件时,才会显示此状态栏项。 它显示活动捆绑包的名称,以及捆绑包中) (错误和警告的问题数。 单击状态栏项将打开 VS Code 问题面板 ,其中包含捆绑包中发现的所有问题的列表。
同步状态
预览面板具有与 TAK CLI 的活动捆绑旁加载连接。 可以在 TAK CLI 文档中详细了解其工作原理。
此连接的状态通过位于窗口右下边缘、验证状态栏项旁边的状态栏项报告。 仅当预览面板打开时,才会显示此状态。
上面的屏幕截图显示了连接处于活动状态且预览同步时的状态栏项。 如果捆绑包中没有错误, (允许警告,并且保持状态为“已同步”) ,则会出现这种情况。 如果存在错误,则状态将更改为“不同步”。
将鼠标悬停在此状态栏项上时,将在 TAK CLI 托管的旁加载服务器上显示一个工具提示,其中包含详细信息。 此地址可用于将另一个游戏流式处理客户端连接到预览版,例如 内容测试应用。
错误和警告
VS Code 问题面板将显示捆绑包中发现的所有问题的列表。 这包括在验证过程中发现的所有问题。
当问题存在时,单击验证或同步状态栏项将打开“问题面板”并显示问题列表。 每个问题都有一个说明,并在捆绑包中找到了问题的位置。
例如,在以下屏幕截图中,捆绑包中存在一个错误,其中布局文件 platformer-advanced.json
正在引用,并且捆绑包中不存在的资产 (run.png
) :
预览版的状态现在为“不同步”,直到引用更改为捆绑包中存在的资产,或者将资产添加到捆绑包。