文章目录
此教程相关的详细教案，文档，思维导图和工程文件会放入 Spatial XR 社区。这是一个高质量 XR 社区，博主目前在内担任 XR 开发的讲师。此外，该社区提供教程答疑、及时交流、进阶教程、外包、行业动态等服务。
社区链接：
Spatial XR 高级社区（知识星球）
Spatial XR 高级社区（爱发电）
📕教程说明
这篇教程将会介绍如何用 Meta 的 Interaction SDK，配置 Poke 交互，实现用手指点击 UI 按钮的功能，并且能够推动 UI 按钮，UI 按钮由 3D 物体制作而成（使用 Unity 内置的 UGUI 会额外出一期教程）。
环境配置可参考：https://blog.csdn.net/qq_46044366/article/details/133967343
配置一个基本的玩家物体可以参考前几期教程：https://blog.csdn.net/qq_46044366/article/details/134097455
系列教程专栏：https://blog.csdn.net/qq_46044366/category_12118293.html
配套的视频链接：
上半部分：https://www.bilibili.com/video/BV1D64y1H7bW
下半部分：https://www.bilibili.com/video/BV1Kj411n7WQ
电脑操作系统：Windows 11
使用的 VR 设备：Meta Quest 3（Quest 系列都适用）
使用的 Unity 版本：2021.3.5 LTS (这里推荐使用 2021 及以上的 LTS 版本)
Meta XR SDK 版本：v57
官方文档：https://developer.oculus.com/documentation/unity/unity-gs-overview/
Poke 交互脚本介绍文档：
https://developer.oculus.com/documentation/unity/unity-isdk-poke-interaction/
Poke 交互配置过程文档：https://developer.oculus.com/documentation/unity/unity-isdk-create-poke-interactions/
最终效果：
📕给玩家配置 HandPokeInteractor
在 玩家 物体下 的 OVRInteraction > OVRHands > LeftHand > HandInteractorsLeft 下添加 HandPokeInteractor 预制体（可以从 Project 窗口的搜索栏中搜到）
在 HandInteractorLeft 物体上的 Best Hover Interactor Group 脚本中添加 HandPokeInteractor：
然后展开 HandPokeInteractor 物体，激活 Visuals 子物体下的两个子物体：
先点击 HandPokeLimiter 物体，将左手的 SyntheticHand 拖到 HandPokeLimiterVisual 脚本中的 SyntheticHand 变量上，这个脚本能够在手点击按钮的时候限定住手的姿态，让手部不与按钮发生穿模。
然后点击 HandPokeOvershootGlow 物体，按下图所示完成脚本变量赋值：
这个脚本能够根据按压按钮的程度改变手指的颜色。
右手也是类似的配置步骤。
📕用 3D 物体制作可以被点击的 UI 按钮
UI 按钮可以有两种制作方式，一种是用 3D 物体制作，可以实现按钮的推动；另一种是用 Unity 内置的 UGUI 制作，相当于在一个平板上操作，类似 Quest 系统面板的操作方式。这期教程将会介绍用 3D 物体制作可以被点击的 UI 按钮。
⭐搭建物体层级
按照下图所示的层级，搭建一个按钮物体（层级模仿的是官方案例中的 UI 按钮，可以在 Project 窗口中搜索 HoverButtons 物体）：
其中，ButtonPanel 物体是一个 Quad 物体，这种物体只会渲染正面，不会渲染反面，可以在 Hierarchy 面板中点击鼠标右键 > 选择 3D Object > Quad，创建之后把物体的碰撞体删除掉：
如果想要制作双面渲染的按钮，可以使用 Cube 物体，然后把 z 轴的缩放大小调成很小的值，这样原本的方块看上去就是一个平面。
除了，ButtonPanel 物体，其他物体都是空物体。添加好这些物体之后，可以修改根物体 Button 的 Scale 调整按钮的大小。
⭐给物体添加脚本
在根物体 Button 上添加 Poke Interactable 脚本：
在 Surface 子物体上添加如下图所示的三个脚本：
Surface 物体相当于按钮的底部。因为我们制作的 UI 按钮可以被推动，推动的时候不能无限向下推，而是推到一个位置就不能继续往下推了，这个位置就是 Surface 的位置。而下图中白色边框的方形范围是能够进行 Poke 交互的范围，假如此范围比按钮模型的范围大很多，并且按钮是可被推动的，那么点击按钮的时候手指在按钮的边缘外也是有可能推动按钮的，因为能够响应 Poke 交互，促使按钮被推动的范围取决于白色边框的范围。要想修改白色边框的范围，可以调整按钮父物体 Button 的缩放大小，也可以调整 Suface 物体上的 Bounds Clipper 脚本的 Size 数值，这个稍后会讲解。
然后在 ButtonVisuals 子物体上添加 PokeInteractableVisual 脚本。
⭐为脚本变量赋值
找到根物体 Button 上的 Poke Interactable 脚本，将 Surface 物体拖至 Surface Path 变量中。
点击 Surface 子物体，按下图所示进行脚本变量赋值：
Bounds Clipper 的 Size 决定了按钮可被 Poke 响应的范围。
然后点击 ButtonVisuals 子物体，按下图所示进行赋值：
Poke Interactable Visual 脚本能够控制按钮被推动，直到推至按钮的底部。然后配合玩家 HandPokeInteractor 子物体下的 HandPokeLimiter 中的 HandPokeLimiterVisual 脚本，能够实现推动按钮的时候让手部模型不与按钮穿模。
官方文档原文：
然后修改 ButtonVisuals 物体在 Z 轴上的位置，让按钮的模型位于 Surface 前面的一段距离，这样才能实现推动的效果。注意，需要修改的是挂载了 Poke Interactable Visual 脚本的物体或者其父物体的位置，修改 ButtonPanel 子物体是没有作用的。
现在，可以被推动的按钮就已经配置好了。
📕模仿官方样例按钮的样式
有人可能会好奇，官方样例中的这种半透明的按钮（如上图所示）是怎么做出来的。其实只需要额外添加几个东西。
找到按钮的 ButtonPanel 子物体，将 Mesh Renderer 的 Materials 改成 RoundedBoxUnlit。
然后在 ButtonPanel 物体上添加下图所示的脚本：
脚本变量的赋值如下图所示:
上图中的两个脚本负责控制按钮在 Normal，Hover（手指靠近按钮），Select（手指点击按钮）时的颜色变化。
上图中的这个脚本可以控制按钮的长宽，颜色，边缘形状等数值。大家可以复制官方样例 HoverButtons 中的 Rounded Box Properties 脚本参数，粘贴到自己的按钮上，这样自己的按钮也能够呈现出半透明的颜色，并且边缘也成了曲面。
📕在按钮上添加文字
在 ButtonVisuals 子物体下创建一个 3D Object > Text - TextMeshPro，可以创建字体物体。
修改 TextMeshPro-Text 组件上的参数可以调整字体样式。
📕修改按钮图片
有时候，我们会为按钮准备图片素材。在 Unity 中导入图片文件后，需要把 Texture Type 改为 Sprite (2D and UI)：
删除 ButtonPanel 子物体上的 Mesh Filter 和 Mesh Renderer 组件，添加 Sprite Renderer 组件，然后将图片素材引用到 Sprite 变量上：
如果要修改图片的大小，需要修改 ButtonPanel 的父物体（ButtonVisuals）的 Scale。
