游戏控制器支持
概述¶
Hive SDK 提供的用户界面允许您使用“游戏控制器”而不是常规鼠标来移动鼠标光标和点击按钮。例如，在 Hive SDK 暴露的网页视图区域中，用户可以使用游戏控制器移动鼠标光标并点击网页视图区域内的按钮。
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 按鈕） |
| D-pad | 不支援 | 移動焦點 |
支援控制器鍵位映射的 UI 列表¶
這裡有一個支持控制器鍵位映射功能的 Hive 用戶界面列表：
| 支援介面 | |
| 1 | 應用程式更新 |
| 2 | 訪問限制 |
| 3 | 伺服器維護 |
| 4 | 登入等待 |
| 5 | IdP 列表 |
| 6 | 促銷 |
| 7 | Google 付款帳戶驗證 |
| 8 | 付款確認 |
| 9 | 付款錯誤 |
| 10 | Steam Deck 登入 |
| 11 | 登入 |
| 12 | 找回密碼 |
| 13 | 輸入驗證碼 |
| 14 | 找回電子郵件 |
| 15 | 休眠帳戶通知 |
注意事項¶
在將「遊戲控制器」應用於 Hive SDK 時，必須記住以下事項。
遊戲控制器操作範圍¶
遊戲控制器僅在由 Hive SDK 實現的 UI 中受到支持。例如，這包括登錄屏幕、新聞和促銷橫幅，以及遊戲使用 Hive SDK 彈出的其他網頁視圖 UI。它不支持在不是由 Hive SDK 實現的 UI 中，例如外部瀏覽器窗口。在遊戲中使用遊戲控制器移動鼠標光標必須由開發者直接實現。
Steam 整合¶
當在Steam整合期間設置“使用Steam輸入”時，Hive SDK提供的遊戲控制器功能將無法使用。然而，通過Steam提供的佈局變更菜單，可以提供類似於Hive SDK所提供的遊戲控制器功能的環境。欲了解更多詳細信息，請參閱官方Steamworks文檔中的Steam輸入頁面。
以現有方式處理控制器輸入¶
如果在应用程序调用Hive SDK方法后收到响应之前发生游戏控制器输入（包括Steam Deck自己的控制器），应用程序不应自行处理游戏控制器输入。在Hive SDK实现的用户界面内发生的游戏控制器输入由Hive SDK处理。
Windows 螢幕鍵盤¶
在使用 Hive SDK 提供的遊戲控制器支援功能與 Windows 螢幕鍵盤時，需要在 Windows 螢幕鍵盤的「選項」中進行以下設置，以使用遊戲控制器功能：
- 检查 扫描并输入
- 检查 使用摇杆、游戏手柄或其他游戏设备
已知問題¶
如果您反复快速地重新连接游戏控制器，控制器可能会表现异常。例如，在Switch Pro控制器的情况下，如果您在短时间内反复断开和连接，鼠标光标可能会在没有用户操作的情况下向某个方向移动。这是Switch Pro控制器的问题，如果出现此问题，您可以通过按下位于有线连接端口左侧的同步按钮来解决。