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

כשהערך של ArTextureUpdateMode מוגדר כ-AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore תספק מאגר נתונים לחומרה של 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 זמינה רק ברמות API של Android‏ 27 ואילך. בנוסף, המכשיר צריך לתמוך בתוסף VK_ANDROID_external_memory_android_hardware_buffer.

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

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