XR_ANDROID_mouse_interaction OpenXR 拡張機能

Name String

XR_ANDROID_mouse_interaction

拡張機能の種類

インスタンスの拡張

登録されている電話番号

705

リビジョン

1

拡張機能とバージョンの依存関係

OpenXR 1.0

最終更新日

2024-09-06

IP ステータス

既知の IP に関する申し立てはありません。

寄与者

Sharayu Shenoy、Google

Chiara Coetzee、Google

Levana Chen、Google

Spencer Quin、Google

概要

この拡張機能は、マウス入力を取得するための XrPath を提供し、マウス デバイスとトラックパッド デバイスの両方を含む、ユーザーのマウス プロファイルによく使用されるアクション ポーズを 1 つ定義します。

この拡張機能には、OpenXR アクション システムを介して入力するマウス デバイス用に特別に設計された新しいインタラクション プロファイルも導入されています。

マウス操作用のアクション ポーズ

次のアクション ポーズ(「照準」)では、トラッキング入力がマウス デバイスまたはトラックパッド デバイスから提供されるかどうかにかかわらず、3D ポインタ レイが有効になります。

アクション サブパス …/input/aim/pose は、拡張機能で有効になっているインタラクション プロファイルを含む、/user/mouse のユーザーパスで有効なすべてのインタラクション プロファイルでサポートされます。

照準ポーズ

…/input/aim/pose は、3D 空間でマウス ポインタを使用してオブジェクトを操作するように設計されています。たとえば、仮想レーザー ポインタを使用して壁の仮想ボタンを狙う操作は、「照準」ポーズに適しています。

これは、標準ポーズ ID で定義されている「照準」ポーズと同じです。トラッキング対象のコントローラ プロファイルはすべて、このポーズをすでにサポートしています。

照準ポーズの例

順位

通常、[照準] ポーズの位置はユーザーの頭です。つまり、マウスの動きが検出されたときの頭の位置と同じです。マウスの照準ポーズは、マウスの移動時に計算されます。最後に確認された照準位置は、次にマウスを動かすまで保持されます。

向き

「照準」ポーズの向きは、3D ポインタ レイをレンダリングして仮想オブジェクト(壁上のメニューボタンのクリックなど)を操作するために使用される場合があります

マウスの照準ポーズは、マウスが動いたときに計算されます。最後に認識された照準の向きは、次にマウスを動かすまで保持されます。

-Z 方向は、照準ジェスチャーの前方方向、つまり照準ビームが向いている方向です。

マウスの相対 X 軸と Y 軸の移動は、ユーザーの頭の周りの球面上のマウスの相対移動を計算するために使用されます。

照準ポーズの例

奥行きの移動は、メインのクリックとスクロールを使用してサポートされます。奥行き方向に移動するアクションが実行されている場合、位置は、正または負のスクロール値に応じて、レイに沿って正または負の Z 方向にヘッド位置からオフセットされます。システムは、ユーザーの頭部周辺の球体内の深度変化を安定化します。

マウス デバイスのインタラクション プロファイル

マウス操作プロファイルは、ボタンとスクロールを備えたマウスデバイスまたはトラックパッド デバイスを使用してマウス入力を提供するランタイム向けに設計されています。これにより、マウスデバイスとトラックパッド デバイスは、よく使用されるクリック、スクロール、アクション ポーズを OpenXR アクション システムに提供できます。

インタラクション プロファイルのパス:

  • /interaction_profiles/android/mouse_interaction

最上位のユーザーパスで有効です。

  • /user/mouse

サポートされているコンポーネントパス:

  • …/input/aim/pose
  • …/input/select/click
  • …/input/secondary/click
  • …/input/tertiary/click
  • …/input/scroll/value

このインタラクション プロファイルは、このセクションで説明するアクション ポーズと、次の 2 つのアクション入力グループをサポートしています。

クリック操作

このインタラクション プロファイルは、…/input/select/click、…/input/secondary/click、/input/tertiary/click のアクションをサポートしています。

…/input/select/click はブール値の入力です。値 XR_TRUE は、マウスまたはトラックパッドのプライマリ ボタンが押されたことを示します。

…/input/secondary/click はブール値入力です。値 XR_TRUE は、マウスまたはトラックパッドの副ボタンが押されたことを示します。

…/input/tertiary/click はブール値の入力です。値 XR_TRUE は、マウスのスクロールまたはサードパーティ ボタンが押されたことを示します。

スクロール アクション

このインタラクション プロファイルは、…/input/scroll/value アクションをサポートしています。

…/input/scroll/value は、-1 ~ 1 の範囲で変化する 2D 入力コンポーネントで、下にスクロールと上にスクロールにマッピングされます。

新しいオブジェクト タイプ

新しいフラグタイプ

新しい列挙型定数

新しい列挙型

新しい構造

新機能

問題

変更履歴

  • リビジョン 1、2024 年 8 月 29 日(Levana Chen)
    • 最初の拡張機能の説明