スタート ガイド

このドキュメントでは、Google Chat で Nearby Messages API を使って開発を行う方法について説明します Android。Nearby Messages API は Google Chat の Google Play 開発者サービス。

手順 1: Google Play 開発者サービスを入手する

Nearby Messages API は以下を搭載した Android デバイスで利用できます。 Google Play 開発者サービス 7.8.0 以降。Android 2.3 以降を搭載し、Google Play ストア アプリは、Google Play 開発者サービスのアップデートを自動的に受信します。確認するには デバイスにインストールされている Google Play 開発者サービスのバージョンを確認するには、 [設定] >アプリ >Google Play 開発者サービス。

Google Play 開発者サービスの最新のクライアント ライブラリが 開発ホスト：

  1. Android SDK Manager を開きます。

  2. [デザインと行動 >システム設定 >Android SDK >SDK Tools、 次のパッケージがインストールされていることを確認します。

    • Google Play 開発者サービス
    • Google リポジトリ

ステップ 2: Google アカウントを取得する

Nearby Messages API を使用するには Google アカウントが必要です。 これにより、デベロッパーは次の段階で Nearby API を有効にできるようになります。 ステップを実行します（ユーザーが Google アカウントを持っている必要はありません）。 すでにアカウントをお持ちの場合は、これで完了です。さらに、 テスト用に別の Google アカウントを作成します。

ステップ 3: API キーを取得する

次の手順に沿って Android 用 Google Nearby Messages API を有効にして、 API キー:

  1. <ph type="x-smartling-placeholder"></ph>に行く Google Developers Console をご覧ください。
  2. アプリケーションを登録するプロジェクトを作成または選択します。
  3. [続行] をクリックして API を有効にします。
  4. [認証情報] ページで新しい Android キーを作成し、API を設定します。 。
    注: 既存の Android キーがある場合は、そのキーを使用できます。
  5. 表示されるダイアログで、アプリの SHA-1 フィンガープリントを入力します。 パッケージ名があります次に例を示します。 
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.nearbyexample
  6. プロジェクトの API キーのリストに新しい Android API キーが表示されます。 API キーは次のような文字列です。 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

証明書の SHA1 フィンガープリントを取得する

Android アプリの新しい API キーを作成するには、SHA1 フィンガープリントが必要です 証明書の署名が必要です。メッセージのやり取りのみ可能です 同じプロジェクトの API キーで署名されたアプリ間でのやり取り。

このフィンガープリントを取得する手順は次のとおりです。

  1. キーストアの場所を確認します。
  2. ターミナルで、JDK から keytool ユーティリティを実行します。対象 たとえば、`debug` キーストアを使用している場合は、次のようにします。
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    注: デバッグ キーストアの場合、パスワードは android。Mac OS と Linux では、通常、デバッグ キーストアは ~/.android/debug.keystore にあります。Windows では、 通常は %USERPROFILE%\.android\debug.keystore にあります。

  3. keytool コマンドの出力には、SHA1 が含まれます。 フィンガープリントを作成します。
で確認できます。

ステップ 4: プロジェクトを構成する

Android Studio があれば、 Nearby Messages API のプロジェクトを簡単に作成できます。記載されている手順に沿って対応します。 プロジェクトの作成を 新しいプロジェクトを作成します。Android Studio で build.gradle ファイルを開き、 Google Play 開発者サービスのクライアント ライブラリを依存関係として追加します。

apply plugin: 'android'
...

dependencies {
    compile 'com.google.android.gms:play-services-nearby:19.3.0'
}

次に、前のステップで生成した API キーを使用してマニフェストを構成します。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.sample.app" >
    <application ...>
        <meta-data
            android:name="com.google.android.nearby.messages.API_KEY"
            android:value="API_KEY" />
        <activity>
        ...
        </activity>
    </application>
</manifest>

ステップ 5: 公開とサブスクライブする

アプリで Nearby Messages API の使用を開始します。

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mMessageListener = new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.d(TAG, "Found message: " + new String(message.getContent()));
        }

        @Override
        public void onLost(Message message) {
            Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
        }
    }

    mMessage = new Message("Hello World".getBytes());
}

@Override
public void onStart() {
    super.onStart();
    ...
    Nearby.getMessagesClient(this).publish(mMessage);
    Nearby.getMessagesClient(this).subscribe(mMessageListener);
}

@Override
public void onStop() {
    Nearby.getMessagesClient(this).unpublish(mMessage);
    Nearby.getMessagesClient(this).unsubscribe(mMessageListener);
    ...
    super.onStop();
}

Nearby Messages API にはユーザーの同意が必要です。公開またはサブスクライブの が最初に呼び出されると、Nearby はオプトイン ダイアログを表示します。