游戏控制器支持
概述¶
Hive SDK 提供的用户界面允许您使用“游戏控制器”而不是常规鼠标来移动鼠标光标和点击按钮。例如，在 Hive SDK 暴露的 webview 区域中，用户可以使用游戏控制器移动鼠标光标并点击 webview 区域内的按钮。
Note
在 Hive SDK 中，'游戏控制器' 支持从 Hive SDK v4 Unity Windows 24.1.0 开始提供。
支持的游戏控制器¶
Hive SDK 支持的游戏控制器类型如下，每个 SDK 可使用的最大控制器数量为 1。
- 微软 Xbox 控制器
- 索尼 PlayStation DualSense, DualShock 控制器
- 任天堂 Switch Pro 控制器
控制器键映射¶
从 Hive SDK v4 Unity Windows 25.0.0 开始，某些 Hive UI 支持 控制器按键映射，当使用游戏控制器时。
Warning
请注意，在支持控制器键映射的用户界面中，键操作方法与现有用户界面的键操作方法不同。
关键操作方法¶
| 输入设备 | 现有的UI按键操作方法 | 支持控制器按键映射的UI按键操作方法 |
| 左模拟摇杆 | 移动鼠标光标 | 移动焦点 |
| 右模拟摇杆 | 鼠标垂直和水平滚动 | 鼠标垂直和水平滚动 |
| A按钮 | 左键单击 | 确认（DualSense、DualShock的X按钮） |
| B按钮 | 不支持 | 取消（DualSense、DualShock的O按钮） |
| 十字键 | 不支持 | 移动焦点 |
支持控制器键映射的用户界面列表¶
这是一个支持控制器键映射功能的Hive UI列表：
| 支持界面 | |
| 1 | 应用更新 |
| 2 | 访问限制 |
| 3 | 服务器维护 |
| 4 | 登录等待 |
| 5 | 身份提供者列表 |
| 6 | 促销 |
| 7 | 谷歌支付账户验证 |
| 8 | 支付确认 |
| 9 | 支付错误 |
| 10 | Steam Deck 登录 |
| 11 | 登录 |
| 12 | 找回密码 |
| 13 | 输入验证码 |
| 14 | 找回邮箱 |
| 15 | 休眠账户通知 |
注意事项¶
在将“游戏控制器”应用于 Hive SDK 时，必须牢记以下几点。
游戏控制器操作范围¶
游戏控制器仅在由Hive SDK实现的用户界面中支持。例如，这包括登录屏幕、新闻和促销横幅，以及游戏通过Hive SDK弹出的其他网页视图用户界面。在Hive SDK未实现的用户界面中，例如外部浏览器窗口，不支持使用游戏控制器移动鼠标光标。游戏中使用游戏控制器移动鼠标光标的功能必须由开发者直接实现。
Steam 集成¶
当在Steam集成期间设置“使用Steam输入”时，Hive SDK提供的游戏控制器功能无法使用。然而，通过Steam提供的布局更改菜单，可以提供类似于Hive SDK提供的游戏控制器功能的环境。有关更多详细信息，请参阅官方Steamworks文档中的Steam输入页面。
以现有方式处理控制器输入¶
如果在应用程序调用 Hive SDK 方法后收到响应之前发生游戏控制器输入（包括 Steam Deck 自身的控制器），应用程序不应自行处理游戏控制器输入。在 Hive SDK 实现的 UI 中发生的游戏控制器输入由 Hive SDK 处理。
Windows 屏幕键盘¶
在使用 Hive SDK 提供的游戏控制器支持功能与 Windows 屏幕键盘时，需要在 Windows 屏幕键盘的“选项”中进行以下设置，以使用游戏控制器功能：
- 检查 扫描并输入
- 检查 使用操纵杆、游戏手柄或其他游戏设备
已知问题¶
如果您反复快速地重新连接游戏控制器，控制器可能会表现异常。例如，在Switch Pro控制器的情况下，如果您在短时间内反复断开和连接，鼠标光标可能会在没有用户操作的情况下向某个方向移动。这是Switch Pro控制器的问题，如果出现此问题，您可以通过按下位于有线连接端口左侧的同步按钮来解决。