Geospatial API と Cloud Anchors は Google Cloud でホストされる ARCore API。これらの機能を使用する場合、アプリケーションは 認証情報を使用して ARCore API サービスにアクセスします。
このクイックスタートでは、アプリケーションを設定して、 Google Cloud でホストされている ARCore API サービスと通信できます。
新しい Google Cloud プロジェクトを作成するか、既存のプロジェクトを使用する
既存のプロジェクトがある場合は、それを選択します。
既存の Google Cloud プロジェクトがない場合は、1 つ作成します。
ARCore API を有効にする
ARCore API を使用するには、プロジェクトで有効にする必要があります。
認証方法を設定する
Android アプリは、次の 2 つの方法で ARCore API と通信できます。 認証方法: キーレス認証(OAuth 2.0)です。 方法、API キー認証があります。
- キーレス認証では、アプリのパッケージ名と 署名鍵のフィンガープリントを 使用してアプリケーションを承認します
- API キーは、Google Cloud プロジェクトを識別する文字列です。API キーは、 これらはクライアントがアクセスできるため、一般的には安全とは見なされません。 ARCore API との通信には、キーなし認証の使用を検討してください。
キーレス
キーなし認証を使用してアプリを承認するには、OAuth 2.0 クライアントを作成します。 あります。
署名鍵のフィンガープリントを決定する
OAuth 2.0 クライアント ID は、アプリの署名鍵のフィンガープリントを使用して、 。
デバッグ用の署名フィンガープリントを取得する方法
プロジェクトを実行またはデバッグする際、Android SDK Tools は 生成されたデバッグ用証明書をアプリに含めることができます。
- Android Studio で Gradle ツールペインを開きます。
- project-name に移動します。>ToDo リスト >android。
- signingReport タスクを実行します。
- debug バリアントの 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 の署名に使用します。 この鍵は署名フィンガープリントに使用する必要があります。
- Google Play Console の [アプリ署名] ページで、[アプリ署名鍵の証明書] までスクロールします。
- SHA-1 証明書フィンガープリントを使用します。
OAuth 2.0 クライアント ID を作成する
前の手順の該当する署名鍵ごとに、OAuth 2.0 クライアント ID を Google Cloud プロジェクトの認証情報。
Google Cloud で、[認証情報] ページを開きます。
[認証情報を作成] をクリックし、メニューから [OAuth クライアント ID] を選択します。
以下の必須項目を入力します。
- アプリのタイプ: [Android] を選択します。
- Package name: AndroidManifest.xml で宣言されているパッケージ名を使用します。
- SHA-1 証明書フィンガープリント: 前の手順で取得したフィンガープリントを使用します。
[作成] をクリックします。
必要なライブラリを含める
- アプリの依存関係に
com.google.android.gms:play-services-auth:16+
を含めます。 コードの圧縮を使用している場合は、 これをアプリの
build.gradle
ファイルに追加します。buildTypes { release { ... proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } }
アプリの
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 キー
- Google Cloud で、[認証情報] ページを開きます。
認証情報 - [認証情報の作成] を選択し、メニューから [API キー] を選択します。
[API キーを作成しました] ダイアログに、新しく作成したキーの文字列が表示されます。 Android Studio で、新しい API キーをプロジェクトに追加します。API キーを
<meta-data>
要素<application>
AndroidManifest.xml
:<meta-data android:name="com.google.android.ar.API_KEY" android:value="API_KEY"/>
- API キーの制限に関するドキュメントを確認する して、API キーを保護します。
これで、アプリが API キーを使用するように構成されました。
次のステップ
認可を構成したら、以下を使用する ARCore 機能を確認してください。 説明します。