5.添加按钮并重置棋子位置

在上一个教程中，向棋盘的 Pawn 和操控器组件添加了手势交互 Actor，使它们具有交互性。在本部分中，你将继续使用混合现实工具包 UX Tools 插件，使用蓝图中的新函数和 Actor 引用构建象棋应用。本部分结束时，你就可以打包混合现实应用，并将其部署到设备或仿真器中。

目标

第一个任务是创建一个函数蓝图，来将象棋棋子重置到场景中的原始位置。

打开“WhiteKing”，选择“我的蓝图”中“函数”部分旁的“+”图标，将其命名为“重置位置”。
从蓝图网格拖动并释放“重置位置”的执行，以创建“SetActorRelativeTransform”节点。
- 此函数可设置 Actor 相对于其父级的变形（位置、旋转和缩放）。将使用此函数来重置棋盘上国王的位置，即使棋盘已从其原始位置移动也无妨。
在事件图表中右击，选择“进行变形”，然后将其“位置”更改为“X = -26”、“Y = 4”和“Z = 0”。
- 将其“返回值”连接到“SetActorRelativeTransform”中的“新相对变形”引脚。

Reset Location function

编译并保存项目，然后返回到主窗口。

正确设置此函数后，接下来的任务是创建一个按钮，以在按它时触发函数。

单击“添加新项”>“蓝图类”，展开“所有类”部分，然后搜索“UxtPressableButtonActor”。
- 将其命名为“ResetButton”，然后双击以打开蓝图

Subclass the new Blueprint from the HoloLens 2 style button

确保在“组件”面板中选择了“ResetButton(自身)”。在“详细信息”面板中，导航到“按钮”部分。将默认“按钮标签”更改为“重置”，展开“按钮图标画笔”部分，然后按“打开图标画笔编辑器”按钮。

Set the label and icon on the button

图标画笔编辑器随即打开，你可以使用该编辑器为按钮选择新图标。

Select an icon for the button

为配置按钮，还有很多其他的设置可以进行调整。若要了解有关 UXT 可按按钮组件的详细信息，请参阅文档。

单击“组件”面板中的“ButtonComponent (继承)”，将“详细信息”面板向下滚动到“事件”部分。
- 单击“按钮按下时”旁的绿色 + 按钮，向事件图表添加事件，按下按钮时将调用该事件。

此时，需要调用“WhiteKing”的“重置位置”函数，这需要在关卡中引用“WhiteKing”Actor。

在“我的蓝图”面板中，导航到“变量”部分，然后单击 + 按钮，将变量命名为“WhiteKing”。
- 在“详细信息”面板中，选择“变量类型”旁的下拉列表，搜索“WhiteKing”，然后选择“对象引用”。
- 选中“实例可编辑”旁的框，这使得可从主关卡设置变量。

Create a variable

剩下的就是，在按下按钮时，正式触发重置函数。

拖动“WhiteKing”输出引脚并释放以放置新节点。选择“Reset Location”函数。最后，将传出执行引脚从“按钮按下时”拖放到“重置位置”上的传入执行引脚。编译和保存 ResetButton 蓝图，然后返回到主窗口。

Call Reset Location function from On Button Pressed

将“ResetButton”拖到视口中，并将其位置设置为“X = 50”、“Y = -25”和“Z = 10”。将其旋转设置为“Z = 180”。在“默认值”下，将 WhiteKing 变量的值设置为“WhiteKing”。

Set the variable

运行应用，将象棋棋子移动到新位置，然后按 HoloLens 2 样式按钮来查看重置逻辑正在运行！

现在，你有了一个混合现实应用，其中包含可交互的棋子和棋盘，以及一个功能齐全的按钮，该按钮可重置棋子的位置。可以在 GitHub 存储库中找到目前完成的该应用程序。请随意阅读本教程以外的内容并设置其余的棋子，以便按下“重置”按钮时重置整个棋盘。

End scene in viewport

你可以继续学习本教程的最后一部分，你将了解如何将应用打包并部署到设备或仿真器。

重要