اضبط إعدادات تطبيقك كي يتمكّن من استخدام Geospatial API.
المتطلبات الأساسية
احرص على فهم مفاهيم الواقع المعزّز الأساسية وكيفية ضبط جلسة ARCore قبل المتابعة.
اطّلِع على مقدمة عن واجهة برمجة التطبيقات Geospatial API للحصول على مزيد من المعلومات حول Geospatial API.
إذا كنت مبتدئًا في مجال التطوير باستخدام ARCore، يمكنك مراجعة البدء للحصول على معلومات حول متطلبات البرامج والأجهزة، والمتطلّبات الأساسية، والمعلومات الأخرى الخاصة بالأنظمة الأساسية التي تستخدمها.
لاستخدام واجهة برمجة التطبيقات ARCore Geospatial API، يجب أن يتيح مشروعك استخدام AR Foundation وإضافات ARCore لـ AR Foundation.
تفعيل ARCore API
قبل استخدام نظام تحديد الموقع البصري (VPS) في تطبيقك، عليك أولاً تفعيل ARCore API في مشروع جديد أو حالي على Google Cloud. هذه الخدمة مسؤولة عن استضافة علامات ارتساء الجغرافي المكاني وتخزينها وحلها.
يُفضَّل استخدام طريقة التفويض بدون مفتاح، ولكن يمكن أيضًا استخدام طريقة التفويض باستخدام مفتاح واجهة برمجة التطبيقات.
إضافة المكتبات المطلوبة إلى تطبيقك
بعد تفويض تطبيقك للاتصال بواجهة برمجة التطبيقات ARCore API، عليك إضافة مكتبات ل تفعيل الميزات المكانية الجغرافية في تطبيقك.
- انتقِل إلى تعديل > إعدادات المشروع > إدارة مكوّنات إضافية لتكنولوجيا الواقع المعزّز (XR) > إضافات ARCore.
- ضمن الميزات الاختيارية، اختَر المواقع الجغرافية.
تفعيل الإمكانات الجغرافية المكانية في إعدادات الجلسة
بعد تفعيل الوظيفة الجغرافية المكانية في تطبيقك، يمكنك تفعيل الإمكانات الجغرافية المكانية في إعدادات جلسة الواقع المعزّز في تطبيقك حتى تتمكّن من الاتصال بواجهة برمجة تطبيقات ARCore:
- تأكَّد من أنّ مجلد المشروع Assets يحتوي على عنصر ARCoreExtensionsConfig قابل للبرمجة لإنشاء ملف، انقر بزر الماوس الأيمن في لوحة مواد العرض واختَر إنشاء > الواقع المعزّز (XR) > إعدادات إضافات ARCore.
اختَر العنصر القابل للبرمجة ARCoreExtensionsConfig في مجلد Assets (مواد العرض) واضبط وضع المساحة الجغرافية على مفعَّل.
اضبط كائن لعبة ARCore Extensions لاستخدام الإعداد ARCoreExtensionsConfig. في لوحة التسلسل الهرمي، حدِّد موقع عنصر اللعبة إضافات ARCore الذي أنشأته عند إعداد إضافات ARCore في البداية، واربط حقل ضبط إضافات ARCore بالكائن القابل للنص البرمجي ARCoreExtensionsConfig في مجلد مواد العرض.
الطلب من المستخدم السماح باستخدام بيانات الجهاز
على التطبيقات التي تستخدم واجهة برمجة التطبيقات 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) كافيًا لإنشاء وضعية بدقة عالية.
الخطوات التالية
- احصل على الوضع الجغرافي المكاني لكاميرا الجهاز لتحديد الموقع الجغرافي الدقيق لجهاز المستخدم في العالم الفعلي.
- التحقّق من توفّر الخادم الظاهري في الموقع الجغرافي المحدّد للجهاز