עיבוד אפליקציית 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

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

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

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

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

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