跳轉至

游戏控制器支持

概述

從 Hive SDK v4 Unity Windows 24.1.0 開始，用戶可以在由 Hive SDK 實現的 UI 中使用遊戲控制器移動鼠標光標和點擊按鈕。例如，在 Hive SDK 所暴露的網頁視圖區域中，用戶可以使用遊戲控制器移動鼠標光標以點擊網頁視圖區域中的按鈕。

支援範圍

Hive SDK 支援的遊戲控制器如下：

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


Hive SDK 支援的遊戲控制器最大數量為 一個。

主要操作方法

  • 移動滑鼠游標：類比搖桿（左）
  • 滑鼠垂直/水平滾輪滾動：類比搖桿（右）
  • 左鍵點擊：A 按鈕（對於 DualSense，DualPro X 按鈕）
  • 右鍵點擊：不支援

注意事項

在使用 Hive SDK 開發時，使用遊戲控制器功能時應注意以下事項。

遊戲控制器操作範圍

遊戲控制器僅在由 Hive SDK 實現的 UI 中受到支持 only within the UI implemented by the Hive SDK。例如，這包括登錄屏幕、新聞和促銷橫幅，以及遊戲使用 Hive SDK 彈出的其他 webview UIs。它不支持在不是由 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 螢幕鍵盤的「選項」中進行以下設置，以使用遊戲控制器功能：

  1. 勾選「掃描鍵盤」
  2. 只勾選「使用搖桿、遊戲手把或其他遊戲設備」

已知問題

在快速連續嘗試重新連接遊戲控制器時，控制器可能會出現異常行為的情況。例如，使用 Switch Pro 控制器時，如果在短時間內重複斷開和重新連接，滑鼠光標可能會在沒有用戶干預的情況下朝特定方向移動。這是 Switch Pro 控制器的問題，遇到問題時可以通過按下位於有線連接端子左側的同步按鈕來解決。