XR_ANDROID_unbounded_reference_space OpenXR 拡張機能

Name String

XR_ANDROID_unbounded_reference_space

拡張機能の種類

インスタンスの拡張

登録されている電話番号

468

リビジョン

1

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

OpenXR 1.0

最終更新日

2024-09-12

IP ステータス

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

寄与者

Spencer Quin、Google

Jared Finder、Google

Fengtao Fan、Google

Lachlan Ford、Google

Nihav Jain、Google

Levana Chen、Google

概要

この拡張機能により、アプリは UNBOUNDED_ANDROID 参照スペースを作成できます。この基準空間により、視聴者は複雑な環境（多くの場合、開始地点から数メートル離れた場所）を自由に移動できます。このとき、視聴者の近くの座標系の安定性を常に最適化します。デバイスが環境をより多く検出してシーン認識を改善するにつれて、デバイスの追跡を維持するために必要に応じて参照空間の原点が大きく調整され、ずれる可能性があります。

UNBOUNDED_ANDROID リファレンス スペースを作成するには、アプリケーションが XrReferenceSpaceCreateInfo::referenceSpaceType XR_REFERENCE_SPACE_TYPE_UNBOUNDED_ANDROID を設定して xrCreateReferenceSpace に渡すことができます。

XrInstance instance; // previously initialized
XrSession session; // previously initialized
XrPosef pose; // previously initialized

// Use the new reference space type in the create info struct
XrReferenceSpaceCreateInfo createInfo = {
    .type = XR_REFERENCE_SPACE_CREATE_INFO;
    .next = nullptr;
    .referenceSpaceType = XR_REFERENCE_SPACE_TYPE_UNBOUNDED_ANDROID;
    .poseInReferenceSpace = pose;
}
XrSpace referenceSpace;
CHK_XR(xrCreateReferenceSpace(session, &createInfo, &referenceSpace));

// After usage
CHK_XR(xrDestroySpace(referenceSpace));

UNBOUNDED_ANDROID 参照空間は、デバイス トラッキングが開始されたときに、ヘッドセットの位置の世界ロックされた原点を設定します。ピッチとロールを除外するように重力方向に調整されており、+X は右、+Y は上、-Z は前方です。

UNBOUNDED_ANDROID 空間は、建物の 1 つのフロア全体や複数のフロアなど、単一の STAGE の境界を超える世界規模のコンテンツをアプリケーションでレンダリングする必要がある場合に便利です。

UNBOUNDED_ANDROID 空間は、時間の経過とともに原点を調整することで、ビューアの近くで安定性を維持します。デバイス トラッキングの維持に必要に応じて、微調整や大幅な調整を行うことができます。

  • ランタイムは、軽微な調整に応答して XrEventDataReferenceSpaceChangePending イベントをキューに追加しないでください。
  • ランタイムは、大きな調整に応答して XrEventDataReferenceSpaceChangePending イベントをキューに追加する必要があります。たとえば、トラッキングが失われたために UNBOUNDED_ANDROID 空間のポーズがリセットされ、世界地図の切断された推定値（「新しい地図」）でトラッキングが再確立されます。
  • このシステムは、世界に関する認識を常に更新し、デバイスの追跡を調整しています。トラッキングのリセットに関係なく、アプリに永続的な位置情報が必要な場合は、この場合にアンカーを使用できます。

参照スペースの変更イベント

世界変更イベントまたは最適化再ローカライズ イベントで返された XrEventDataReferenceSpaceChangePending 構造で定義されたパラメータの場合:

typedef struct XrEventDataReferenceSpaceChangePending {
    XrStructureType         type;
    const void*             next;
    XrSession               session;
    XrReferenceSpaceType    referenceSpaceType;
    XrTime                  changeTime;
    XrBool32                poseValid;
    XrPosef                 poseInPreviousSpace;
} XrEventDataReferenceSpaceChangePending;

メンバーの説明

  • referenceSpaceType が XR_REFERENCE_SPACE_TYPE_UNBOUNDED_ANDROID である。
  • changeTime は、再ローカライズが完了した XrTime を表します。
  • poseValid は、接続が切断された場合は false、再接続された場合は true になります。
  • poseValid が false の場合、poseInPreviousSpace は無効になります。

ビュー、コントローラ、または他のスペースで UNBOUNDED_ANDROID スペースに関連するトラッキングが失われた場合、アプリケーションは推定値または最後に認識された position 値と orientation 値を引き続き受信できます。これらの推定ポーズは、首のモデルの更新、慣性測位、最後に確認された位置に基づくことができます。アプリは、XR_SPACE_LOCATION_POSITION_VALID_BIT と XR_VIEW_STATE_POSITION_VALID_BIT が引き続き設定されていると想定できますが、位置が推定されたか、この方法で最後に認識されたことを示すために、XR_SPACE_LOCATION_POSITION_TRACKED_BIT と XR_VIEW_STATE_POSITION_TRACKED_BIT がランタイムによって消去される場合があります。

トラッキングが復元されると、ランタイムは任意でオリジンを再調整することがあります。たとえば、オリジンを視聴者と一致するように移動することがあります。アプリケーションは、XrEventDataReferenceSpaceChangePending イベントから返された poseValid 値をチェックして、使用できるかどうかを判断できます。

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

新しいフラグタイプ

新しい列挙型定数

XrReferenceSpaceType 列挙型が拡張され、次のように変更されました。

  • XR_REFERENCE_SPACE_TYPE_UNBOUNDED_ANDROID

新しい列挙型

新しい構造

新機能

問題

変更履歴

  • リビジョン 1、2024 年 9 月 12 日（Levana Chen）
    • 最初の拡張機能の説明

OpenXR™ と OpenXR のロゴは、Khronos Group Inc. が所有する商標であり、中国、欧州連合、日本、英国で商標として登録されています。