Jetzt starten

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

Schritt 1: Google Play-Dienste abrufen

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 und der Google Play Store App werden Updates für die Google Play-Dienste automatisch installiert. Wenn Sie prüfen möchten, welche Version der Google Play-Dienste auf Ihrem Gerät installiert ist, rufen Sie die Einstellungen > Apps > Google Play-Dienste auf.

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

  1. Öffnen Sie den Android SDK Manager.

  2. Prüfen Sie unter Appearance & Behavior > System Settings > 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 im nächsten Schritt die Nearby API 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. Wechseln Sie zur Google Developers Console.
  2. Erstellen oder wählen Sie ein Projekt aus, um Ihre Anwendung zu registrieren.
  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 Ihre 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 keytool-Dienstprogramm aus dem JDK aus. Wenn Sie beispielsweise den `debug` Schlüsselspeicher verwenden, gehen Sie so vor:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

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

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

Schritt 4: Projekt konfigurieren

Android Studio macht es einfach, ein Projekt für die Nearby Messages API zu 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 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 Nutzereinwilligung erforderlich. Wenn „Veröffentlichen“ oder „Abonnieren“ zum ersten Mal aufgerufen wird, wird in Nearby ein Dialogfeld zur Einwilligung angezeigt.