ドキュメント

Unity Engine

Unity Engine

ウェブでの入力

Unity ウェブがサポートするさまざまな入力タイプ。
読み終わるまでの所要時間 19 分最終更新 5日前

Unity ウェブは、ゲームパッド、ジョイスティック、タッチスクリーン、キーボード、移動センサーなど、さまざまなデバイスからのさまざまなタイプの入力をサポートしています。

ゲームパッドとジョイスティックサポート

ウェブはゲームパッドで以下の入力をサポートします。
ウェブでは、HTML5 Gamepad API をサポートするブラウザ用のジョイスティックもサポートされています。
一部のブラウザでは、アプリケーションがフォーカスされている間にユーザーがデバイスを操作した後にのみ入力デバイスにアクセスできます。このタイプのセキュリティ対策は、ユーザーがブラウザー フィンガープリントの目的で接続されたデバイスを使用することを防ぎます。したがって、 Input.GetJoystickNames() を呼び出して接続されたデバイスを確認する前に、アプリケーションがゲームパッド/ジョイスティックのボタンを押すようにユーザーに指示していることを確認してください。

コントローラーのマップ

旧 Input System のウェブゲームコントローラーマッピングは、W3 仕様に準拠しています。この仕様では、ボタンマッピングのレイアウトは次のようになります。

Buttons

説明

buttons[0]右側のクラスタの下部ボタン = CROSS (X)
buttons[1]右側のクラスタの右ボタン = CIRCLE
Buttons右側のクラスタの左ボタン = 正方形
buttons[3]右側のクラスタの一番上のボタン = 三角形
注
ウェブは W3 仕様に準拠しているため、他のプラットフォームと一貫性がない可能性があります。また、Windows とウェブなど、複数のプラットフォームを同時にターゲットにする場合は、異なるアプローチが必要です。詳細については、再マッピング に関する W3 ドキュメントを参照してください。

タッチサポート

Unityウェブは、タッチ サポートのあるブラウザやデバイスに入力.touchesやその他の関連APIを実装します。デフォルトでは、ユーザーが UI 入力フィールドにテキストを入力するためのソフトキーボードがモバイルデバイスの画面にディスプレイされます。この動作を使用不可にするには、 WebGLInput.mobileKeyboardSupport プロパティを使用します。

キーボード入力とフォーカス処理

デフォルトでは、Unity ウェブ は ウェブ キャンバス にフォーカスがあるか否かにかかわらず、ウェブページが受け取るすべてのキーボード入力を処理します。これにより、ユーザーはウェブキャンバスをクリックせずにキーボードベースのアプリケーションを使用できます。
以下の注意は、後述の特定のキーボード入力に適用されます。

キーボード入力動作

説明

HTML 要素 (テキストフィールドなど)キーボード入力を受け取る HTML 要素 (テキストフィールドなど) をウェブページに導入すると、エラーが発生する可能性があります。Unity は、ページの残りの部分が入力イベントを受け取る前に、それらを消費します。
HTML 要素がキーボード入力を受け取るようにするには、
WebGLInput.captureAllKeyboardInput
を
false
に設定します。こうすることで、アプリケーションは ウェブ キャンバス にフォーカスがある場合にのみ入力を受け取ります。
Esc キーSafari などの一部のブラウザでは、Esc キーを使用して全画面モードに切り替える機能がブロックされます。これは、Esc キーがウェブ環境で保護されているためです。Google Chrome などの他のブラウザーは、予期しない動作をする場合があります。ブラウザーが全画面モードの場合、ユーザーはEscキーのみを使用して全画面モードを終了できます。ブラウザーの種類によっては、Esc キーをクリックしても、必ずしもブラウザーからアプリケーションにイベントをフォワードできないことがあります。
HideMobileInput
TextMeshPro (TMP とも呼ばれます) 入力フィールドの
HideMobileInput
オプションは、ウェブプラットフォームではエフェクトがありません。ブラウザで仮想キーボードをトリガーするにはテキスト入力フィールドが必要なため、このオプションにはエフェクトはありません。ウェブ プラットプラットフォームはテキスト入力フィールドをインスタンス化し、Unity Playerがテキストエントリーを予期したときに仮想キーボードをトリガーします。テキスト入力フィールドは、他のプラットフォームと同様に仮想キーボードの上に表示されます。仮想キーボードはモバイルテキスト入力フィールドに依存しているため、ウェブ プラットプラットフォームで非表示にすることはできません。

モバイルセンサーサポート

タッチ サポートのあるブラウザとモバイル デバイスの場合、Unity ウェブは以下のセンサーをサポートします。
重要
ブラウザでは、センサー入力が安全なコンテキストでのみ許可されます。つまり、そのページを HTTPS 経由で配信する必要があります。唯一の例外は
http://localhost
で、開発時に使用できます。

ロックト

Unity ウェブ プラットフォームは、HTML5 API
Element.requestPointerLock
を使用するカーソル ロックをサポートしています。カーソル ロックを使用して、マウスカーソルをゲーム ウィンドウの中央にロックします。カーソルがロックされている場合、Unity では非表示と表示され、マウスが移動しても移動しません。これは、通常マウスカーソルを使用してプレイヤーの角度の向きをコントロールできる一人称視点のゲームに特に役立ちます。
注
カーソル ロックのブラウザー サポートはさまざまであるため、要素: requestPointerLock() メソッド に関する Mozilla ドキュメントを参照してください。

カーソルをアクティブ化するにする

カーソルをロックするには、
Cursor.lockState
プロパティを使用します。例えば、以下のコードは、ユーザーがマウスの左ボタンをクリックしたときにカーソルをロックステートに切り替えます。
void Update(){ if (Input.GetMouseButtonDown(0)) { Cursor.lockState = CursorLockMode.Locked; }}
カーソルは、ユーザーのインタラクションによってアクティブにする必要があります。詳細については、「 全画面モードとカーソル ロックのその他の考慮事項 」を参照してください。

カーソルを無効にする

Esc キーを押してカーソルのロックを解除します。

スティッキーロック

stickyCursorLock
プロパティは、一人称視点でのゲームでよく使用されます。これは、ブラウザーの動作に関係なくカーソルロックモードを維持するのに役立つためです。
stickyCursorLock
を使用すると、ブラウザーが Unity キャンバスからカーソルのロックを解除した場合でも (通常は Esc キーを使用して)、
Cursor.lockState
のステートが永続化されます。この場合、次にキャンバスにフォーカスがあるときにカーソルが再びロックされます。
したがって、
WebGLInput._stickyCursorLock
を
true
に設定すると、Unity キャンバス HTML 要素がカーソルのロックを解除しても、
Cursor.lockState
は
CursorLockMode.Locked
ステートのままになります。
WebGLInput._stickyCursorLock
を
false
に設定すると、以下が発生します。
  • Cursor.lockState
    はブラウザーのカーソルロックステートと同期されたままになります。
  • ユーザーが Esc キーを押してキャンバスカーソルのロックをキャンセルすると、
    Cursor.lockState
    が
    CursorLockMode.None
    に変わります。
注
ウェブでは、
stickyCursorLock
はデフォルトで
true
に設定されています。

全画面モード

ゲーム内で全画面モードを使用して、以下を行います。
  • 画面全体をゲームに使用します。
  • アドレスバーやタブなどのブラウザー UI (ユーザーインターフェース) 要素を非表示にします。
  • タイトルバーやツールバーなどの Unity Player UI 要素を非表示にします。
Unity ウェブ プラットフォームは、HTML5 API の
Element.requestFullscreen
を使用する全画面モードをサポートします。
注
全画面モードのブラウザーサポートはさまざまであるため、要素: requestFullscreen() メソッド に関する Mozilla ドキュメントを参照してください。

ウェブで全画面モードをアクティブ化する

全画面モードを有効にするには、
Screen.fullScreen
プロパティを使用します。例えば、以下のコードは、ユーザーが F キーを押すと、ゲームを全画面モードに切り替えます。
void Update(){ if (Input.GetKeyDown(KeyCode.F)) { Screen.fullScreen = true; }}
注
Screen.fullScreen
プロパティはデフォルトで
false
に設定されています。
全画面モードはユーザーインタラクションによってアクティブにする必要があります。詳細については、「 全画面モードとカーソル ロックのその他の考慮事項 」を参照してください。

全画面モードを終了する

全画面モードを終了するには、もう一度 Esc キーを押すか、画面上部にマウスポインターを置くと、アドレス バーとタブにアクセスできます。

全画面モードとカーソルに関するその他の考慮事項

セキュリティ上の理由から、ブラウザでは、マウスクリックやキーの押下などのユーザーが開始したイベント後にのみカーソルをロックし、全画面モードを有効にできます。
Unity は個別のイベントとレンダリング ループをサポートしないため、イベント処理は、Unity スクリプトから送信された全画面またはカーソル ロック要求が、それをトリガーしたイベントへの直接反応としてブラウザーに確認されなくなるまで延期されます。
したがって、Unity は、カーソルのロックや全画面のリクエストをトリガーするイベントではなく、ユーザーが開始した次のイベントでリクエストをトリガーします。
カーソル ロックまたは全画面モードを有効にしてより良い結果を得るには、マウス/キー アップ イベントの代わりにマウス/キー ダウン イベントを使用して応答をトリガーします。こうすることで、ユーザーが以前に開始したイベントによって発生していない場合に、対応するマウス/キーアップイベントによってディファードリクエストがトリガーされることを保証できます。
Unity の UI.ボタンコンポーネントを使用して、
OnPointerDown
メソッドをオーバーライドする
Button
のサブクラスを作成することで、目的の動作を実現することもできます。
注
ブラウザによっては、全画面モードに入る前やカーソルをロックする前に、ユーザーに通知メッセージをディスプレイまたは権限付与のプロンプトを表示する場合があります。

追加リソース