أدلة خاصة بالمنصة
Android (Kotlin/Java)
Android NDK (C)
Unity (AR Foundation)
Unreal Engine

تتطلّب معظم تجارب الواقع المعزّز أن يكون المستخدمون في مكان معيّن وفي وقت معيّن، وأن يضبطوا هواتفهم على وضع الواقع المعزّز الخاص ويفتحوا تطبيقًا للواقع المعزّز. على سبيل المثال، إذا أراد مستخدم معرفة كيف ستبدو أريكة في الواقع المعزّز في غرفة المعيشة، عليه "وضع" الأريكة في البيئة المعروضة على الشاشة بينما يكون في الغرفة.
تتجاهل واجهة برمجة التطبيقات Recording and Playback API شرط "الوقت الفعلي"، ما يتيح لك إنشاء تجارب واقع معزّز يمكن مشاهدتها في أي مكان وفي أي وقت. تخزّن Recording API بث الفيديو من الكاميرا أو بيانات وحدة القياس بالقصور الذاتي (IMU) أو أي بيانات وصفية مخصّصة أخرى تختار حفظها في ملف MP4. يمكنك بعد ذلك إدخال هذه الفيديوهات المسجّلة إلى ARCore من خلال Playback API، الذي سيتعامل مع ملف MP4 تمامًا مثل خلاصة جلسة مباشرة. سيظل بإمكانك استخدام جلسة كاميرا مباشرة، ولكن باستخدام واجهة برمجة التطبيقات الجديدة هذه، يمكن لتطبيقات الواقع المعزّز اختيار استخدام ملف MP4 مسجّل مسبقًا بدلاً من الجلسة المباشرة.

يمكن للمستخدمين النهائيين أيضًا الاستفادة من هذه الميزة. وبغض النظر عن مكانهم في الحياة الواقعية، يمكنهم عرض أي فيديو تم تسجيله باستخدام Recording and Playback API من معرض الصور والفيديوهات الأصلي وتعديل كائنات الواقع المعزّز والتأثيرات والفلاتر أو تشغيلها. باستخدام هذه الميزة، يمكن للمستخدمين التسوّق باستخدام الواقع المعزّز أثناء التنقّل في القطار إلى المكتب أو الاسترخاء في السرير.
حالات استخدام تطوير التطبيقات باستخدام Recording and Playback API
تزيل واجهة برمجة التطبيقات Recording and Playback API القيود المتعلقة بالوقت والمساحة عند إنشاء تطبيقات الواقع المعزّز. في ما يلي بعض الطرق التي يمكنك استخدامها في مشاريعك الخاصة.
التسجيل مرة واحدة والاختبار في أي مكان
بدلاً من الانتقال إلى موقع جغرافي في كل مرة تحتاج فيها إلى تجربة إحدى ميزات الواقع المعزّز، يمكنك تسجيل فيديو باستخدام Recording API ثم إعادة تشغيله باستخدام أي جهاز متوافق. هل تريد إنشاء تجربة في مركز تسوّق؟ ولن تحتاج إلى الانتقال إلى هناك في كل مرة تريد فيها اختبار تغيير. ما عليك سوى تسجيل زيارتك مرة واحدة ثم تكرارها وتطويرها وأنت جالس على مكتبك.
تقليل وقت التكرار
بدلاً من تسجيل فيديو لكل جهاز Android تريد توفير الدعم له، ولكل سيناريو تريد اختباره، يمكنك تسجيل الفيديو مرة واحدة وتشغيله على عدة أجهزة مختلفة أثناء مرحلة التكرار.
تقليل عبء الاختبار اليدوي على فِرق التطوير
بدلاً من إنشاء مجموعات بيانات مخصّصة لكل ميزة جديدة، يمكنك الاستفادة من مجموعات البيانات المسجّلة مسبقًا عند إطلاق ميزات جديدة تتضمّن بيانات العمق أو أحدث تحسينات التتبُّع من ARCore.
توافق الجهاز
ستحتاج إلى ARCore لتسجيل البيانات باستخدام واجهة برمجة التطبيقات Recording and Playback API، ولكنّك لن تحتاج إليها لتشغيل المحتوى. إنّ ملفات MP4 المسجّلة باستخدام هذه الميزة هي في الأساس ملفات فيديو تتضمّن بيانات إضافية يمكن عرضها باستخدام أي مشغّل فيديو. يمكنك فحصها باستخدام ExoPlayer من Android أو أي مشغّل متوافق يمكنه إزالة تشفير ملفات MP4 وإدارة البيانات الإضافية التي يضيفها ARCore.
طريقة تسجيل بيانات الفيديو والواقع المعزّز لتشغيلها
يحفظ ARCore الجلسات المسجّلة في ملفات MP4 على جهاز الاختبار. تحتوي هذه الملفات على مقاطع فيديو متعددة وبيانات متنوعة أخرى. بعد حفظ هذه الجلسات، يمكنك توجيه تطبيقك لاستخدام هذه البيانات بدلاً من جلسة كاميرا مباشرة.
ما الذي يتضمّنه التسجيل؟
تسجّل ARCore البيانات التالية في فيديو H.264. يمكنك الوصول إلى هذا الملف على أي مشغّل فيديو متوافق مع MP4 ويمكنه تبديل المقاطع الصوتية. يظهر مسار الفيديو بأعلى دقة في أول القائمة لأنّ بعض مشغّلات الفيديو المتوافقة مع MP4 تشغّل تلقائيًا مسار الفيديو الأول في القائمة بدون أن تتيح لك اختيار مسار الفيديو الذي تريد تشغيله.
المقطع الصوتي الأساسي للفيديو (مقطع صورة وحدة المعالجة المركزية)
يسجّل ملف الفيديو الأساسي البيئة أو المشهد لتشغيله لاحقًا. بشكل تلقائي، يسجّل ARCore صورة وحدة المعالجة المركزية (CPU) بدقة 640x480 (VGA) المستخدَمة في تتبُّع الحركة كبث الفيديو الأساسي.
لا يلتقط ARCore نسيج وحدة معالجة الرسومات (عالي الدقة) الذي يتم عرضه على الشاشة كصورة من كاميرا العرض المباشر.
إذا أردت توفير بث صور عالي الدقة أثناء التشغيل، عليك ضبط كاميرا توفّر صورة وحدة معالجة مركزية بالدقة المطلوبة. في هذه الحالة:
- سيطلب ARCore صورة وحدة المعالجة المركزية بدقة 640x480 (VGA) اللازمة لتتبُّع الحركة، بالإضافة إلى صورة وحدة المعالجة المركزية عالية الدقة التي تم تحديدها في إعدادات الكاميرا.
- قد يؤثر تسجيل بث صور وحدة المعالجة المركزية الثانية في أداء التطبيق، وقد تتأثر الأجهزة المختلفة بشكل مختلف.
- أثناء التشغيل، سيستخدم ARCore صورة وحدة المعالجة المركزية العالية الدقة التي تم التقاطها أثناء التسجيل كنسيج وحدة معالجة الرسومات أثناء التشغيل.
- ستصبح صورة وحدة المعالجة المركزية العالية الدقة هي بث الفيديو التلقائي في تسجيل MP4.
يحدّد إعداد الكاميرا المحدّد أثناء التسجيل صورة وحدة المعالجة المركزية (CPU) وتدفّق الفيديو الأساسي في التسجيل. إذا لم تحدّد إعدادات كاميرا تتضمّن صورة وحدة معالجة مركزية عالية الدقة، سيكون هذا الفيديو هو المقطع الصوتي الأول في الملف وسيتم تشغيله تلقائيًا، بغض النظر عن مشغّل الفيديو الذي تستخدمه.
عرض خريطة عمق الكاميرا
هذا هو ملف فيديو يمثّل خريطة العمق التي تسجّلها الكاميرا من مستشعر العمق المضمّن في الجهاز، مثل مستشعر قياس الوقت اللازم للوصول (ToF)، ويتم تحويله إلى قيم قنوات RGB. يجب استخدام هذا الفيديو لأغراض المعاينة فقط.
أحداث طلبات البيانات من واجهة برمجة التطبيقات
تسجّل ARCore القياسات من أجهزة استشعار الجيروسكوب ومقياس التسارع في الجهاز. تسجّل هذه الميزة أيضًا بيانات أخرى، بعضها قد يكون حسّاسًا:
- إصدارات تنسيق مجموعة البيانات
- إصدار حزمة تطوير البرامج (SDK) في ARCore
- إصدار "خدمات Google Play للواقع المعزّز"
- بصمة الإصبع للجهاز (ناتج
adb shell getprop ro.build.fingerprint) - معلومات إضافية حول أجهزة الاستشعار المستخدَمة لتتبُّع الواقع المعزّز
- عند استخدام ARCore Geospatial API، يتم جمع بيانات الموقع الجغرافي المقدَّر للجهاز وقراءات مقياس المغناطيسية وقراءات البوصلة