ゲームコントローラーサポート
ゲームコントローラー¶
Hive SDK v4 Unity Windows 24.1.0 から、ユーザーは Hive SDK によって実装された UI 内でゲームコントローラーを使用してマウスカーソルを移動させ、ボタンをクリックすることができます。例えば、Hive SDK によって公開されたウェブビューエリアでは、ユーザーはゲームコントローラーを使ってマウスカーソルを移動させ、ウェブビューエリア内のボタンをクリックすることができます。
サポートされている範囲¶
Hive SDKがサポートするゲームコントローラーは次のとおりです:
- マイクロソフト Xbox コントローラー
- ソニー PlayStation DualSense, DualShock コントローラー
- 任天堂 Switch Pro コントローラー
Hive SDKがサポートするゲームコントローラーの最大数は1です。
主要操作方法¶
- マウスカーソルの移動: アナログジョイスティック (左)
- マウスの縦/横ホイールスクロール: アナログジョイスティック (右)
- 左マウスボタンのクリック: Aボタン (DualSense、DualProのXボタン用)
- 右マウスボタンのクリック: サポートされていません
注意事項¶
Hive SDKを使用して開発する際、ゲームコントローラー機能を使用する際に注意すべき点は次のとおりです。
ゲームコントローラーの操作範囲¶
ゲームコントローラーはHive SDKによって実装されたUI内でのみサポートされています。例えば、これにはログイン画面、ニュース、プロモーションバナー、およびゲームがHive SDKを使用してポップアップする他のWebビューUIが含まれます。Hive SDKによって実装されていないUI、例えば外部ブラウザウィンドウではサポートされていません。ゲーム内でゲームコントローラーを使用してマウスカーソルを移動させることは、開発者が直接実装する必要があります。
スチーム統合¶
「Steam Inputを使用する」がSteam統合中に設定されている場合、Hive SDKによって提供されるゲームコントローラー機能は使用できません。ただし、Steamが提供するレイアウト変更メニューを通じて、Hive SDKが提供するゲームコントローラー機能に似た環境を提供することができます。詳細については、公式SteamworksドキュメントのSteam Inputページを参照してください。
従来の方法でコントローラー入力を処理する¶
アプリがHive SDKメソッドを呼び出した後に応答を受け取る前にゲームコントローラーの入力(Steam Deckのコントローラーを含む)が発生した場合、アプリはゲームコントローラーの入力を独自に処理すべきではありません。Hive SDKによって実装されたUI内で発生するゲームコントローラーの入力は、Hive SDKによって処理されます。
Windows オンスクリーンキーボード¶
Hive SDKによって提供されるゲームコントローラーサポート機能をWindowsのオンスクリーンキーボードで使用する際には、ゲームコントローラー機能を使用するためにWindowsのオンスクリーンキーボードの「オプション」で以下の設定を行う必要があります:
- 「キーをスキャンする」をチェックします
- 「ジョイスティック、ゲームパッド、またはその他のゲームデバイスを使用する」のみをチェックします
知られている問題¶
ゲームコントローラーを連続して迅速に再接続しようとすると、コントローラーが異常に動作する場合があります。例えば、Switch Proコントローラーでは、短期間に切断と再接続を繰り返すと、ユーザーの操作なしにマウスカーソルが特定の方向に動くことがあります。これはSwitch Proコントローラーの問題であり、問題が発生した場合は、有線接続端子の左側にある同期ボタンを押すことで解決できます。