استخدام ARCore API على Google Cloud

اختَر نظامًا أساسيًا:

تستخدم ميزات ARCore، مثل واجهة برمجة التطبيقات الجغرافية المكانية وأداة تثبيت السحابة الإلكترونية، واجهة برمجة تطبيقات ARCore المستضافة على Google Cloud. عند استخدام هذه الميزات، يستخدم تطبيقك بيانات الاعتماد للوصول إلى خدمة ARCore API.

يصف دليل البدء السريع هذا كيفية إعداد تطبيقك لكي يتواصل مع خدمة ARCore API المستضافة على Google Cloud.

يمكنك إنشاء مشروع جديد على Google Cloud أو استخدام مشروع حالي.

إذا كان لديك مشروع حالي، اختَره.

الانتقال إلى أداة اختيار المشروع

إذا لم يكن لديك مشروع حالي على Google Cloud، أنشئ واحدًا.

إنشاء مشروع جديد

تفعيل ARCore API

لاستخدام ARCore API، عليك تفعيلها في مشروعك.

تفعيل ARCore API

إعداد طريقة تفويض

يمكن لتطبيق Android الاتصال بواجهة برمجة تطبيقات ARCore باستخدام طريقتين مختلفتين للمصادقة: الترخيص بدون مفتاح (OAuth 2.0)، وهو الطريقة المقترحة، وتفويض مفتاح واجهة برمجة التطبيقات:

  • يستخدم الترخيص بدون مفتاح مزيجًا من اسم حزمة التطبيق وبصمة مفتاح التوقيع للسماح لتطبيقك.
  • مفتاح واجهة برمجة التطبيقات هو سلسلة تحدِّد مشروع Google Cloud. لا تُعد مفاتيح واجهة برمجة التطبيقات آمنة بشكل عام حيث إنها عادةً ما يمكن للعملاء الوصول إليها. يمكنك استخدام التفويض بدون مفتاح للتواصل مع واجهة برمجة تطبيقات ARCore.

بدون مفتاح

للسماح لتطبيقك باستخدام المصادقة بدون مفاتيح، عليك إنشاء معرّفات عميل OAuth 2.0.

تحديد بصمات مفتاح التوقيع

يستخدم معرِّف عميل OAuth 2.0 الملف المرجعي لمفتاح توقيع تطبيقك للتعرّف على تطبيقك.

كيفية الحصول على بصمة توقيع تصحيح الأخطاء

عند تشغيل مشروعك أو تصحيح الأخطاء فيه، تُوقِّع أدوات SDK لنظام التشغيل Android تطبيقك تلقائيًا باستخدام شهادة تصحيح أخطاء تم إنشاؤها.

  • في "استوديو Android"، افتح لوحة أدوات Gradle.
  • انتقِل إلى project-name > "مهام Google" > android.
  • شغِّل المهمة signingReport.

  • انسخ الملف المرجعي لشهادة SHA-1 لصيغة تصحيح الأخطاء.

كيفية الحصول على بصمة إصبع للتوقيع من ملف تخزين

إذا كان لديك ملف تخزين مفاتيح، استخدِم الأداة المساعدة keytool لتحديد الملف المرجعي.

keytool -list -v -alias your-key-name -keystore path-to-production-keystore

بعد ذلك تطبع أداة keytool بصمة الإصبع على المحطة. مثال:

   Certificate fingerprint: SHA1: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09

كيفية الحصول على مفتاح توقيع تطبيقك من خلال ميزة "توقيع التطبيق" من Play

عند استخدام ميزة توقيع التطبيق من Play، تدير Google مفتاح توقيع تطبيقك وتستخدمه لتوقيع حِزم APK. يجب استخدام هذا المفتاح للبصمة الرقمية للتوقيع.

  1. في صفحة "توقيع التطبيق" في Google Play Console، انتقِل إلى شهادة مفتاح توقيع التطبيق.
  2. استخدِم الملف المرجعي لشهادة SHA-1.

إنشاء معرِّفات عملاء OAuth 2.0

لكل مفتاح توقيع سارٍ من الخطوات السابقة، أنشئ معرِّف عميل OAuth 2.0 في بيانات اعتماد مشروعك على Google Cloud.

  • في Google Cloud، افتح صفحة "بيانات الاعتماد".

    بيانات الاعتماد

  • انقر على إنشاء بيانات اعتماد، ثم اختَر معرِّف عميل OAuth من القائمة.

  • املأ الحقول المطلوبة على النحو التالي:

    • نوع التطبيق: اختر Android.
    • اسم الحزمة: استخدم اسم الحزمة كما هو موضح في ملف AndroidManifest.xml.
    • الملف المرجعي لشهادة SHA-1: استخدِم بصمة إصبع تم الحصول عليها في الخطوات السابقة.

  • اضغط على إنشاء.

تضمين المكتبات المطلوبة

  1. تضمين com.google.android.gms:play-services-auth:16+ في العناصر الاعتمادية لتطبيقك.

  2. إذا كنت تستخدم أسلوب تصغير الرموز، أضِفه إلى ملف build.gradle في تطبيقك:

    buildTypes {
  release {
    ...
    proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
  }
}

  3. أضِف ما يلي إلى ملف تطبيقك على proguard-rules.pro:

    -keep class com.google.android.gms.common.** { *; }
-keep class com.google.android.gms.location.** { *; }
-keep class com.google.android.gms.auth.** { *; }
-keep class com.google.android.gms.tasks.** { *; }

تم إعداد تطبيقك الآن لاستخدام المصادقة بدون مفتاح.

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

  1. في Google Cloud، افتح صفحة "بيانات الاعتماد".
    بيانات الاعتماد
  2. انقر على إنشاء بيانات اعتماد، ثم اختر مفتاح واجهة برمجة التطبيقات من القائمة.
    يعرض مربّع الحوار الذي تم إنشاؤه باستخدام مفتاح واجهة برمجة التطبيقات السلسلة التي تم إنشاؤها للمفتاح الذي أنشأته حديثًا.

  3. في "استوديو Android"، أضِف مفتاح واجهة برمجة التطبيقات الجديد إلى مشروعك. عليك تضمين مفتاح واجهة برمجة التطبيقات في عنصر <meta-data> في العنصر <application> في AndroidManifest.xml لتطبيقك:

    <meta-data
  android:name="com.google.android.ar.API_KEY"
  android:value="API_KEY"/>
  4. يمكنك الاطّلاع على المستندات الخاصة بالقيود المفروضة على مفتاح واجهة برمجة التطبيقات لتأمين مفتاح واجهة برمجة التطبيقات.

تم إعداد تطبيقك الآن لاستخدام مفاتيح واجهة برمجة التطبيقات.

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

بعد إعداد التفويض، يمكنك الاطّلاع على ميزات ARCore التالية التي تستخدمها: