WebXR メッシュ検出モジュール

const session = await navigator.xr.requestSession("immersive-ar", {
  requiredFeatures: ["mesh-detection"]
});

[Exposed=Window] interface XRMesh {
    [SameObject] readonly attribute XRSpace meshSpace;

    readonly attribute Float32Array vertices;
    readonly attribute Uint32Array indices;
    readonly attribute DOMHighResTimeStamp lastChangedTime;
    readonly attribute DOMString? semanticLabel;
};

[Exposed=Window] interface XRMeshSet {
  readonly setlike<XRMesh>;
};

partial interface XRFrame {
  readonly attribute XRMeshSet detectedMeshes;
};

frame のメッシュを 更新するため、ユーザーエージェントは次の手順を実行しなければならない。

1. session を frame のセッションとする。

2. device を session の XR デバイスとする。

3. trackedMeshs を、device のネイティブメッシュ検出機能を呼び出し、frame の時刻における追跡対象メッシュを取得した結果とする。

4. trackedMeshs 内の各 native mesh について、次を実行する。

   1. 必要に応じて、native mesh が trackedMeshs に存在しないものとして扱い、次の項目へ進む。この方法で項目を無視すべきかどうかを判断するために使用できる基準については、§ 6 プライバシーおよびセキュリティに関する考慮事項を参照。

   2. session の追跡対象メッシュの集合に、 native mesh に対応するオブジェクト mesh が含まれる場合、メッシュオブジェクトを更新するアルゴリズムを mesh、native mesh、および frame とともに呼び出し、次の 項目へ進む。

   3. mesh を、メッシュオブジェクトを作成する アルゴリズムを native mesh および frame とともに呼び出した結果とする。

   4. mesh を session の追跡対象メッシュの集合に追加する。

5. このアルゴリズムの呼び出し中に作成も更新もされなかった各オブジェクトを、session の追跡対象 メッシュの集合から削除する。

6. frame の detectedMeshes を追跡対象メッシュの集合に設定する。

ネイティブメッシュオブジェクト native mesh および XRFrame frame からメッシュ オブジェクトを作成するため、ユーザーエージェントは次の手順を実行しなければならない。

1. result を XRMesh の新しいインスタンスとする。

2. result のネイティブエンティティを native mesh に設定する。

3. result の meshSpace を、新しい XRSpace オブジェクトに設定する。このオブジェクトは、セッションを frame の session に設定し、ネイティブ原点を native mesh の ネイティブ原点を追跡するよう設定して作成される。

4. メッシュ オブジェクトを更新するアルゴリズムを、result、native mesh、および frame とともに呼び出す。

5. result を返す。

この方法で作成されたメッシュオブジェクト result は、渡されたネイティブメッシュ オブジェクト native mesh に対応するという。

ネイティブメッシュオブジェクト native mesh および XRFrame frame からメッシュオブジェクト mesh を更新するため、 ユーザーエージェントは次の手順を実行しなければならない。

1. mesh のフレームを frame に設定する。

2. mesh の vertices を、ネイティブメッシュ表現の差異を考慮するために必要なすべての変換を実行した、native mesh の頂点を表す 新しい頂点配列に設定する。

3. mesh の indices を、ネイティブメッシュ表現の差異を考慮するために必要なすべての変換を実行した、native mesh の頂点を表す 新しいインデックス配列に設定する。

4. 必要に応じて、§ 6 プライバシーおよびセキュリティに関する考慮事項に記載されているとおり、 mesh の vertices および indices の詳細度を下げる。

5. mesh の lastChangedTime を時刻に設定する。