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". Kullanıcıların belirli bir zamanda belirli bir yerde olması, telefonlarının özel bir AR modunda olması ve bir AR uygulamasının açık olması gerekir. Örneğin, bir kullanıcı AR koltuğun oturma odasında nasıl göründüğünü görmek istiyorsa odada fiziksel olarak bulunurken koltuğu ekrandaki ortama "yerleştirmesi" gerekir.

Kayıt ve Oynatma API'si bu "gerçek zamanlı" şartını ortadan kaldırarak istediğiniz zaman, istediğiniz yerde görüntülenebilen AR deneyimleri oluşturmanıza olanak tanır. Recording API, bir kameranın video akışını, IMU verilerini veya MP4 dosyasına kaydetmeyi seçtiğiniz diğer özel meta verileri depolar. Ardından, bu kaydedilmiş videoları Playback API aracılığıyla ARCore'a aktarabilirsiniz. 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ı yerel galerilerinden çıkarabilir, AR nesnelerini, efektlerini ve filtrelerini düzenleyebilir veya oynatabilirler. Bu özellik sayesinde kullanıcılar, ofise giderken trende veya yatakta uzanırken AR alışverişi yapabilir.

Recording and Playback API ile geliştirme yapmaya yönelik kullanım alanları

Recording and Playback API, AR uygulamaları oluşturmayla ilgili zaman ve alan kısıtlamalarını ortadan kaldırır. Bu özelliği kendi projelerinizde kullanabileceğiniz bazı yöntemleri aşağıda bulabilirsiniz.

Bir kez kaydedin, her yerde test edin

Bir AR özelliğini her test etmeniz gerektiğinde fiziksel olarak bir konuma gitmek yerine, Recording API'yi kullanarak bir video kaydedebilir ve ardından bu videoyu uyumlu herhangi bir cihazda oynatabilirsiniz. Alışveriş merkezinde deneyim mi oluşturuyorsunuz? Bir değişikliği test etmek istediğinizde her seferinde bu sayfaya gitmeniz gerekmez. Ziyaretinizi bir kez kaydettikten sonra masanızdan kalkmadan yineleme yapabilir ve geliştirebilirsiniz.

Yineleme süresini azaltma

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

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

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

Cihaz uyumluluğu

Recording and Playback API ile veri kaydetmek için ARCore'a ihtiyacınız vardır ancak oynatmak için ARCore'a ihtiyacınız yoktur. Bu özellik kullanılarak kaydedilen MP4'ler, herhangi bir video oynatıcıyla görüntülenebilen, ekstra veriler içeren video dosyalarıdır. Bu dosyaları Android'in ExoPlayer'ı veya MP4'leri demuks edebilen ve ARCore tarafından eklenen ek verileri yönetebilen uyumlu bir oynatıcıyla inceleyebilirsiniz.

Video ve AR verileri oynatma için nasıl kaydedilir?

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

Kaydedilen toplantılarda neler yer alır?

ARCore, H.264 videosunda aşağıdaki verileri yakalar. Bu dosyaya, parça değiştirebilen ve MP4 uyumlu herhangi bir video oynatıcıdan erişebilirsiniz. MP4 uyumlu bazı video oynatıcılar, oynatılacak video parçasını seçmenize izin vermeden listedeki ilk parçayı otomatik olarak oynattığı için en yüksek çözünürlüklü parça listede ilk sırada yer alır.

Birincil video parçası (CPU görüntü parçası)

Birincil video dosyası, ortamı veya sahneyi daha sonra oynatmak ü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, geçiş kamerası görüntüsü olarak ekrana işlenen (yüksek çözünürlüklü) GPU dokusunu yakalamaz.

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

  • ARCore, hem hareket izleme için gereken 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ışının yakalanması uygulama performansını etkileyebilir ve farklı cihazlar farklı şekilde etkilenebilir.
  • Oynatma sırasında 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 görüntüsüne sahip bir kamera yapılandırması seçmezseniz bu video, dosyadaki ilk parça olur ve hangi video oynatıcıyı kullanırsanız kullanın varsayılan olarak oynatılır.

Kamera derinlik haritası görselleştirme

Bu, kameranın derinlik haritasını temsil eden bir video dosyasıdır. Uçuş süresi sensörü (ToF sensörü) gibi cihazın donanım derinlik sensöründen 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 ölçümler kaydeder. Ayrıca, 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 çıkışı)
  • AR takibi için kullanılan sensörler hakkında ek bilgiler
  • ARCore Geospatial API kullanılırken cihazın tahmini konumu, manyetometre okumaları ve pusula okumaları