ゲームコントローラーサポート
概要¶
Hive SDKが提供するUIでは、通常のマウスの代わりに「ゲームコントローラー」を使用してマウスカーソルを移動させたり、ボタンをクリックしたりすることができます。たとえば、Hive SDKによって公開されたウェブビューエリアでは、ユーザーはゲームコントローラーを使ってマウスカーソルを移動させ、ウェブビューエリア内のボタンをクリックすることができます。
Note
'ゲームコントローラー' サポートは Hive SDK v4 Unity Windows 24.1.0 から提供されています。
サポートされているゲームコントローラー¶
Hive SDKがサポートするゲームコントローラーの種類は以下の通りで、SDKごとに使用できるコントローラーの最大数は**1**です。
- マイクロソフト Xbox コントローラー
- ソニー プレイステーション DualSense, DualShock コントローラー
- 任天堂 スイッチ プロ コントローラー
コントローラーキーのマッピング¶
Hive SDK v4 Unity Windows 25.0.0から始めると、一部のHive UIは、ゲームコントローラーを使用する際に**コントローラーキーのマッピング**をサポートしています。
Warning
コントローラーキーのマッピングをサポートするUIでは、キー操作方法が既存のUIのキー操作方法とは異なることに注意してください。
主要操作方法¶
| 入力デバイス | 既存のUIキー操作方法 | コントローラーキーのマッピングサポートを持つUIキー操作方法 |
| 左アナログスティック | マウスカーソルを移動 | フォーカスを移動 |
| 右アナログスティック | マウスの垂直および水平ホイールスクロール | マウスの垂直および水平ホイールスクロール |
| Aボタン | 左マウスボタンクリック | 確認（DualSense、DualShockのXボタン） |
| Bボタン | サポートされていません | キャンセル（DualSense、DualShockのOボタン） |
| Dパッド | サポートされていません | フォーカスを移動 |
コントローラーキー マッピングをサポートするUIのリスト¶
コントローラーキーのマッピング機能をサポートするHiveのUIのリストはこちらです:
| サポートUI | |
| 1 | アプリ更新 |
| 2 | アクセス制限 |
| 3 | サーバーメンテナンス |
| 4 | ログイン待機 |
| 5 | IdPリスト |
| 6 | プロモーション |
| 7 | Google支払いアカウント確認 |
| 8 | 支払い確認 |
| 9 | 支払いエラー |
| 10 | Steam Deckログイン |
Warning
コントローラーキーのマッピング機能は**Webview画面**では使用できません。
注意事項¶
'ゲームコントローラー'をHive SDKに適用する際には、以下の点に留意する必要があります。
ゲームコントローラーの操作範囲¶
ゲームコントローラーはHive SDKによって実装されたUI内でのみサポートされています。例えば、これにはログイン画面、ニュース、プロモーションバナー、そしてゲームがHive SDKを使用してポップアップする他のウェブビュー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のオンスクリーンキーボード¶
WindowsのオンスクリーンキーボードでHive SDKが提供するゲームコントローラーサポート機能を使用する際には、ゲームコントローラー機能を使用するためにWindowsのオンスクリーンキーボードの「オプション」で以下の設定を行う必要があります:
- **スキャンして入力**を確認してください
- **ジョイスティック、ゲームパッド、またはその他のゲームデバイスを使用**を確認してください
既知の問題¶
ゲームコントローラーを繰り返し迅速に再接続すると、コントローラーが異常に動作することがあります。例えば、Switch Pro Controllerの場合、短時間に何度も切断して再接続すると、ユーザーの操作なしにマウスカーソルが特定の方向に移動することがあります。これはSwitch Pro Controllerの問題であり、問題が発生した場合は、有線接続端子の左側にある同期ボタンを押すことで解決できます。