游戏控制器支持
＃＃ 大綱
在 SDK 提供的 UI 中，您可以使用「遊戲控制器」而不是常規滑鼠來移動滑鼠遊標並點擊按鈕。例如，在SDK公開的webview區域中，使用者可以使用遊戲控制器移動滑鼠遊標並點擊webview區域內的按鈕。
Note
從以下 SDK 版本開始可使用「遊戲控制器」功能。
-
Hive SDK v4 Unity Windows 24.1.0 或更高版本
- Hive SDK v4 Android 26.7.0 或更高版本
支援的遊戲控制器{ #supported-controller }¶
SDK支援的遊戲手把類型如下，每個SDK可使用的手把數量**最多1**。
-
微軟 Xbox 控制器
-
Sony PlayStation DualSense、DualShock 控制器
-
任天堂 Switch Pro 控制器
控制器按鍵映射{ #controller-keymapping }¶
從下列 Hive SDK 版本開始，某些 UI 在使用遊戲控制器時支援控制器鍵映射。
-
Hive SDK v4 Unity Windows 25.0.0 或更高版本
-
Hive SDK v4 Android 26.7.0 或更高版本
Warning
請注意，在支援控制器按鍵映射的 UI 中，[按鍵操作方法] (#key) 與現有 UI 中的按鍵操作方法不同。
Note
在不單獨支援控制器鍵映射的 UI 中，滑鼠遊標暴露在螢幕上，並且透過行動遊標使用遊戲控制器控制 UI。
按鍵操作方法{ #key }¶
| 輸入設備 | 現有UI按鍵操作方法 | 控制器按鍵映射支援UI按鍵操作方法 |
| 左模擬操縱桿 | 移動滑鼠遊標 | 移動對焦 |
| 右模擬操縱桿 | 滑鼠垂直和水平滾輪滾動 | 滑鼠垂直和水平滾輪滾動 |
| A按鈕 | 點選滑鼠左鍵 | 檢查（用於 Dual Sense 或 Dual Shock 的 X 按鈕） |
| B按钮 | 不支援 | 取消（O 按鈕用於 Dual Sense 或 Dual Shock） |
| 方向鍵 | 不支援 | 移動對焦 |
控制器按鍵映射支援 UI 清單{ #key-mapping-ui-list }¶
以下是支援控制器按鍵映射功能的 UI 清單：
| 支援的 UI | SDK v4 Unity Windows 支援 | SDK v4 Android 支援 | |
| 1 | 應用程式更新 | 支援 | 支援 |
| 2 | 存取限制 | 支援 | 支援 |
| 3 | 伺服器檢查 | 支援 | 支援 |
| 4 | 等待登入 | 支援 | - |
| 5 | IdP 清單 | 支援 | - |
| 6 | 帳號衝突 | - | 支援 |
| 7 | 促銷橫幅 | 支援 | 支援（前橫幅） |
| 8 | 促銷評論彈出視窗 | - | 支援 |
| 9 | 促銷結束彈出視窗 | - | 支援 |
| 10 | 檢查 Google 付款帳戶 | 支援 | - |
| 11 | 付款確認 | 支援 | - |
| 12 | 付款錯誤 | 支援 | - |
| 13 | 還款 | - | 支援 |
| 14 | Steam 甲板登入 | 支援 | - |
| 15 | 登入支援 | - | |
| 16 | 找密碼 | 支援 | - |
| 17 | 輸入驗證碼支援 | - | |
| 18 | 尋找電子郵件 | 支援 | - |
| 19 | 休眠帳戶資訊 | 支援 | - |
| 20 | Analytics 同意畫面 | - | 支援 |
注意事項（平台通用）{ #notes_all_platform }¶
將「遊戲控制器」套用到 SDK 時，必須牢記以下幾點。
遊戲控制器運動範圍¶
遊戲控制器僅在使用SDK 實現的 UI 中支援。例如，SDK 在遊戲中顯示的 Web 視圖 UI，例如登入畫面、新聞和促銷橫幅等。對於非 SDK 實現的 UI，例如外部瀏覽器窗口，不支援它。遊戲中使用遊戲控制器的滑鼠遊標移動必須由開發人員直接實現。
注意（Windows）{ #notes_windows_platform }¶
Steam 集成¶
如果您在连接Steam时设置了“启用Steam输入”，您将无法使用SDK提供的游戏控制器功能。然而，透過改變Steam提供的佈局，可以提供類似SDK提供的遊戲控制器功能的環境。欲了解更多信息，请参阅Steamworks官方文档中的[Steam输入页面]（https://partner.steamgames.com/doc/features/steam_controller）。
以傳統方式處理控制器輸入¶
如果在應用程式呼叫 SDK 方法之後且在收到回應之前發生遊戲控制器輸入（包括 Steam Deck 自己的控制器），則應用程式本身不得處理遊戲控制器輸入。 這是因為 SDK 處理發生在 SDK 實現的 UI 上的遊戲控制器輸入。
Windows 螢幕鍵盤¶
在 Windows 螢幕鍵盤中使用 SDK 提供的遊戲控制器支援功能時，必須在 Windows 螢幕鍵盤「選項」中進行以下設定才能使用遊戲控制器功能。
1.勾選**掃描並輸入**
- 僅檢查**使用操縱桿、遊戲手把或其他遊戲設備**
控制器按鍵映射功能的限制¶
應用了控制器按鍵映射功能的 UI 僅在 Rog Ally > **遊戲手把模式**下正常運作。
注意（Android）{ #notes_android_platform }¶
Android作業系統虛擬鍵盤控制限制¶
透過使用遊戲控制器在 UI 中選擇文字輸入欄位而暴露的 Android 作業系統虛擬鍵盤無法使用遊戲控制器進行操作。啟用虛擬鍵盤後，您必須直接觸摸螢幕才能輸入文字。
遊戲控制器運動範圍¶
Hive SDK 的遊戲控制器功能僅在直接使用 SDK 實作的 UI 區域中支援。
如下所示，透過 Hive SDK 將自身暴露在外部模組和系統區域中的 UI 排除在遊戲控制器控制之外。
-
外部庫整合UI：外部IdP登入畫面、付款（IAP）彈出視窗、內容共享彈出視窗等。
-
外部瀏覽器和網頁視圖：應用程式內瀏覽器和外部系統瀏覽器
已知問題{ #issues }¶
如果您重複快速嘗試重新連接遊戲控制器，控制器可能會表現異常。例如，在Switch Pro控制器的情況下，如果在短時間內重複斷開和連接，則即使使用者不進行操作，滑鼠遊標也可能會向某個方向移動。這是 Switch Pro 控制器問題，如果出現問題，可以按下有線連接終端左側的同步按鈕來解決。