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

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

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

احرص على فهم مفاهيم الواقع المعزّز الأساسية وكيفية ضبط جلسة ARCore قبل المتابعة.

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

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

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

تفعيل واجهة برمجة تطبيقات ARCore

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

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

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

بعد تفويض تطبيقك للاتصال بواجهة برمجة التطبيقات ARCore API، عليك إضافة مكتبات ل تفعيل الميزات المكانية الجغرافية في تطبيقك.

  1. انتقِل إلى تعديل > إعدادات المشروع > إدارة مكوّنات إضافية لتكنولوجيا الواقع المعزّز (XR) > إضافات ARCore. تأكَّد من اختيار تفعيل ميزة "التوافق مع أجهزة iOS".
  2. ضمن الميزات الاختيارية، اختَر البيانات الجغرافية.

تفعيل الإمكانات الجغرافية المكانية في إعدادات الجلسة

بعد تفعيل الوظائف المتعلّقة بالموقع الجغرافي في تطبيقك، فعِّل إمكانات الموقع الجغرافي في إعداد جلسة الواقع المعزّز في تطبيقك حتى يتمكّن من التواصل مع واجهة برمجة التطبيقات ARCore API:

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

  2. اختَر العنصر القابل للبرمجة ARCoreExtensionsConfig في مجلد Assets (مواد العرض) واضبط وضع المساحة الجغرافية على مفعَّل.

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

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

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

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

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

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

لتفعيل خدمات تحديد الموقع الجغرافي في Unity في نص برمجي يؤدي إلى بدء وقت التشغيل طلبات الأذونات، اتّبِع الخطوات التالية:

  1. في Project Settings > iOS > Other Settings > Location Usage Description، أدخِل اسم التطبيق الذي يطلب الأذونات.

  2. فعِّل خدمات الموقع الجغرافي في Unity لبدء معالجة طلب إذن التشغيل ، على النحو التالي:

    public void OnEnable()
{
    Input.location.Start();
}

public void OnDisable()
{
    Input.location.Stop();
}

    يُرجى الاطّلاع على مستندات IDE IDE LocationService لمزيد من المعلومات.

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

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

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

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