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:
- Uygulamanız, XR için Jetpack Compose'u kullanarak uzamsal kullanıcı arayüzü ile sürükleyici deneyimleri geliştiriyorsa XR için Jetpack Compose'dan bir oturuma erişin.
- Diğer tüm durumlarda, bu sayfanın sonraki bölümünde ele alınan Jetpack XR Çalışma Zamanı'nı kullanarak oturum oluşturabilirsiniz.
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:
- Jetpack XR için ARCore'u kullanarak düzlemleri algılama
- Jetpack XR için ARCore ile sabit noktalar oluşturma
- Jetpack XR için ARCore'u kullanarak ellerle çalışma
- Jetpack XR için ARCore ile uygulamanıza yüz takibi özelliğini ekleme
- Jetpack XR için ARCore ile uygulamanızda derinlik bilgilerini alma
- Jetpack XR için ARCore'u kullanarak cihazın duruşunu takip etme