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

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

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

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

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

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

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

تفعيل ARCore API

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

يُفضَّل الحصول على إذن بدون مفتاح، ولكن يتم أيضًا دعم تفويض مفتاح واجهة برمجة التطبيقات.

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

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

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

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

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

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

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

  3. اضبط عنصر اللعبة إضافات ARCore لاستخدام الإعدادات ARCoreExtensionsConfig. في لوحة التسلسل الهرمي، حدِّد موقع عنصر اللعبة إضافات ARCore الذي أنشأته عند إعداد إضافات ARCore في البداية، واربط حقل ضبط إضافات ARCore بالكائن القابل للبرمجة 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();
}

    اطّلِع على LocationService وثائق لمزيد من المعلومات.

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

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

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

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