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świetl przykładową aplikację

Obsługę renderowania Vulkan pokazano w przykładowej aplikacji hello_ar_vulkan_c.

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

Skonfigurowana wartość ArTextureUpdateMode określa sposób aktualizowania tekstury aparatu przez ARCore. Gdy to ustawienie ma wartość AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore udostępni obraz z kamery za pomocą AHardwareBuffer.

Skonfiguruj sesję do używania 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() zwraca błąd AR_ERROR_UNSUPPORTED_CONFIGURATION.

Pobieranie bufora sprzętowego

Gdy usługa AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER jest włączona, 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: 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 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 manifeście aplikacji do filtrowania na urządzeniach, które nie spełniają wymagań dotyczących sprzętu i oprogramowania. Urządzenia korzystające z Vulkan 1.0 mogą nie obsługiwać wymaganego rozszerzenia, ale zgodne z Vulkan 1.1 muszą mieć wymagane rozszerzenie na Androidzie 10 (poziom interfejsu API 29).