تفعيل واجهة برمجة التطبيقات Geospatial API لتطبيق Unity (AR Foundation) الذي يستهدف Android

اضبط إعدادات تطبيقك ليتمكّن من استخدام Geospatial API.

المتطلبات الأساسية

قبل المتابعة، تأكد من فهم مفاهيم الواقع المعزّز الأساسية وكيفية ضبط جلسة ARCore.

راجِع مقدمة عن واجهة برمجة التطبيقات الجغرافية المكانية للحصول على مزيد من المعلومات حول واجهة برمجة التطبيقات الجيوفضائية.

إذا كنت حديث العهد بتطوير البرامج باستخدام ARCore، فراجع البدء للحصول على معلومات حول متطلبات البرامج والأجهزة والمتطلبات الأساسية والمعلومات الأخرى الخاصة بالأنظمة الأساسية التي تستخدمها.

لاستخدام واجهة برمجة التطبيقات ARCore Geospatial API، يجب أن يتوافق مشروعك مع AR Foundation وARCoreextensions for AR Foundation.

تفعيل ARCore API

قبل استخدام نظام تحديد المواقع المرئي (VPS) في تطبيقك، يجب أولاً تفعيل ARCore API في مشروع جديد أو حالي على Google Cloud. وهذه الخدمة مسؤولة عن استضافة علامات الارتساء الجيوفضائية وتخزينها وحلها.

ويُفضَّل استخدام التفويض بدون مفتاح، ولكن يمكن أيضًا استخدام تفويض مفتاح واجهة برمجة التطبيقات.

إضافة المكتبات المطلوبة إلى تطبيقك

بعد السماح لتطبيقك بطلب واجهة برمجة التطبيقات ARCore، يجب إضافة مكتبات لتفعيل الميزات الجيوفضائية في تطبيقك.

  1. انتقِل إلى Edit (تعديل) > Project Settings (إعدادات المشروع) > XR Plug-In Management (إدارة مكوّن XR الإضافي) > ARCore متوفّرة (إضافات ARCore).
  2. ضمن الميزات الاختيارية، اختَر الموقع الجغرافي.

تفعيل الإمكانات الجيوفضائية في إعداد الجلسة

بعد تفعيل الوظيفة الجيوفضائية في تطبيقك، يجب تفعيل الإمكانات الجيوفضائية في إعدادات جلسة الواقع المعزّز في تطبيقك ليتمكن التطبيق من التواصل مع ARCore API:

  1. تأكّد من أن مجلد Assets في المشروع يحتوي على عنصر النص البرمجي ARCoreExtensionsConfig. لإنشاء ملف شخصي، انقر بزر الماوس الأيمن في لوحة Assets (مواد العرض) واختَر Create (إنشاء) > XR > ARCoreextensions Config.

  2. اختر الكائن القابل للنص البرمجي ARCoreExtensionsConfig في مجلد مواد العرض واضبط الوضع الجغرافي المكاني على مفعّل.

  3. اضبط كائن اللعبة ARCoreextensions لاستخدام الإعداد ARCoreExtensionsConfig. في لوحة الهياكل، حدِّد موقع كائن اللعبة ARCore البحري الذي أنشأته عند ضبط إضافات ARCore في البداية، واربط حقل ضبط إضافات ARCore بالكائن القابل للبرمجة ARCoreExtensionsConfig في مجلد Assets.

طلب السماح باستخدام بيانات الجهاز

يجب أن تقدّم التطبيقات التي تستخدم واجهة برمجة التطبيقات ARCore Geospatial API للمستخدم رسالة تطلب منه الإقرار باستخدام البيانات من جهازه والسماح باستخدامه. راجع متطلبات خصوصية المستخدم للحصول على مزيد من المعلومات.

التحقّق من توافق الجهاز

لا تتيح بعض الأجهزة التي تتيح استخدام ARCore استخدام واجهة برمجة التطبيقات Geospatial API. للتحقّق من توافق جهاز المستخدم، يُرجى الاتصال بـ AREarthManager.IsGeospatialModeSupported(). إذا عرض هذا الإجراء FeatureSupported.Unsupported، لا تحاول ضبط الجلسة.

طلب أذونات تحديد الموقع الجغرافي في وقت التشغيل من المستخدم

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

التحقّق من مدى توفّر المواقع الجغرافية المكانية في الموقع الجغرافي الحالي للجهاز

بما أنّ واجهة برمجة التطبيقات Geospatial API تستخدم مزيجًا من VPS ونظام تحديد المواقع العالمي (GPS) لتحديد وضعية جيوفضائية، يمكن استخدام واجهة برمجة التطبيقات ما دام الجهاز قادرًا على تحديد موقعه الجغرافي. في المناطق ذات الدقة المنخفضة لنظام تحديد المواقع العالمي (GPS)، مثل المساحات الداخلية والبيئات الحضرية الكثيفة، ستعتمد واجهة برمجة التطبيقات على تغطية VPS لإنشاء وضعيات عالية الدقة. في ظل الظروف العادية، من المتوقع أن يوفر VPS دقة موضعية تبلغ 5 أمتار تقريبًا، ودقة دوران تبلغ 5 درجات. استخدِم AREarthManager.CheckVpsAvailability() لتحديد ما إذا كان موقع جغرافي معيّن تتوفّر فيه تغطية لبرنامج الشراء بالجملة (VPS).

يمكن أيضًا استخدام واجهة برمجة التطبيقات Geospatial API في المناطق التي لا تتوفر بها تغطية VPS. في البيئات الخارجية التي لا تحتوي على حواجز علوية أو بدونها، قد يكون نظام تحديد المواقع العالمي (GPS) كافيًا لإنشاء وضعية بدقة عالية.

الخطوات التالية