コンテンツにスキップ

ゲームコントローラーサポート

概要

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のオンスクリーンキーボードの「オプション」で以下の設定を行う必要があります：

  1. 「キーをスキャンする」をチェックします
  2. 「ジョイスティック、ゲームパッド、またはその他のゲームデバイスを使用する」のみをチェックします

知られている問題

ゲームコントローラーを連続して迅速に再接続しようとすると、コントローラーが異常に動作する場合があります。例えば、Switch Proコントローラーでは、短期間に切断と再接続を繰り返すと、ユーザーの操作なしにマウスカーソルが特定の方向に動くことがあります。これはSwitch Proコントローラーの問題であり、問題が発生した場合は、有線接続端子の左側にある同期ボタンを押すことで解決できます。