游戏控制器支持
概述¶
Hive SDK 提供的 UI 允許您使用「遊戲控制器」而不是常規鼠標來移動鼠標光標和點擊按鈕。例如，在 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 | 身份提供者列表 |
| 6 | 促銷 |
| 7 | Google 付款帳戶驗證 |
| 8 | 付款確認 |
| 9 | 付款錯誤 |
| 10 | Steam Deck 登錄 |
Warning
控制器鍵映射功能無法在**Webview螢幕**中使用。
注意事項¶
在將「遊戲控制器」應用於 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控制器的问题，如果出现此问题，您可以通过按下位于有线连接端口左侧的同步按钮来解决。