עיבוד אפליקציית AR באמצעות Vulkan ב-Android SDK (Kotlin/Java)

כשהערך של Config.TextureUpdateMode מוגדר כ-TextureUpdateMode.EXPOSE_HARDWARE_BUFFER, ARCore תספק מאגר נתונים לחומרה של Android כשמתבצעת קריאה ל-Session.update(). אפשר לקשר את מאגר החומרה הזה ל-VkImage של Vulkan.

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

תמיכה ברינדור של Vulkan מוצגת באפליקציית הדוגמה hello_ar_vulkan_c.

הפעלת מצב הפלט של מאגר החומרה

הערך של Config.TextureUpdateMode נקבע איך ARCore תעדכן את המרקם של המצלמה. כשהיא מוגדרת כ-TextureUpdateMode.EXPOSE_HARDWARE_BUFFER, ARCore מספקת את תמונת המצלמה דרך HardwareBuffer.

מגדירים את הסשן לשימוש ב-TextureUpdateMode.EXPOSE_HARDWARE_BUFFER:

Java

Config config = session.getConfig();
config.setTextureUpdateMode(Config.TextureUpdateMode.EXPOSE_HARDWARE_BUFFER);
session.configure(config);

Kotlin

session.configure(
  session.config.apply { textureUpdateMode = Config.TextureUpdateMode.EXPOSE_HARDWARE_BUFFER }
)

אחזור מאגר החומרה

כשהאפשרות TextureUpdateMode.EXPOSE_HARDWARE_BUFFER מופעלת, משתמשים ב-Frame.getHardwareBuffer() כדי לקבל את מאגר החומרה:

Java

try {
  HardwareBuffer buffer = frame.getHardwareBuffer();
  // Use the buffer object in your rendering.
} catch (NotYetAvailableException e) {
  // The hardware buffer is not ready yet.
}

Kotlin

try {
  val buffer = frame.hardwareBuffer
  // Use the buffer object in your rendering.
} catch (e: NotYetAvailableException) {
  // The hardware buffer is not ready yet.
}

שימוש במאגר החומרה במהלך העיבוד של 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).