Jetpack XR için ARCore ile ankraj oluşturma

Uygun XR cihazlar

Bu kılavuz, bu tür XR cihazlar için deneyimler oluşturmanıza yardımcı olur.

XR cihaz türleri hakkında bilgi edinin →

XR cihaz türleri hakkında bilgi edinin →

Sabit nokta, gerçek dünyadaki sabit bir konumu ve yönü tanımlar. Bir nesneyi tutturma noktasına eklemek, nesnelerin gerçek dünyada gerçekçi bir şekilde yerleştirilmiş gibi görünmesine yardımcı olur.

Bir oturuma erişme

Jetpack XR için ARCore Session aracılığıyla bağlantı oluşturun. XR için Jetpack Compose'u kullanarak uzamsal kullanıcı arayüzünü geliştiriyorsanız XR için Jetpack Compose'un bir oturumuna erişin. Jetpack SceneCore kitaplığındaki uzamsallaştırılmış öğelerle çalışıyorsanız Jetpack XR Runtime'dan bir oturuma erişin.

Oturumu yapılandırma

Çapalama oluşturma ve yükleme için oturumun yapılandırılması gerekmez. Ancak, sabitleme kalıcılığı XR oturumlarında varsayılan olarak etkin değildir. Yerel depolama alanındaki bağlantıları kalıcı hale getirmek ve yüklemek için oturumu yapılandırın ve AnchorPersistenceMode.LOCAL modunu ayarlayın:

val newConfig = Config.Builder(session.config)
    .setAnchorPersistence(AnchorPersistenceMode.LOCAL)
    .build()
when (val result = session.configure(newConfig)) {
    is SessionConfigureSuccess -> TODO(/* Success! */)
    else ->
        TODO(/* The session could not be configured. See SessionConfigureResult for possible causes. */)
}
Anchors.kt

İçeriği uzayda sabit bir konuma sabitleme

Sabit bağlantı, mevcut bir Anchorable ile ilişkili olarak veya ilişkili olmadan yorumlanabilen bir Pose kullanılarak oluşturulur. Anchorable, sabit reklamların eklenebileceği bir Trackable birimidir.

Anchorable öğesine göre bir bağlantı oluşturma

Anchorable'ya göre bir bağlantı oluşturulduğunda (ör. Plane) bağlantı, uzayda hareket ederken ekli Anchorable'yı takip eder.

val anchor = plane.createAnchor(pose)
Anchors.kt

Anchorable olmadan bağlantı oluşturma

Anchorable'ya bağlı olmayan bir bağlantı oluşturmak için:

val anchor = Anchor.create(session, pose)
Anchors.kt

Bir öğeyi bağlayıcıya ekleme

Bu konumda bir model oluşturmak için GltfModel oluşturun ve üst öğesini AnchorSpace olarak ayarlayın.

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

TrackingState'i anlama

Her Trackable öğesinin kullanılmadan önce kontrol edilmesi gereken bir TrackingState vardır. Tracking TrackableState değerine sahip bir Trackable öğesinin Pose özelliği sistem tarafından etkin bir şekilde güncellenir. Trackable olan bir Paused, gelecekte Tracking olabilir. Stopped olan bir Paused ise asla Tracking olmaz.

Oturumlar boyunca bir sabitleme noktasını koruma

Kalıcı olmayan bir bağlantı, oturum sonlandırıldıktan sonra kaybolur. Uygulamanız, bir sabitleme noktasını kalıcı hale getirerek bu sabitleme noktasının özel uygulama verilerindeki konumunu hatırlar. Bu bağlantı, sonraki bir oturumda alınabilir ve dünyada aynı konuma sabitlenir.

Bir sabitleme noktasını kalıcı hale getirmek için Anchor.persist() öğesini burada gösterildiği gibi kullanın:

val uuid = anchor.persist()
AnchorPersistence.kt

Uygulamanız, gelecekteki bir oturumda UUID kullanarak bağlantıyı alabilir:

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

Artık bir sabitleyiciye ihtiyacınız kalmadığında unpersist() işlevini çağırın. Bu işlem, uygulamanızın depolama alanından sabiti kaldırır ve verilen UUID'nin Anchor.load() çağrıları için alınamaz hale gelmesini sağlar.

Anchor.unpersist(session, uuid)
AnchorPersistence.kt

Uygulamanız, kalıcı hale getirilmiş ve uygulamanızın depolama alanında hâlâ bulunan tüm bağlantı noktalarının listesini de isteyebilir:

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