Erste Schritte

In diesem Dokument wird erläutert, wie Sie mit der Nearby Messages API auf Android Die Nearby Messages API ist Teil von Google Play-Dienste:

Schritt 1: Google Play-Dienste installieren

Die Nearby Messages API ist auf Android-Geräten mit Google Play-Dienste 7.8.0 oder höher. Geräte mit Android 2.3 oder höher, auf denen die Google Die Play Store App erhält automatisch Updates für die Google Play-Dienste. Zur Überprüfung welche Version der Google Play-Dienste auf deinem Gerät installiert ist, Einstellungen > Apps > Google Play-Dienste.

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

  1. Öffnen Sie den Android SDK Manager.

  2. Wählen Sie unter Darstellung & Verhalten > Systemeinstellungen > Android SDK > SDK-Tools stellen Sie sicher, dass die folgenden Pakete installiert sind:

    • Google Play-Dienste
    • Google-Repository

Schritt 2: Google-Konto erstellen

Wenn Sie die Nearby Messages APIs verwenden möchten, benötigen Sie ein Google-Konto. So können Sie als Entwickler die Nearby API im nächsten Schritt (Ihre Nutzer benötigen kein Google-Konto). Wenn Sie bereits ein solches Konto haben, sind Sie schon startklar. Sie können auch eine zu Testzwecken ein separates Google-Konto erstellen.

Schritt 3: API-Schlüssel anfordern

Führe die folgenden Schritte aus, um die Google Nearby Messages API für Android zu aktivieren und einen API-Schlüssel:

  1. Gehe zu Google Developers Console.
  2. Erstellen Sie ein Projekt oder wählen Sie ein Projekt aus, bei 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 fest. Anmeldedaten).
    Hinweis: Wenn Sie bereits einen Android-Schlüssel haben, können Sie diesen verwenden.
  5. Geben Sie im nächsten Dialogfeld den SHA-1-Fingerabdruck Ihrer App ein und den Paketnamen. Hier einige Beispiele: 
    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. Ihr neuer 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 des Zertifikats abrufen

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

So erhalten Sie diesen Fingerabdruck:

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

    Hinweis: Für den Schlüsselspeicher der Fehlerbehebung lautet das Passwort android Unter Mac OS und Linux ist der Keystore für die Fehlerbehebung in der Regel Adresse: ~/.android/debug.keystore. Unter Windows ist es befindet sich in der Regel hier: %USERPROFILE%\.android\debug.keystore.

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

Schritt 4: Projekt konfigurieren

Android Studio macht es möglich, einfach ein Projekt für die Nearby Messages API zu erstellen. Folgen Sie der Anleitung. in Projekt erstellen um ein neues Projekt zu erstellen. Öffnen Sie in Android Studio die Datei build.gradle für 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 API-Schlüssel, den Sie im vorherigen Schritt generiert haben:

<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 des Nutzers erforderlich. Beim Veröffentlichen oder Abonnieren aufgerufen wird, zeigt Nearby ein Dialogfeld zur Aktivierung an.