Depth APIの概要

更新日時: 2025/03/20

健康と安全に関する推奨事項: 複合現実エクスペリエンスを構築する際、快適かつ安全なエクスペリエンスをユーザーに提供するため、開発者が自分のコンテンツを評価することを強くおすすめします。Depth(奥行)を使ったアプリの設計と開発を始める前に、健康と安全および設計に関する各ガイドラインをお読みください。

概要

Depth APIとは？

Depth APIには、アプリで環境を知覚するために使えるリアルタイムの奥行マップが備わっています。主に、仮想オブジェクトが現実世界のオブジェクトやサーフェスによって遮蔽されるようにし、実際の環境に溶け込んで見えるようにすることで複合現実(MR)を強化します。仮想コンテンツが現実世界の手前のレイヤーとして見えてしまうと、没入感が損なわれる可能性があり、それを防ぐためにもオクルージョンは重要です。

Depth APIを使う理由

シーンモデルを利用すれば、リアルなオクルージョンを実現する複合現実エクスペリエンスをルーム規模で作成することができます。しかし、手や腕、他の人やペットなど、ユーザーのビュー内で動的に移動するオブジェクトのオクルージョンには対応できません。これらの動的要素をリアルにオクルージョンするには、Depth APIも使う必要があります。

ユースケース	Depth API	Scene API
静的オクルージョン: 現実世界の環境のオクルージョンは、アプリの実行中は動かないまま(静的)で、手、人、椅子といった動く物体には対応しない。	✔	✔
動的オクルージョン: 現実世界の環境のオクルージョンには、ユーザーの手、ほかの人、ペットなど、動く要素(動的要素)が含まれる。	✔	✖
レイキャスティング: 光線と現実世界の表面の交差点を計算する。コンテンツ配置などの用途をサポート。	✔	✔
物理・衝突: 仮想ボールが実際にそこにあるソファにあたって跳ね返るなど、バーチャルコンテンツと物理コンテンツの間のインタラクション。	✖	✔

Depth APIの利用を開始する方法

Depth APIはQuest 3以降のデバイスでのみサポートされています。

Depth APIの利用を始める前に、パススルーについて理解する必要があります。環境の奥行を取得するには、アプリにパススルーがあることが必須となります。

要件

Unity 2022.3.15f1以上、2023.2以上(Unity 6以上を推奨)

Meta XR Core SDK (v67.0.0以上)。以下のいずれか1つの方法で入手してください。

Unityアセットストア⁠から入手する。

Unityのパッケージマネージャからcom.meta.xr.sdk.core (v67.0.0以上)パッケージをインポートする。Metaの公式ドキュメントで概説されている、個々のSDKをUnityにインポートする手順に従ってください。

XRプロバイダープラグイン

Unity OpenXR Metaプラグイン拡張機能(com.unity.xr.meta-openxr@2.1.0-pre.1) (Unityバージョン6以上とMeta XR SDK v74以上でのオクルージョンサポートに必須)

Oculus XRプラグイン4.2.0以上(Unityバージョン6未満、SDKバージョンv74未満)

v67以降、奥行テクスチャーを取得するメカニズムがアップデートされ、品質とパフォーマンスが向上しています。Depth APIではそれより前のバージョンもサポートされていますが、最適なエクスペリエンスを実現するためには、バージョンv67にアップグレードすることをおすすめします。以前のバージョンからのアップデートに関するサポートは、こちらのGitHubリポジトリ⁠のドキュメントをご覧ください。v67以前のサポートについては、こちらのドキュメントの旧版⁠をご覧ください。

オクルージョンの概要セクションでは、Depth APIの最も一般的な使用事例を取り上げ、その後、実装方法を手順ごとに説明しています。

このページは役に立ちましたか？