ARCore for Jetpack XR を使用して知覚によるアプリ エクスペリエンスを強化する

対象の XR デバイス
このガイダンスは、このようなタイプの XR デバイス向けのエクスペリエンスを構築する際に役立ちます。
XR デバイスの種類について →
XR ヘッドセット
有線 XR グラス
AI メガネ
XR デバイスの種類について →

Jetpack XR 向け ARCore は、さまざまな API を通じてアプリが現実世界を理解するための強力な認識機能を提供します。これらの API の一部は、XR ヘッドセットや有線 XR グラスなどのデバイスの没入型エクスペリエンスを強化するのに役立ち、一部は AI グラスなどのデバイスの拡張エクスペリエンスを強化するのに役立ち、一部はあらゆるタイプの Android XR デバイスのアプリ エクスペリエンスを強化するのに役立ちます。

たとえば、ARCore for Jetpack XR を使用して平面データを取得したり、空間内の固定位置にコンテンツをアンカーしたり、地理空間ポーズを使用して現実世界の場所にコンテンツをアンカーしたりできます。

ライブラリの依存関係を追加する

XR アプリで知覚機能を使用する前に、AR で強化するアプリ エクスペリエンスの種類に応じて、必要な依存関係を追加します。

セッションにアクセスする

Jetpack XR 向け ARCore の認識機能は、Jetpack XR ランタイムを使用する Session に依存しています。

アプリがセッションにアクセスする方法は、知覚機能で強化するアプリ エクスペリエンスの種類によって異なります。

Jetpack XR ランタイムからセッションにアクセスする

Jetpack XR ランタイムからセッションにアクセスするには、セッションを作成します。

セッションを作成するには、次の例に示すように、アクティビティを create() メソッドに渡します。

when (val result = Session.create(this)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}
Session.kt

セッションのアクティビティが破棄されると、そのセッションに関連付けられているすべての AR コンテンツが破棄され、セッションは無効になります。

セッションを構成する

一部の機能はデフォルトで無効になっているため、機能させるには構成する必要があります。セッションを構成するには、configure() を使用して、Session が必要とする構成オプションを指定します。さまざまな AR 機能に必要な構成について詳しくは、各 AR 機能の対応するページをご覧ください。

次のステップ

アプリにセッションが設定されたら、さまざまな XR デバイスでアプリのユーザー エクスペリエンスを向上させるためにセッションを使用する方法を確認してください。