ゲームコントローラーサポート
概要¶
Hive SDK が提供する UI は、通常のマウスの代わりに「ゲームコントローラー」を使用してマウスカーソルを移動させたりボタンをクリックしたりすることを可能にします。例えば、Hive SDK によって公開されたウェブビューエリアでは、ユーザーはゲームコントローラーを使ってマウスカーソルを移動させ、ウェブビューエリア内のボタンをクリックすることができます。
Note
'ゲームコントローラー'のサポートは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のキー操作方法とは異なることに注意してください。
主要操作方法¶
| 入力デバイス | 既存の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ログイン |
| 11 | ログイン |
| 12 | パスワードを探す |
| 13 | 確認コードを入力 |
| 14 | メールを探す |
| 15 | 休眠アカウント通知 |
注意事項¶
'ゲームコントローラー'を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 オンスクリーンキーボード¶
WindowsのオンスクリーンキーボードでHive SDKによって提供されるゲームコントローラーサポート機能を使用する際には、ゲームコントローラー機能を使用するためにWindowsのオンスクリーンキーボードの「オプション」で以下の設定を行う必要があります：
- スキャンして入力を確認する\n2. ジョイスティック、ゲームパッド、またはその他のゲームデバイスを使用を確認する
知られている問題¶
ゲームコントローラーを繰り返し迅速に再接続すると、コントローラーが異常に動作することがあります。例えば、Switch Pro Controllerの場合、短時間に何度も切断して再接続すると、ユーザーの操作なしにマウスカーソルが特定の方向に動くことがあります。これはSwitch Pro Controllerの問題であり、問題が発生した場合は、有線接続端子の左側にある同期ボタンを押すことで解決できます。