عرض تطبيق الواقع المعزّز باستخدام 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 على أجهزة غير متوافقة، سيتعذّر تطبيق 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، يمكنك الانتقال إلى vulkan_handler.cc.

الأجهزة المتوافقة

لا يتوفّر عرض Vulkan إلا على مستويات واجهة برمجة تطبيقات Android 27 والأعلى. بالإضافة إلى ذلك، يجب أن يكون الجهاز متوافقًا مع الإضافة VK_ANDROID_external_memory_android_hardware_buffer.

يجب توفُّر Vulkan في ملف بيان التطبيق.

يستخدم Google Play <uses-feature> المنصوص عليها في بيان التطبيق لفلترة تطبيقك حتى لا يستوفي متطلّبات ميزات الأجهزة والبرامج. قد لا تتوافق الأجهزة التي تستخدم Vulkan 1.0 مع الإضافة المطلوبة، ولكن يجب أن تتضمّن الأجهزة المتوافقة مع Vulkan 1.1 الإضافة المطلوبة بدايةً من الإصدار Android 10 (مستوى واجهة برمجة التطبيقات 29).