跳转至

游戏控制器支持

概述

从 Hive SDK v4 Unity Windows 24.1.0 开始，用户可以在 Hive SDK 实现的 UI 中使用游戏控制器移动鼠标光标和点击按钮。例如，在 Hive SDK 暴露的 webview 区域，用户可以使用游戏控制器移动鼠标光标以点击 webview 区域内的按钮。

支持的范围

Hive SDK 支持的游戏控制器如下：

  • 微软 Xbox 控制器
  • 索尼 PlayStation DualSense, DualShock 控制器
  • 任天堂 Switch Pro 控制器


Hive SDK 支持的最大游戏控制器数量为 一个。

关键操作方法

  • 移动鼠标光标：模拟摇杆（左）
  • 鼠标垂直/水平滚轮滚动：模拟摇杆（右）
  • 左鼠标按钮点击：A按钮（适用于DualSense，DualPro X按钮）
  • 右鼠标按钮点击：不支持

注意事项

在使用 Hive SDK 开发时，使用游戏控制器功能时应注意以下事项。

游戏控制器操作范围

游戏控制器仅在由 Hive SDK 实现的 UI 中受支持 仅在由 Hive SDK 实现的 UI 中受支持。例如，这包括登录屏幕、新闻和促销横幅，以及游戏使用 Hive SDK 弹出的其他 webview UI。它不支持在非 Hive SDK 实现的 UI 中，例如外部浏览器窗口。游戏中使用游戏控制器移动鼠标光标必须由开发者直接实现。

Steam 集成

当在Steam集成期间设置“使用Steam输入”时，Hive SDK提供的游戏控制器功能无法使用。然而，通过Steam提供的布局更改菜单，可以提供类似于Hive SDK提供的游戏控制器功能的环境。有关更多详细信息，请参阅官方Steamworks文档中的Steam输入页面。

以传统方式处理控制器输入

如果在应用程序调用Hive SDK方法后收到响应之前发生游戏控制器输入（包括Steam Deck自己的控制器），应用程序不应自行处理游戏控制器输入。在Hive SDK实现的UI中发生的游戏控制器输入由Hive SDK处理。

Windows 屏幕键盘

在使用 Hive SDK 提供的游戏控制器支持功能与 Windows 屏幕键盘时，需要在 Windows 屏幕键盘的“选项”中进行以下设置，以使用游戏控制器功能：

  1. 检查“扫描键”
  2. 仅检查“使用摇杆、游戏手柄或其他游戏设备”

已知问题

在尝试快速连续重新连接游戏控制器时，控制器可能会出现异常行为。例如，对于 Switch Pro 控制器，如果在短时间内重复断开和重新连接，鼠标光标可能会在没有用户干预的情况下朝特定方向移动。这是 Switch Pro 控制器的问题，可以通过在出现问题时按下位于有线连接端口左侧的同步按钮来解决。