Kayıt ve oynatmaya giriş

Platforma özel kılavuzlar

Artırılmış gerçeklik deneyimlerinin büyük çoğunluğu "gerçek zamanlı"dır. Bu deneyimler için kullanıcıların belirli bir zamanda belirli bir yerde olmaları, telefonlarının özel bir AR moduna ayarlanmış ve bir AR uygulamasına açılmış olması gerekir. Örneğin, bir kullanıcı AR koltuğun oturma odasında nasıl göründüğünü görmek isterse koltuğu fiziksel olarak odadayken ekrandaki ortama "yerleştirmesi" gerekir.

Kayıt ve Oynatma API'si bu "gerçek zamanlı" şartını ortadan kaldırarak istediğiniz yerde ve zamanda görüntülenebilecek AR deneyimleri oluşturmanıza olanak tanır. Kayıt API'si, kameranın video akışını, IMU verilerini veya MP4 dosyasına kaydetmeyi seçtiğiniz diğer tüm özel meta verileri depolar. Ardından, bu kayıtlı videoları Playback API aracılığıyla ARCore'a besleyebilirsiniz. Bu API, MP4'ü canlı oturum feed'i gibi işler. Canlı kamera oturumunu kullanmaya devam edebilirsiniz ancak bu yeni API ile AR uygulamalarınız, canlı oturum yerine önceden kaydedilmiş bir MP4 kullanmayı tercih edebilir.

Son kullanıcılar da bu özellikten yararlanabilir. Gerçek hayatta nerede olurlarsa olsunlar, Kayıt ve Oynatma API'si ile kaydedilen tüm videoları kendi galerilerinden açabilir, AR nesneleri, efektleri ve filtreleri ekleyebilir ya da oynatabilirler. Bu özellik sayesinde kullanıcılar, ofise giderken trende veya yatakta uzanırken AR alışverişi yapabilir.

Kayıt ve Oynatma API'si ile geliştirme için kullanım alanları

Kayıt ve Oynatma API'si, AR uygulamaları oluşturmanın zaman ve alan kısıtlamalarını ortadan kaldırır. Bu özelliği kendi projelerinizde kullanabileceğiniz bazı yöntemler aşağıda açıklanmıştır.

Bir kez kaydedin, her yerde test edin

Bir AR özelliğini test etmeniz gerektiğinde her seferinde fiziksel olarak bir yere gitmek yerine Recording API'yi kullanarak video kaydedebilir ve ardından uyumlu herhangi bir cihaz kullanarak videoyu oynatabilirsiniz. Alışveriş merkezinde bir deneyim mi oluşturuyorsunuz? Her değişiklikte bu sayfaya gitmeniz gerekmez. Ziyaretinizi bir kez kaydedin, ardından kendi masanızdan tekrar tekrar inceleyip geliştirin.

Yineleme süresini azaltma

Desteklemek istediğiniz her Android cihaz için, test etmek istediğiniz her senaryo için ayrı ayrı video kaydetmek yerine videoyu bir kez kaydedebilir ve iterasyon aşamasında birden fazla farklı cihazda oynatabilirsiniz.

Geliştirme ekiplerindeki manuel test yükünü azaltma

Her yeni özellik için özel veri kümeleri oluşturmak yerine, ARCore'daki en son izleme iyileştirmelerini veya derinliği içeren yeni özellikleri kullanıma sunarken önceden kaydedilmiş veri kümelerinden yararlanın.

Cihaz uyumluluğu

Kayıt ve Oynatma API'si ile veri kaydetmek için ARCore'a ihtiyacınız vardır ancak verileri oynatmak için ARCore'a ihtiyacınız yoktur. Bu özellik kullanılarak kaydedilen MP4'ler, herhangi bir video oynatıcı kullanılarak görüntülenebilen ek veriler içeren video dosyalarından oluşur. Bu dosyaları Android'in ExoPlayer'ı veya hem MP4'leri çözebilen hem de ARCore tarafından eklenen ek verileri yönetebilen uyumlu herhangi bir oynatıcıyla inceleyebilirsiniz.

Video ve AR verileri oynatılmak üzere nasıl kaydedilir?

ARCore, kaydedilen oturumları hedef cihazdaki MP4 dosyalarına kaydeder. Bu dosyalar birden fazla video parçası ve diğer çeşitli veriler içerir. Bu oturumlar kaydedildikten sonra uygulamanızı, canlı kamera oturumu yerine bu verileri kullanacak şekilde ayarlayabilirsiniz.

Kayıtlarda neler bulunur?

ARCore, H.264 videosunda aşağıdaki verileri yakalar. Parça değiştirebilen tüm MP4 uyumlu video oynatıcılarda bu parçaya erişebilirsiniz. Bazı MP4 uyumlu video oynatıcıları, hangi video parçasını oynatacağınızı seçmenize izin vermeden listedeki ilk parçayı otomatik olarak oynattığından, en yüksek çözünürlüklü parça listede ilk sırada yer alır.

Birincil video kanalı (CPU resim kanalı)

Birincil video dosyası, ortamı veya sahneyi daha sonra oynatılmak üzere kaydeder. ARCore varsayılan olarak hareket izleme için kullanılan 640x480 (VGA) CPU görüntüsünü birincil video akışı olarak kaydeder.

ARCore, ekranda geçişli kamera görüntüsü olarak oluşturulan (yüksek çözünürlüklü) GPU dokusunu yakalamaz.

Oynatma sırasında yüksek çözünürlüklü bir resim akışının kullanılabilmesini istiyorsanız istediğiniz çözünürlüğe sahip bir CPU resmi sağlayan bir kamera yapılandırmanız gerekir. Bu durumda:

• ARCore, hem hareket izleme için ihtiyaç duyduğu 640x480 (VGA) CPU görüntüsünü hem de yapılandırılmış kamera yapılandırması tarafından belirtilen yüksek çözünürlüklü CPU görüntüsünü ister.
• İkinci CPU görüntü akışı yakalandığında uygulama performansı etkilenebilir ve farklı cihazlar farklı şekillerde etkilenebilir.
• ARCore, oynatma sırasında GPU dokusu olarak kayıt sırasında çekilen yüksek çözünürlüklü CPU görüntüsünü kullanır.
• Yüksek çözünürlüklü CPU görüntüsü, MP4 kaydında varsayılan video akışı olur.

Kayıt sırasında seçilen kamera yapılandırması, kayıttaki CPU görüntüsünü ve birincil video akışını belirler. Yüksek çözünürlüklü CPU resmi içeren bir kamera yapılandırması seçmezseniz bu video, dosyada ilk parça olur ve hangi video oynatıcıyı kullandığınızdan bağımsız olarak varsayılan olarak oynatılır.

Kamera derinlik haritası görselleştirmesi

Bu, kameranın derinlik haritasını temsil eden bir video dosyasıdır. Cihazın donanım derinlik sensöründen (ör. uçuş süresi sensörü veya ToF sensörü) kaydedilir ve RGB kanal değerlerine dönüştürülür. Bu video yalnızca önizleme amacıyla kullanılmalıdır.

API çağrısı etkinlikleri

ARCore, cihazın jiroskop ve ivme ölçer sensörlerinden alınan ölçümleri kaydeder. Bazıları hassas olabilecek diğer verileri de kaydeder:

• Veri kümesi biçimi sürümleri
• ARCore SDK sürümü
• AR için Google Play Hizmetleri sürümü
• Cihaz parmak izi (adb shell getprop ro.build.fingerprint işlevinin çıkışı)
• AR izleme için kullanılan sensörler hakkında ek bilgiler
• ARCore Geospatial API kullanılırken cihazın tahmini konumu, manyetometre ölçümleri ve pusula ölçümleri