Android NDK'da Vulkan'ı kullanarak AR uygulamanızı oluşturma (C)

ArTextureUpdateMode AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER olarak ayarlandığında ArSession_update() çağrıldığında ARCore, Android donanım arabelleği sağlar. Bu donanım arabelleği bir Vulkan VkImage öğesine bağlı olabilir.

Örnek uygulamayı görüntüleyin

Vulkan oluşturma desteği, hello_ar_vulkan_c örnek uygulamasında gösterilmektedir.

Donanım arabelleği çıkış modunu etkinleştir

Yapılandırılmış ArTextureUpdateMode, ARCore'un kamera dokusunu nasıl güncelleyeceğini belirler. AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER olarak ayarlandığında ARCore, kamera görüntüsünü AHardwareBuffer aracılığıyla sağlar.

Oturumu AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER kullanacak şekilde yapılandırın:

ArConfig* ar_config = NULL;
ArConfig_create(ar_session, &ar_config);
ArConfig_setTextureUpdateMode(ar_session, ar_config,
                              AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER);
CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS);
ArConfig_destroy(ar_config);

Not: AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER uyumsuz cihazlarda kullanıldığında ArSession_configure() başarısız olur ve AR_ERROR_UNSUPPORTED_CONFIGURATION döndürülür.

Donanım arabelleğini alın

AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER etkinleştirildiğinde donanım arabelleğini almak için ArFrame_getHardwareBuffer() kullanın:

void* native_hardware_buffer = NULL;
ArFrame_getHardwareBuffer(ar_session, ar_frame, &native_hardware_buffer);

if ((int64_t)native_hardware_buffer == 0) {
  // The hardware buffer isn't ready yet.
  return;
}

Not: Bu AHardwareBuffer yalnızca bir sonraki ArSession_update() çağrısına kadar geçerli olacaktır. Donanım arabelleğini bunun dışında (ör. oluşturma) kullanmak isterseniz oluşturma işleminiz tamamlandıktan sonra AHardwareBuffer_acquire() ve ardından AHardwareBuffer_release() çağrısı yapmanız gerekir.

Vulkan oluşturma işlemi sırasında donanım arabelleğini kullan

Vulkan kullanılarak AR uygulaması oluşturma örneği için vulkan_handler.cc sayfasına bakın.

Desteklenen cihaz sayısı

Vulkan oluşturma desteği, yalnızca 27 ve üzeri Android API seviyelerinde kullanılabilir. Ayrıca, cihazın VK_ANDROID_external_memory_android_hardware_buffer uzantısını desteklemesi gerekir.

Uygulamanızın manifest dosyasında Vulkan'ı zorunlu kılma

Google Play, uygulamanızı donanım ve yazılım özelliği gereksinimlerini karşılamayan cihazlardan filtrelemek için uygulama manifestinizde belirtilen <uses-feature> kodunu kullanır. Vulkan 1.0 kullanan cihazlar gerekli uzantıyı desteklemeyebilir ancak Vulkan 1.1 ile uyumlu cihazlarda Android 10 (API düzeyi 29) sürümünden itibaren gerekli uzantı olmalıdır.