管理手机控制器配对
构建适合你游戏的配对界面。管理手机控制器配对可提供配对码和待处理请求，还能接受或拒绝手机连接。
你可以在 交互 > 控件 中找到它。若要打开我们提供的界面，请使用显示手机控制器配对。
开始操作会接受请求并监视配对状态的变化。使用 接受或 拒绝，并提供请求的 peerID；使用 停止关闭配对。这样你就可以自行构建界面。若要打开我们提供的完整界面，请使用显示手机控制器配对。
连接
- **输入连接：**运行你选择的操作。
- **输出连接：**在操作运行后触发。使用 开始时，只要此行为处于启用状态，每当配对信息发生变化，它也会触发。
获取信息只读取一次当前信息。开始则会持续更新你的 UI，例如配对码就绪或请求列表发生变化时。
属性
属性指南。标签和默认值与行为编辑器中的一致。
- 玩家（0 = 下一个可用）。默认值：
0。指定“开始”或“接受”操作所请求的玩家编号。0会选择下一个空闲槽位。正数表示请求指定槽位。 - 操作。默认值：获取信息。选择下方列出的操作。
- 请求 ID。默认值：空。对于“接受”或“拒绝”，请填入所选待处理请求中的
peerID。
已占用的玩家槽位不会被自动替换。控制器连接后，请使用分配控制器更改分配。
操作
- **获取信息：**读取当前配对信息，但不会打开界面或启动会话。
- **开始：**开始接受请求，持续五分钟。在此行为启用期间监视配对状态的变化。
- **停止：**停止接受新请求。已接受的手机仍保持连接。
- **接受：**批准由“请求 ID”指定的待处理请求。使用“玩家”选择一个空闲槽位。
- **拒绝：**拒绝由“请求 ID”指定的待处理请求。
为“开始”“接受”“拒绝”和“停止”按钮分别使用独立行为。当界面需要更新时，请保持开始行为处于启用状态。禁用它会停止更新。若要停止接受请求，请运行停止。
输出
code（文本）：当前的六位配对码。在线配对码准备就绪前，此值可能为空。pairing（布尔值）：游戏是否正在接受新请求。requests（数组）：待处理请求。每个项目包含peerID和name。endpoint（文本）：配对 WebSocket 地址。如果自定义 UI 要生成配对二维码，请将它与配对码一起使用。message（文本）：报告的配对或连接错误。没有错误时为空。expiresAt（数字）：配对过期时间，以 Unix 毫秒时间表示。success（布尔值）：当前是否未报告配对错误。这不代表手机已连接，也不代表所选请求已获批准。
连接事件请使用控制器状态。若要获取已连接设备列表，请使用获取控制器。requests 输出包含等待批准的手机，因此它与已连接设备列表不同。
示例：显示配对码
- 在配对界面中添加一个名为配对码的标签。
- 添加管理手机控制器配对。将操作设为开始，将玩家设为
0。 - 添加设置标签，并将配对码标签选为对象 A。
- 使用输出连接，将“管理手机控制器配对”连接到“设置标签”。
- 将“管理手机控制器配对”的绿色输出图标拖到“设置标签”的文本字段中。选择 code。
白色连接会运行“设置标签”。绿色箭头表示单独的输出拖放操作，用于填充其文本字段。
绘制的操作演示动画。将输出拖入“文本”后，选择 code。
运行游戏。配对码就绪时，标签会更新。code 为空时，你可以显示等待提示。
示例：接受选定的请求
- 运行开始，并使用
requests填充设备列表。 - 在列表的每一行中显示对应请求的
name，并将该行与其peerID关联起来。 - 在每行的“接受”按钮后添加管理手机控制器配对。将操作设为接受。
- 将所选请求的
peerID填入请求 ID。将“玩家”保留为0，或选择一个空闲的玩家槽位。 - 对于“拒绝”按钮，使用另一个管理手机控制器配对行为，将操作设为拒绝，并填入相同的请求 ID。
requests 是一个字典数组。读取所选项目后，再读取它的 peerID 键。将该文本填入“请求 ID”。将整个 requests 数组拖入“请求 ID”并不会选中某部手机。
请求 ID 用于标识等待批准的手机。批准后，从获取控制器或控制器状态读取已连接控制器的 deviceID。使用该设备 ID 调用分配控制器。
自定义二维码
如果你的 UI 有二维码生成器，请将包含以下字段的 JSON 对象编码进去：
{
"version": 1,
"endpoint": "<endpoint output>",
"code": "<code output>"
}
将两个占位符替换为该行为当前的输出。code 就绪后再生成二维码。玩家可以在控制器模式下使用扫描配对码扫描二维码。我们提供的“显示手机控制器配对”界面会自动为你生成二维码。
浏览器游戏需要可用的在线配对服务。这些操作会使用该服务，但不会对其进行配置或部署。
配对后
手机控制器可以与控制器事件、映射控制输入以及控制器选择行为配合使用。手机上会显示游戏中该玩家所用的标准控件。重新绑定控制器时，手机会显示完整的控件布局，以便玩家选择新的输入。