از ARCore API در Google Cloud استفاده کنید

انتخاب پلتفرم: اندروید یونیتی (بنیاد واقعیت افزوده) iOS

ویژگی‌های ARCore مانند Geospatial API و Cloud Anchors از ARCore API میزبانی شده در Google Cloud استفاده می‌کنند. هنگام استفاده از این ویژگی‌ها، برنامه شما از اعتبارنامه‌ها برای دسترسی به سرویس ARCore API استفاده می‌کند.

این راهنمای سریع نحوه تنظیم برنامه شما را شرح می‌دهد تا بتواند با سرویس ARCore API میزبانی شده در Google Cloud ارتباط برقرار کند.

یک پروژه جدید Google Cloud ایجاد کنید یا از یک پروژه موجود استفاده کنید

اگر پروژه‌ای از قبل دارید، آن را انتخاب کنید.

به انتخابگر پروژه بروید

اگر پروژه Google Cloud ندارید، یکی ایجاد کنید.

ایجاد پروژه جدید

فعال کردن API ARCore

برای استفاده از API ARCore، باید آن را در پروژه خود فعال کنید.

فعال کردن API ARCore

یک روش مجوزدهی تنظیم کنید

یک برنامه اندروید می‌تواند با استفاده از دو روش مختلف احراز هویت با API ARCore ارتباط برقرار کند: احراز هویت بدون کلید (OAuth 2.0)، که روش پیشنهادی است، و احراز هویت با کلید API:

• احراز هویت بدون کلید از ترکیبی از نام بسته برنامه و اثر انگشت کلید امضا برای احراز هویت برنامه شما استفاده می‌کند.
• کلید API رشته‌ای است که یک پروژه Google Cloud را مشخص می‌کند. کلیدهای API معمولاً امن در نظر گرفته نمی‌شوند زیرا معمولاً برای کلاینت‌ها قابل دسترسی هستند. برای ارتباط با API ARCore، استفاده از احراز هویت بدون کلید را در نظر بگیرید.

بدون کلید

برای تأیید اعتبار برنامه خود با استفاده از احراز هویت بدون کلید ، شناسه‌های کلاینت OAuth 2.0 ایجاد کنید.

تعیین اثر انگشت کلید امضا

شناسه کلاینت OAuth 2.0 از اثر انگشت کلید امضای برنامه شما برای شناسایی برنامه‌تان استفاده می‌کند.

مهم: امضای برنامه با کلیدهای امضای مختلف امری رایج است. شما باید برای هر کلید امضایی که قصد استفاده از آن را دارید، یک شناسه کلاینت ایجاد کنید. معمولاً این یک کلید امضای اشکال‌زدایی و کلید(های) امضای انتشار است.

چگونه اثر انگشت امضای اشکال‌زدایی خود را به دست آورید

هنگام اجرا یا اشکال‌زدایی پروژه، ابزارهای Android SDK به طور خودکار برنامه شما را با یک گواهی اشکال‌زدایی تولید شده امضا می‌کنند.

• در اندروید استودیو، پنل ابزار Gradle را باز کنید.
• به مسیر project-name > Tasks > android بروید.
• وظیفه signingReport را اجرا کنید.

  

• اثر انگشت SHA-1 را برای نوع اشکال‌زدایی کپی کنید.

نحوه دریافت اثر انگشت امضا از یک فروشگاه کلید

اگر فایل keystore دارید، از ابزار 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 ، گوگل کلید امضای برنامه شما را مدیریت می‌کند و از آن برای امضای APK های شما استفاده می‌کند. این کلید باید برای اثر انگشت امضا استفاده شود.

1. در صفحه امضای برنامه در کنسول گوگل پلی، به گواهی کلید امضای برنامه بروید.
2. از اثر انگشت گواهی SHA-1 استفاده کنید.

ایجاد شناسه‌های کلاینت OAuth 2.0

برای هر کلید امضای قابل اجرا از مراحل قبلی، یک شناسه کلاینت OAuth 2.0 در اعتبارنامه‌های پروژه Google Cloud خود ایجاد کنید.

• در گوگل کلود، صفحه اعتبارنامه‌ها (Credentials) را باز کنید.

  مدارک تحصیلی

• روی ایجاد اعتبارنامه کلیک کنید، سپس شناسه کلاینت OAuth را از منو انتخاب کنید.

• فیلدهای مورد نیاز را به شرح زیر پر کنید:

  • نوع برنامه : اندروید را انتخاب کنید.
  • نام بسته : از نام بسته‌ای که در 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.** { *; }
   

اکنون برنامه شما برای استفاده از احراز هویت بدون کلید پیکربندی شده است.

کلید API

1. در گوگل کلود، صفحه اعتبارنامه‌ها (Credentials) را باز کنید.
   مدارک تحصیلی
2. روی ایجاد اعتبارنامه کلیک کنید، سپس کلید API را از منو انتخاب کنید.
   کادر محاوره‌ای ایجاد کلید API، رشته مربوط به کلید تازه ایجاد شده شما را نمایش می‌دهد.

3. در اندروید استودیو، کلید API جدید را به پروژه خود اضافه کنید. کلید API را در عنصر <meta-data> در عنصر <application> در فایل AndroidManifest.xml برنامه خود قرار دهید:

   <meta-data
     android:name="com.google.android.ar.API_KEY"
     android:value="API_KEY"/>
   

4. برای ایمن‌سازی کلید API خود ، مستندات مربوط به محدودیت‌های کلید API را بررسی کنید.

اکنون برنامه شما برای استفاده از کلیدهای API پیکربندی شده است.

قدم بعدی چیست؟

پس از پیکربندی مجوز، ویژگی‌های ARCore زیر را که از آن استفاده می‌کنند، بررسی کنید:

• API مکانی
• رابط برنامه‌نویسی کاربردی (API) انکر ابری