Renderuj aplikację AR za pomocą Vulkana na Androidzie NDK (C)

Gdy parametr ArTextureUpdateMode ma wartość AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore udostępnia bufor sprzętowy Androida po wywołaniu elementu ArSession_update(). Ten bufor sprzętowy może być powiązany z interfejsem Vulkan VkImage.

Wyświetl przykładową aplikację

Obsługa renderowania za pomocą interfejsu Vulkan jest przedstawiona w przykładowej aplikacji hello_ar_vulkan_c.

Włącz tryb wyjścia bufora sprzętowego

Skonfigurowane pole ArTextureUpdateMode określa, w jaki sposób ARCore będzie aktualizować teksturę aparatu. Gdy jest ustawiona na AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore udostępni obraz z aparatu za pomocą AHardwareBuffer.

Skonfiguruj sesję, aby używała AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER:

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);

Uwaga: jeśli używasz AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER na niezgodnych urządzeniach, ArSession_configure() zawiedzie i zwróci AR_ERROR_UNSUPPORTED_CONFIGURATION.

Pobierz bufor sprzętowy

Gdy AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER jest włączony, użyj ArFrame_getHardwareBuffer(), aby pobrać bufor sprzętowy:

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;
}

Uwaga: ten element AHardwareBuffer będzie ważny tylko do następnego wywołania funkcji ArSession_update(). Jeśli chcesz dodatkowo wykorzystać bufor sprzętowy, np. do renderowania, musisz wywołać AHardwareBuffer_acquire(), a potem AHardwareBuffer_release() po zakończeniu renderowania.

Używaj bufora sprzętowego podczas renderowania interfejsu Vulkan

Przykład tego, jak renderować aplikację AR za pomocą interfejsu Vulkan, znajdziesz vulkan_handler.cc.

Obsługiwane urządzenia

Obsługa renderowania za pomocą interfejsu Vulkan jest dostępna tylko w przypadku interfejsów API Androida na poziomie 27 i wyższych. Dodatkowo urządzenie musi obsługiwać rozszerzenie VK_ANDROID_external_memory_android_hardware_buffer.

Wymagaj interfejsu Vulkan w pliku manifestu aplikacji

Google Play używa elementu <uses-feature> zadeklarowanego w manifeście, aby odfiltrowywać aplikację z urządzeń, które nie spełniają wymagań dotyczących funkcji sprzętu i oprogramowania. Urządzenia korzystające z interfejsu Vulkan 1.0 mogą nie obsługiwać wymaganego rozszerzenia, ale urządzenia zgodne z Vulkan 1.1 muszą mieć wymagane rozszerzenie od Androida 10 (poziom API 29).