Jetpack XR SDK'sı ile geliştirme yapma

Jetpack XR SDK'sı, Android XR cihazlar için sürükleyici ve artırılmış deneyimler oluşturmak üzere ihtiyacınız olan tüm araçları ve kitaplıkları içerir.

Tamamen sürükleyici deneyimler oluşturma

XR kulaklığı ve kablolu XR gözlükleri gibi özel, son ürünün tasarıma uygunluğu yüksek olan cihazları hedefleyin. Kotlin ve Compose gibi modern Android geliştirme araçlarının yanı sıra Java ve Views gibi önceki nesil araçları kullanın. Kullanıcı arayüzünüzü uzamsallaştırabilir, 3D modelleri yükleyip oluşturabilir ve gerçek dünyayı semantik açıdan anlayabilirsiniz.

Android'de mobil veya büyük ekran uygulamanız varsa Jetpack XR SDK, mevcut düzenleri uzamsallaştırarak ve deneyimlerinizi 3D modeller ve sürükleyici ortamlarla geliştirerek uygulamanıza yeni bir boyut kazandırır. Mevcut Android uygulamanızı uzamsallaştırmayla ilgili önerilerimiz için kalite yönergelerimize göz atın.

Artırılmış gerçeklik deneyimleri ve faydalı deneyimler oluşturma

Hafif ve şık sesli gözlükler ile görüntülü gözlükleri hedefleyin. Kotlin ve Jetpack Compose Glimmer gibi modern Android geliştirme araçlarını kullanın. Telefondan gözlüğe yansıtılan uygulama deneyimlerini kolaylaştıran API'leri kullanın.

Jetpack kitaplıklarını kullanma

Jetpack XR SDK kitaplıkları; zengin, sürükleyici deneyimler, hafif, artırılmış deneyimler ve çok daha fazlasını oluşturmak için kapsamlı bir araç seti sunar. Aşağıdaki kitaplıklar, Jetpack XR SDK'sının bir parçasıdır:

• XR için Jetpack Compose: Android XR'ın uzamsal özelliklerinden yararlanan uzamsal kullanıcı arayüzü yerleşimlerini bildirimli olarak oluşturun.
• XR için Materyal Tasarım: XR'a uyum sağlayan Materyal bileşenleri ve düzenleriyle geliştirme yapın.
• Jetpack SceneCore: 3D içeriklerle Android XR sahne grafiğini oluşturun ve değiştirin.
• Jetpack XR için ARCore: Algılama özellikleriyle dijital içerikleri gerçek dünyaya taşıyın.
• Jetpack Compose Glimmer: Artırılmış Android XR deneyimleri oluşturmak için kullanılan bir kullanıcı arayüzü araç setidir. Görüntülü gözlükler için optimize edilmiştir.
• Jetpack Projected: Telefondan ses arabirimli gözlüklere veya görüntü arabirimli gözlüklere yansıtılan uygulama deneyimlerini kolaylaştıran API'ler.

Geliştirici Önizlemesi sırasında API geliştirme

Jetpack XR SDK kitaplıkları, Android XR Geliştirici Önizlemesi'nin bir parçasıdır ve bu API'ler hâlâ geliştirme aşamasındadır. Bilinen sorunlar için kitaplık sürüm notlarına bakın:

• XR için Jetpack Compose Sürüm Notları
• Jetpack XR için ARCore Sürüm Notları
• Jetpack SceneCore Sürüm Notları
• XR Çalışma Zamanı Sürüm Notları
• Jetpack Compose Glimmer Sürüm Notları
• Jetpack Öngörülen Sürüm Notları

Bu listelerde yer almayan bir sorunla karşılaşırsanız lütfen hata bildirin veya geri bildirim gönderin.

XR için Jetpack Compose

XR için Jetpack Compose ile, satırlar ve sütunlar gibi uzamsallaştırılmış bileşenleri kullanarak tanıdık, bildirime dayalı bir Compose modeli ile uzamsal kullanıcı arayüzü ve düzenler oluşturabilirsiniz.

Bu kitaplık, mevcut 2D Compose veya Views tabanlı kullanıcı arayüzünüzü uzamsal bir düzende yerleştirmenize olanak tanıyan alt alan oluşturulabilirleri (ör. uzamsal paneller ve orbiter'ler) de sağlar. Diğer alt alan oluşturulabilirleri, diğer uzamsal kullanım alanlarını işler. Örneğin, SceneCoreEntity, 3D modeller gibi varlıkları kullanıcı arayüzünüze göre yerleştirmenize olanak tanır.

Mevcut Android uygulamanızı uzamsallaştırıyor veya sıfırdan yeni bir XR uygulaması oluşturuyor olmanız fark etmeksizin XR için Jetpack Compose'u kullanabilirsiniz.

Daha fazla bilgi için uzamsal kullanıcı arayüzüyle ilgili geliştirici kılavuzunu ve kitaplık ile API referans belgelerini inceleyin.

XR için Materyal Tasarım

Materyal Tasarım, XR'a uyum sağlayan bileşenler ve düzenler sunar. Uyarlanabilir düzenlerle uygulama geliştiriyorsanız XR için Materyal Tasarım'ı uygulama hakkında daha fazla bilgi edinin.

Jetpack SceneCore

Jetpack SceneCore kitaplığı, öğeler tarafından tanımlanan 3D içerikleri birbirine ve ortamınıza göre yerleştirip düzenlemenize olanak tanır. SceneCore ile şunları yapabilirsiniz:

• Üç boyutlu ortamları ayarlama
• PanelEntity örneği oluşturma
• 3D modelleri yerleştirme ve animasyon ekleme
• Üç boyutlu ses kaynaklarını belirtme
• Varlıklara taşınabilir, yeniden boyutlandırılabilir ve gerçek dünyaya sabitlenebilir bileşenler ekleme

Jetpack SceneCore kitaplığı, Views kullanılarak oluşturulan uygulamaların uzamsallaştırılması için de destek sağlar. Daha fazla bilgi için Views ile çalışma kılavuzumuza bakın.

Daha ayrıntılı bilgi için API referansını inceleyin.

Jetpack XR için ARCore

Mevcut ARCore kitaplığından ilham alan Jetpack XR için ARCore kitaplığı, dijital içeriği gerçek dünyayla harmanlama özellikleri sunar. Bu kitaplıkta hareket izleme, kalıcı bağlantılar, isabet testi ve anlamsal etiketleme (ör. zemin, duvarlar ve masaüstleri) ile düzlem tanımlama özellikleri bulunur. Bu kitaplık, OpenXR tarafından desteklenen temel algılama yığınından yararlanır. Bu sayede çok çeşitli cihazlarla uyumluluk sağlanır ve uygulamalar geleceğe hazır hale getirilir.

Daha ayrıntılı bilgi için Jetpack XR için ARCore ile çalışma başlıklı makaleyi inceleyin.

Jetpack Compose Glimmer

Jetpack Compose Glimmer, Android XR'da artırılmış gerçeklik deneyimleri oluşturmak için kullanılan bir kullanıcı arayüzü araç setidir ve görüntülü gözlükler için optimize edilmiştir. Gün boyu kullanılan cihazlar için güzel, minimalist ve rahat bir kullanıcı arayüzü oluşturun.

• Bir bakışta anlaşılacak ve okunacak şekilde tasarlandı: Telefonların aksine birincil tuval, optik şeffaf bir ekrandır. Jetpack Compose Glimmer, içeriklerinizin okunabilir olmasını, hızlı işlenmesini ve asla dikkat dağıtıcı olmamasını sağlamak için gözlüğe özel temalar, basitleştirilmiş renk paletleri ve tipografi sunar.
• Giyilebilir cihazlara özel etkileşimler için optimize edildi: Etkileşim modellerini, kullanıcıların gözlük kullanma şekline göre optimize ettik. Jetpack Compose Glimmer bileşenleri, dikkat dağıtıcı dalga efektleri yerine optimize edilmiş ana hatlar gibi net odaklanma durumları sunar ve dokunma, çerçeve üzerinde kaydırma ve tabii ki ses gibi yaygın fiziksel girişleri işleyecek şekilde tasarlanmıştır.
• Tanıdık bildirime dayalı kullanıcı arayüzü kalıplarını kullanma: Jetpack Compose Glimmer tamamen Jetpack Compose üzerine kurulu olduğundan Android'de bildirime dayalı kullanıcı arayüzü oluşturma hakkında bildiğiniz her şeyi kullanabilirsiniz. Gözlük ortamı için optimize edilmiş Text, Icon, Button gibi temel, önceden oluşturulmuş Composable işlevlerinin yanı sıra TitleChip gibi özel bileşenlerin tümünü sunuyoruz.

Jetpack Projected

Ses arabirimli gözlükler ve görüntü arabirimli gözlükler için uygulama geliştirirken uygulamanız, uygulamanızın XR deneyimlerini yansıtan Android telefon gibi tamamlayıcı bir ana cihazda çalışır. Jetpack Projected, ana cihazların XR yansıtma özellikleri varsa bu Android ana cihazların ses veya görüntü arabirimli gözlüklerle iletişim kurmasını sağlar.

• Yansıtılan cihaz donanımına erişme: Yansıtılan cihazla (ses arabirimli gözlük veya görüntü arabirimli gözlük) bağlantılı bir cihaz bağlamı. Bu yansıtılan bağlam, kamera gibi yansıtılan cihaz donanımına erişim sağlar. Sesli veya görüntülü gözlüklerde gösterilmek üzere özel olarak oluşturulan etkinlikler zaten yansıtılan bağlam olarak çalışır. Uygulamanızın başka bir bölümünün (ör. telefon etkinliği veya hizmet) gözlüğün donanımına erişmesi gerekiyorsa yansıtılan bir bağlam elde edebilir.
• İzin isteklerini basitleştirme: Ses arabirimli gözlükler ve görüntü arabirimli gözlükler, standart Android izin modelini kullanır. Uygulamanızın kamera gibi cihaz donanımlarına erişebilmesi için gözlüğe özel izinlerin çalışma zamanında istenmesi gerekir. İzin yardımcısı, tutarlı bir istek deneyimi sunmak için hem telefon hem de gözlük arayüzlerinde bu izin isteği mekanizmalarını kolaylaştırır.
• Cihaz ve ekran özelliklerini kontrol etme: Yansıtılan cihazda ekran olup olmadığını ve görselleri göstermek için ekranın durumunu kontrol edin. Uygulamanızı cihazın özelliklerine göre uyarlayın. Örneğin, cihazda ekran yoksa veya ekran kapalıysa daha fazla ses bağlamı sağlamak isteyebilirsiniz.
• Uygulama kamera işlemlerine erişme: Uygulamanız, kullanıcı kamera işlemlerine erişebilir. Örneğin, bir video yayın uygulamasında kamerayı açabilir veya kapatabilir.

Android XR emülatörü ile XR uygulama deneyimlerini test etme

Android XR Emülatör, XR uygulama geliştirme için tasarlanmış özel bir Android Emülatör sürümüdür. XR uygulamalarınızı Android Studio'nun tanıdık ortamında test etmenize ve hatalarını ayıklamanıza olanak tanır. XR kulaklığı ve kablolu XR gözlükleri gibi sürükleyici cihazlardan sesli ve görüntülü gözlük gibi akıllı gözlüklere kadar her tür Android XR cihazı için sanal cihazlar oluşturun.

Uygulamanızı çalıştırmaya ve hata ayıklamaya hazır olduğunuzda başlamak için şu kılavuzları inceleyin:

• XR kulaklığı ve XR gözlükleri için sanal cihazlar oluşturma
• Sesli ve görüntülü gözlükler için sanal cihazlar oluşturma

---

OpenXR™ ve OpenXR logosu, The Khronos Group Inc. şirketine ait ticari markalardır ve Çin, Avrupa Birliği, Japonya ve Birleşik Krallık'ta ticari marka olarak tescillidir.