עיבוד אפליקציית AR באמצעות Vulkan ב-Android NDK (C)

כשהערך בשדה ArTextureUpdateMode מוגדר כ-AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore יספק מאגר אחסון לחומרה של Android כשהקריאה ל-ArSession_update() מתבצעת. אפשר לאגד את מאגר הנתונים הזמני של החומרה ל-Vulkan VkImage.

לצפייה באפליקציה לדוגמה

תמיכה ברינדור 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 מופעלת, משתמשים ב-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;
}

שימוש במאגר הנתונים הזמני של החומרה במהלך רינדור Vulkan

ב-vulkan_handler.cc מוצגת דוגמה לעיבוד של אפליקציית AR באמצעות Vulkan.

מכשירים נתמכים

תמיכה ברינדור Vulkan זמינה רק ברמות API 27 ומעלה ב-Android. בנוסף, המכשיר צריך לתמוך בתוסף VK_ANDROID_external_memory_android_hardware_buffer.

נדרש Vulkan במניפסט של האפליקציה

ב-Google Play נעשה שימוש בערך <uses-feature> שהוצהר בקובץ המניפסט של האפליקציה, כדי לסנן את האפליקציה ממכשירים שלא עומדים בדרישות של תכונות החומרה והתוכנה. יכול להיות שמכשירים שמשתמשים ב-Vulkan 1.0 לא יתמכו בתוסף הנדרש, אבל מכשירים שתואמים ל-Vulkan 1.1 חייבים להתקין את התוסף הנדרש החל מ-Android 10 (רמת API 29).