Jetpack XR 用 ARCore でアンカーを作成する

アンカーは、現実世界での固定された位置と向きを表します。オブジェクトをアンカーにアタッチすると、オブジェクトが現実世界にリアルに配置されたように見えます。

ARCore for Jetpack XR セッションを作成する

Jetpack XR セッションの ARCore を介してアンカーを作成します。Session を取得するには、セッションのライフサイクルについてをご覧ください。

セッションを構成する

アンカーの作成と読み込みにセッションの構成は必要ありません。ただし、アンカーの永続性は XR セッションではデフォルトで有効になっていません。アンカーをローカル ストレージに保存して読み込むには、セッションを構成して AnchorPersistenceMode.LOCAL モードを設定します。

val newConfig = session.config.copy(
    anchorPersistence = Config.AnchorPersistenceMode.LOCAL,
)
when (val result = session.configure(newConfig)) {
    is SessionConfigureConfigurationNotSupported ->
        TODO(/* Some combinations of configurations are not valid. Handle this failure case. */)
    is SessionConfigureSuccess -> TODO(/* Success! */)
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}
Anchors.kt

コンテンツを空間内の固定された場所にアンカーする

アンカーは Pose を使用して作成されます。これは、既存の Trackable を基準として解釈することも、そうでないこともあります。

Trackable を基準としたアンカーを作成する

Trackable（Plane など）を基準にアンカーを作成すると、アンカーは空間内を移動する際に、アタッチされた Trackable に追従します。

when (val result = trackable.createAnchor(pose)) {
    is AnchorCreateSuccess -> { /* anchor stored in `result.anchor`. */ }
    else -> { /* handle failure */ }
}
Anchors.kt

Trackable なしでアンカーを作成する

Trackable に関連付けられていないアンカーを作成するには:

when (val result = Anchor.create(session, pose)) {
    is AnchorCreateSuccess -> { /* anchor stored in `result.anchor`. */ }
    else -> { /* handle failure */ }
}
Anchors.kt

エンティティをアンカーにアタッチする

この位置にモデルをレンダリングするには、GltfModel を作成し、その親を AnchorEntity に設定します。

AnchorEntity.create(session, anchor).apply {
    parent = session.scene.activitySpace
    addChild(entity)
}
Anchors.kt

TrackingState について

各 Trackable には TrackingState があり、使用する前に確認する必要があります。TrackableState が Tracking の Trackable は、Pose がシステムによってアクティブに更新されます。Paused の Trackable は将来 Tracking になる可能性がありますが、Stopped の Trackable は Tracking になることはありません。

セッション全体でアンカーを保持する

永続化されていないアンカーは、セッションが破棄されると消えます。アンカーを永続化すると、アプリはアンカーの位置をプライベート アプリデータに保存します。このアンカーは後続のセッションで取得でき、同じ場所で固定されます。

アンカーを永続化するには、次のように Anchor.persist() を使用します。

val uuid = anchor.persist()
AnchorPersistence.kt

アプリは、今後のセッションで UUID を使用してアンカーを取得できます。

when (val result = Anchor.load(session, uuid)) {
    is AnchorCreateSuccess -> {
        // Loading was successful. The anchor is stored in result.anchor.
    }
    else -> {
        // handle failure
    }
}
AnchorPersistence.kt

アンカーが不要になったら、unpersist() を呼び出します。これにより、アプリのストレージからアンカーが削除され、指定された UUID が Anchor.load() の呼び出しで取得できなくなります。

Anchor.unpersist(session, uuid)
AnchorPersistence.kt

アプリは、アプリのストレージに保存されていて、まだ存在しているすべてのアンカーのリストをリクエストすることもできます。

val uuids = Anchor.getPersistedAnchorUuids(session)
AnchorPersistence.kt