แสดงผลแอป AR โดยใช้ Vulkan บน Android NDK (C)

เมื่อตั้งค่า ArTextureUpdateMode เป็น AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER แล้ว ARCore จะให้ hardware buffer ของ Android เมื่อเรียกใช้ ArSession_update() บัฟเฟอร์ฮาร์ดแวร์นี้สามารถเชื่อมโยงกับ VkImage ของ Vulkan ได้

ดูตัวอย่างแอปพลิเคชัน

การสนับสนุนการแสดงผล Vulkan แสดงอยู่ในแอปตัวอย่าง hello_ar_vulkan_c

เปิดใช้โหมดเอาต์พุตบัฟเฟอร์ฮาร์ดแวร์

ArTextureUpdateMode ที่กําหนดค่าไว้จะกําหนดวิธีที่ ARCore จะอัปเดตพื้นผิวของกล้อง เมื่อตั้งค่าเป็น AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER แล้ว ARCore จะแสดงภาพจากกล้องผ่าน AHardwareBuffer

กำหนดค่าเซสชันให้ใช้ 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);

หมายเหตุ: เมื่อใช้ AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER ในอุปกรณ์ที่เข้ากันไม่ได้ ArSession_configure() จะดำเนินการไม่สำเร็จและแสดงผลเป็น AR_ERROR_UNSUPPORTED_CONFIGURATION

รับบัฟเฟอร์ฮาร์ดแวร์

เมื่อเปิดใช้ AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER ให้ใช้ ArFrame_getHardwareBuffer() เพื่อรับบัฟเฟอร์ฮาร์ดแวร์

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

หมายเหตุ: AHardwareBuffer นี้รับประกันว่าจะใช้ได้จนกว่าจะเรียกใช้ ArSession_update() อีกครั้งเท่านั้น หากต้องการใช้บัฟเฟอร์ฮาร์ดแวร์นอกเหนือจากนั้น เช่น สำหรับการเรนเดอร์ คุณต้องเรียกใช้ AHardwareBuffer_acquire() แล้วเรียกใช้ AHardwareBuffer_release() หลังจากที่เรนเดอร์เสร็จแล้ว

ใช้บัฟเฟอร์ฮาร์ดแวร์ระหว่างการแสดงผล Vulkan

ดูตัวอย่างวิธีแสดงผลแอปพลิเคชัน AR โดยใช้ Vulkan ได้ที่ vulkan_handler.cc

อุปกรณ์ที่รองรับ

การรองรับการแสดงผล Vulkan ใช้ได้ใน Android API ระดับ 27 ขึ้นไปเท่านั้น นอกจากนี้ อุปกรณ์ต้องรองรับส่วนขยาย VK_ANDROID_external_memory_android_hardware_buffer ด้วย

กำหนดให้ต้องใช้ Vulkan ในไฟล์ Manifest ของแอป

Google Play ใช้ <uses-feature> ที่ประกาศในไฟล์ Manifest ของแอปเพื่อกรองแอปของคุณออกจากอุปกรณ์ที่ไม่เป็นไปตามข้อกำหนดของฟีเจอร์ฮาร์ดแวร์และซอฟต์แวร์ อุปกรณ์ที่ใช้ Vulkan 1.0 อาจไม่รองรับส่วนขยายที่จำเป็น แต่อุปกรณ์ที่เข้ากันได้กับ Vulkan 1.1 ต้องมีส่วนขยายที่จำเป็นตั้งแต่ Android 10 (API ระดับ 29) เป็นต้นไป