ウェブでの入力
Unity ウェブがサポートするさまざまな入力タイプ。
読み終わるまでの所要時間 19 分最終更新 5日前
Unity ウェブは、ゲームパッド、ジョイスティック、タッチスクリーン、キーボード、移動センサーなど、さまざまなデバイスからのさまざまなタイプの入力をサポートしています。
ゲームパッドとジョイスティックサポート
ウェブはゲームパッドで以下の入力をサポートします。
ウェブでは、HTML5 Gamepad API をサポートするブラウザ用のジョイスティックもサポートされています。
一部のブラウザでは、アプリケーションがフォーカスされている間にユーザーがデバイスを操作した後にのみ入力デバイスにアクセスできます。このタイプのセキュリティ対策は、ユーザーがブラウザー フィンガープリントの目的で接続されたデバイスを使用することを防ぎます。したがって、 Input.GetJoystickNames() を呼び出して接続されたデバイスを確認する前に、アプリケーションがゲームパッド/ジョイスティックのボタンを押すようにユーザーに指示していることを確認してください。
コントローラーのマップ
旧 Input System のウェブゲームコントローラーマッピングは、W3 仕様に準拠しています。この仕様では、ボタンマッピングのレイアウトは次のようになります。
Buttons | 説明 |
|---|---|
| buttons[0] | 右側のクラスタの下部ボタン = CROSS (X) |
| buttons[1] | 右側のクラスタの右ボタン = CIRCLE |
| Buttons | 右側のクラスタの左ボタン = 正方形 |
| buttons[3] | 右側のクラスタの一番上のボタン = 三角形 |
タッチサポート
Unityウェブは、タッチ サポートのあるブラウザやデバイスに入力.touchesやその他の関連APIを実装します。デフォルトでは、ユーザーが UI 入力フィールドにテキストを入力するためのソフトキーボードがモバイルデバイスの画面にディスプレイされます。この動作を使用不可にするには、 WebGLInput.mobileKeyboardSupport プロパティを使用します。
キーボード入力とフォーカス処理
デフォルトでは、Unity ウェブ は ウェブ キャンバス にフォーカスがあるか否かにかかわらず、ウェブページが受け取るすべてのキーボード入力を処理します。これにより、ユーザーはウェブキャンバスをクリックせずにキーボードベースのアプリケーションを使用できます。
以下の注意は、後述の特定のキーボード入力に適用されます。
キーボード入力動作 | 説明 |
|---|---|
| HTML 要素 (テキストフィールドなど) | キーボード入力を受け取る HTML 要素 (テキストフィールドなど) をウェブページに導入すると、エラーが発生する可能性があります。Unity は、ページの残りの部分が入力イベントを受け取る前に、それらを消費します。 HTML 要素がキーボード入力を受け取るようにするには、 |
| Esc キー | Safari などの一部のブラウザでは、Esc キーを使用して全画面モードに切り替える機能がブロックされます。これは、Esc キーがウェブ環境で保護されているためです。Google Chrome などの他のブラウザーは、予期しない動作をする場合があります。ブラウザーが全画面モードの場合、ユーザーはEscキーのみを使用して全画面モードを終了できます。ブラウザーの種類によっては、Esc キーをクリックしても、必ずしもブラウザーからアプリケーションにイベントをフォワードできないことがあります。 |
| TextMeshPro (TMP とも呼ばれます) 入力フィールドの |
モバイルセンサーサポート
タッチ サポートのあるブラウザとモバイル デバイスの場合、Unity ウェブは以下のセンサーをサポートします。
- 入力.acceleration 付き加速度センサー
- ジャイロスコープ.userAcceleration によるリニア加速
- ジャイロスコープと ジャイロスコープ.rotationRate
- ジャイロスコープによる重力.重力
- ジャイロスコープの姿勢
- Input System パッケージもこれらのセンサーをサポートします。
ロックト
Unity ウェブ プラットフォームは、HTML5 API を使用するカーソル ロックをサポートしています。カーソル ロックを使用して、マウスカーソルをゲーム ウィンドウの中央にロックします。カーソルがロックされている場合、Unity では非表示と表示され、マウスが移動しても移動しません。これは、通常マウスカーソルを使用してプレイヤーの角度の向きをコントロールできる一人称視点のゲームに特に役立ちます。
Element.requestPointerLockカーソルをアクティブ化するにする
カーソルをロックするには、 プロパティを使用します。例えば、以下のコードは、ユーザーがマウスの左ボタンをクリックしたときにカーソルをロックステートに切り替えます。
Cursor.lockStatevoid Update(){ if (Input.GetMouseButtonDown(0)) { Cursor.lockState = CursorLockMode.Locked; }}
カーソルは、ユーザーのインタラクションによってアクティブにする必要があります。詳細については、「 全画面モードとカーソル ロックのその他の考慮事項 」を参照してください。
カーソルを無効にする
Esc キーを押してカーソルのロックを解除します。
スティッキーロック
stickyCursorLockstickyCursorLockCursor.lockStateしたがって、 を に設定すると、Unity キャンバス HTML 要素がカーソルのロックを解除しても、はステートのままになります。
WebGLInput._stickyCursorLocktrueCursor.lockStateCursorLockMode.LockedWebGLInput._stickyCursorLockfalse-
はブラウザーのカーソルロックステートと同期されたままになります。
Cursor.lockState -
ユーザーが Esc キーを押してキャンバスカーソルのロックをキャンセルすると、が
Cursor.lockStateに変わります。CursorLockMode.None
全画面モード
ゲーム内で全画面モードを使用して、以下を行います。
-
画面全体をゲームに使用します。
-
アドレスバーやタブなどのブラウザー UI (ユーザーインターフェース) 要素を非表示にします。
-
タイトルバーやツールバーなどの Unity Player UI 要素を非表示にします。
Unity ウェブ プラットフォームは、HTML5 API の を使用する全画面モードをサポートします。
Element.requestFullscreenウェブで全画面モードをアクティブ化する
全画面モードを有効にするには、 プロパティを使用します。例えば、以下のコードは、ユーザーが F キーを押すと、ゲームを全画面モードに切り替えます。
Screen.fullScreenvoid Update(){ if (Input.GetKeyDown(KeyCode.F)) { Screen.fullScreen = true; }}
全画面モードはユーザーインタラクションによってアクティブにする必要があります。詳細については、「 全画面モードとカーソル ロックのその他の考慮事項 」を参照してください。
全画面モードを終了する
全画面モードを終了するには、もう一度 Esc キーを押すか、画面上部にマウスポインターを置くと、アドレス バーとタブにアクセスできます。
全画面モードとカーソルに関するその他の考慮事項
セキュリティ上の理由から、ブラウザでは、マウスクリックやキーの押下などのユーザーが開始したイベント後にのみカーソルをロックし、全画面モードを有効にできます。
Unity は個別のイベントとレンダリング ループをサポートしないため、イベント処理は、Unity スクリプトから送信された全画面またはカーソル ロック要求が、それをトリガーしたイベントへの直接反応としてブラウザーに確認されなくなるまで延期されます。
したがって、Unity は、カーソルのロックや全画面のリクエストをトリガーするイベントではなく、ユーザーが開始した次のイベントでリクエストをトリガーします。
カーソル ロックまたは全画面モードを有効にしてより良い結果を得るには、マウス/キー アップ イベントの代わりにマウス/キー ダウン イベントを使用して応答をトリガーします。こうすることで、ユーザーが以前に開始したイベントによって発生していない場合に、対応するマウス/キーアップイベントによってディファードリクエストがトリガーされることを保証できます。