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

Gdy wartość ArTextureUpdateMode to AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore udostępnia bufor sprzętowy Androida, gdy wywołana zostanie funkcja ArSession_update(). Ten bufor sprzętowy może być powiązany z Vulkanem VkImage.

Wyświetlanie przykładowej aplikacji

Obsługa renderowania Vulkan jest demonstrowana w aplikacji hello_ar_vulkan_c.

Włączanie trybu wyjścia bufora sprzętowego

Skonfigurowana wartość ArTextureUpdateMode określa, jak ARCore będzie aktualizować teksturę kamery. Gdy to ustawienie jest ustawione na AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore będzie przekazywać obraz z kamery za pomocą AHardwareBuffer.

Aby skonfigurować sesję do korzystania z 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: gdy używasz AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER na urządzeniach niezgodnych z tym formatem, ArSession_configure() nie zadziała i zwróci AR_ERROR_UNSUPPORTED_CONFIGURATION.

Pobieranie bufora sprzętowego

Gdy włączona jest opcja AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, użyj opcji ArFrame_getHardwareBuffer(), aby uzyskać 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: wartość AHardwareBuffer jest gwarantowana tylko do następnego wywołania funkcji ArSession_update(). Jeśli chcesz używać bufora sprzętowego do innych celów, np. do renderowania, musisz wywołać funkcję AHardwareBuffer_acquire(), a następnie, po zakończeniu renderowania, funkcję AHardwareBuffer_release().

Używanie bufora sprzętowego podczas renderowania Vulkan

Przykład renderowania aplikacji AR za pomocą Vulkana znajdziesz w artykule vulkan_handler.cc.

Obsługiwane urządzenia

Obsługa renderowania Vulkan jest dostępna tylko na poziomie interfejsu API Androida 27 i wyższym. Dodatkowo urządzenie musi obsługiwać rozszerzenie VK_ANDROID_external_memory_android_hardware_buffer.

Wymagaj Vulkana w pliku manifestu aplikacji

Google Play używa <uses-feature> zadeklarowanego w pliku manifestu aplikacji, aby odfiltrowywać aplikacje na urządzeniach, które nie spełniają wymagań dotyczących sprzętu i oprogramowania. Urządzenia korzystające z Vulkana 1.0 mogą nie obsługiwać wymaganego rozszerzenia, ale urządzenia zgodne z Vulkanem 1.1 muszą mieć wymagane rozszerzenie, począwszy od Androida 10 (poziom interfejsu API 29).