Jetpack XR için ARCore'u kullanarak algı ile uygulama deneyimlerini geliştirme

Uygun XR cihazlar
Bu kılavuz, bu tür XR cihazları için deneyimler geliştirmenize yardımcı olur.
XR Kulaklığı
Kablolu XR Gözlükleri
Ses ve
Görüntü Arabirimli Gözlük

Jetpack XR için ARCore, uygulamanızın çeşitli API'ler aracılığıyla gerçek dünyayı anlaması için güçlü algılama özellikleri sunar. Bu API'lerden bazıları, XR kulaklığı ve kablolu XR gözlükleri gibi cihazlarda sürükleyici deneyimleri iyileştirmenize yardımcı olur. Bazıları, yapay zeka destekli akıllı gözlük gibi cihazlarda artırılmış deneyimleri iyileştirmenize yardımcı olur. Bazıları ise tüm Android XR cihaz türlerinde uygulama deneyimlerini iyileştirmenize yardımcı olur.

Örneğin, düzlemsel verileri almak, içeriği uzayda sabit bir konuma sabitlemek veya içeriği gerçek dünyadaki bir konuma sabitlemek için coğrafi konum pozunu kullanmak üzere Jetpack XR için ARCore'u kullanabilirsiniz.

Kitaplık bağımlılıkları ekleme

XR uygulamanızda algılama özelliklerini kullanmaya başlamadan önce, AR ile geliştirdiğiniz uygulama deneyimlerinin türüne bağlı olarak gerekli bağımlılıkları ekleyin.

Oturuma erişme

Jetpack XR için ARCore'daki algılama özellikleri, Jetpack XR çalışma zamanını kullanan bir Session'a dayanır.

Uygulamanızın bir oturuma nasıl erişeceği, algılama özellikleriyle geliştirdiğiniz uygulama deneyimlerinin türüne bağlıdır:

Jetpack XR Runtime'ı kullanarak oturum oluşturma

Oturum oluşturmak için create() yöntemine bir Context iletin. Bu Context, etkileyici XR cihazlarında veya mobil cihazlarda Activity ya da akıllı gözlüklerde yansıtılan bağlam olabilir.

ARCore oturumu oluşturmak, yüksek maliyetli bir görev olabilir ve aşağıdaki örnekte gösterildiği gibi arka planda işlenmelidir:

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

create() işlevi, oturumun yaşam döngüsünün farklı bir LifecycleOwner tarafından yönetilmesine olanak tanıyan isteğe bağlı bir LifecycleOwner parametresi kullanabilir. LifecycleOwner, yaşam döngüsünü sağlanan bağlam kapsamında başlatıp sonlandırmalıdır. Aksi takdirde Session sızıntılara açık olabilir.

Oturum yapılandırma

Bazı özellikler varsayılan olarak devre dışı bırakılmış olabilir ve çalışması için yapılandırılması gerekir. Bir oturumu yapılandırmak için configure() kullanın ve Session'nızın ihtiyaç duyduğu yapılandırma seçeneklerini belirtin. Farklı AR özellikleri için gereken yapılandırma hakkında ayrıntılı bilgi edinmek üzere her bir AR özelliğinin ilgili sayfalarını inceleyin.

Sonraki adımlar

Uygulamanızda bir oturum oluşturulduktan sonra, farklı XR cihazlarda uygulama deneyimlerini iyileştirmek için bu oturumu nasıl kullanabileceğinizi keşfedin: