Jetzt starten

In diesem Dokument wird beschrieben, wie Sie mit der Nearby Messages API auf Android-Geräten entwickeln. Die Nearby Messages API ist Teil der Google Play-Dienste.

Schritt 1: Google Play-Dienste installieren

Die Nearby Messages API ist auf Android-Geräten mit Google Play-Diensten 7.8.0 oder höher verfügbar. Geräte mit Android 2.3 oder höher, auf denen die Google Play Store App installiert ist, erhalten automatisch Updates für die Google Play-Dienste. Wenn Sie prüfen möchten, welche Version der Google Play-Dienste auf Ihrem Gerät installiert ist, rufen Sie Einstellungen > Apps > Google Play-Dienste auf.

Prüfen Sie, ob auf Ihrem Entwicklungshost die neueste Clientbibliothek für die Google Play-Dienste installiert ist:

  1. Öffnen Sie den Android SDK Manager.

  2. Prüfen Sie unter Darstellung und Verhalten > Systemeinstellungen > Android SDK > SDK-Tools, ob die folgenden Pakete installiert sind:

    • Google Play-Dienste
    • Google Repository

Schritt 2: Google-Konto erstellen

Für die Verwendung der Nearby Messages APIs benötigen Sie ein Google-Konto. So können Sie als Entwickler die Nearby API im nächsten Schritt aktivieren. Ihre Nutzer benötigen kein Google-Konto. Wenn Sie bereits ein solches Konto haben, sind Sie schon startklar. Für Testzwecke könnte ein separates Google-Konto sinnvoll sein.

Schritt 3: API-Schlüssel anfordern

So aktivieren Sie die Google Nearby Messages API für Android und rufen einen API-Schlüssel ab:

  1. Rufen Sie die Google Developers Console auf.
  2. Erstellen oder wählen Sie ein Projekt aus, mit dem Sie Ihre Anwendung registrieren möchten.
  3. Klicken Sie auf Weiter, um die API zu aktivieren.
  4. Erstellen Sie auf der Seite Anmeldedaten einen neuen Android-Schlüssel und legen Sie die API-Anmeldedaten fest.
    Hinweis: Wenn Sie bereits einen Android-Schlüssel haben, können Sie diesen verwenden.
  5. Geben Sie im angezeigten Dialogfeld den SHA-1-Fingerabdruck und den Paketnamen Ihrer App ein. Beispiel: 
    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. Der neue Android-API-Schlüssel wird in der Liste der API-Schlüssel für dein Projekt angezeigt. Ein API-Schlüssel ist eine Zeichenfolge, die in etwa so aussieht: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

SHA1-Fingerabdruck Ihres Zertifikats abrufen

Wenn Sie einen neuen API-Schlüssel für Ihre Android-App erstellen möchten, benötigen Sie den SHA1-Fingerabdruck des Zertifikats, mit dem Sie Ihr APK signieren. Nachrichten können nur zwischen Apps ausgetauscht werden, die mit API-Schlüsseln aus demselben Projekt signiert sind.

So rufen Sie diesen Fingerabdruck ab:

  1. Suchen Sie den Speicherort Ihres Schlüsselspeichers.
  2. Führen Sie in einem Terminal das Dienstprogramm keytool aus dem JDK aus. Wenn Sie beispielsweise den `debug`-Schlüsselspeicher verwenden:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    Hinweis:Das Passwort für den Debug-Keystore lautet android. Unter macOS und Linux befindet sich der Debug-Schlüsselspeicher normalerweise unter ~/.android/debug.keystore. Unter Windows befindet es sich normalerweise unter %USERPROFILE%\.android\debug.keystore.

  3. Die Ausgabe des Befehls keytool enthält den SHA1-Fingerabdruck für das Zertifikat.

Schritt 4: Projekt konfigurieren

Mit Android Studio können Sie ganz einfach ein Projekt für die Nearby Messages API erstellen. Folgen Sie der Anleitung unter Projekt erstellen, um ein neues Projekt zu erstellen. Öffnen Sie in Android Studio die Datei build.gradle für Ihr Modul und fügen Sie die Clientbibliothek der Google Play-Dienste als Abhängigkeit hinzu:

apply plugin: 'android'
...

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

Konfigurieren Sie dann Ihr Manifest mit dem im vorherigen Schritt generierten API-Schlüssel:

<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>

Schritt 5: Veröffentlichen und abonnieren

Verwenden Sie in Ihrer App die 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();
}

Für die Nearby Messages API ist die Einwilligung der Nutzer erforderlich. Wenn Sie „Veröffentlichen“ oder „Abonnieren“ zum ersten Mal aufrufen, wird in Nearby ein Dialogfeld zur Aktivierung angezeigt.