Jetzt starten

In diesem Dokument wird beschrieben, wie Sie mit der Entwicklung mit der Nearby Messages API unter Android beginnen. 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. Auf Geräten mit Android 2.3 oder höher, auf denen die Google Play Store App installiert ist, werden die Google Play-Dienste automatisch aktualisiert. Wenn Sie herausfinden möchten, welche Version der Google Play-Dienste auf Ihrem Gerät installiert ist, rufen Sie die Einstellungen > Apps > Google Play-Dienste auf.

Achten Sie darauf, dass auf Ihrem Entwicklungshost die aktuelle Clientbibliothek für Google Play-Dienste installiert ist:

  1. Öffnen Sie den Android SDK Manager.

  2. Achte darauf, dass unter Darstellung und Verhalten > Systemeinstellungen > Android SDK > SDK-Tools 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 Ihr 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 erhalten Sie diesen Fingerabdruck:

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

    Hinweis:Das Passwort für den Debug-Keystore ist android. Unter Mac OS und Linux befindet sich der Schlüsselspeicher für die Fehlerbehebung normalerweise unter ~/.android/debug.keystore. Unter Windows befindet sich die Datei 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 Google Play-Dienste-Clientbibliothek 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 API-Schlüssel, der im vorherigen Schritt generiert wurde:

<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 die Nearby Messages API in Ihrer App.

@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 des Nutzers erforderlich. Wenn „publish“ oder „subscribe“ zum ersten Mal aufgerufen wird, wird in Nearby ein Dialogfeld zur Einwilligung angezeigt.