Rozpocznij

Z tego dokumentu dowiesz się, jak zacząć tworzyć aplikacje przy użyciu interfejsu Near Messages API na urządzeniu z Androidem. Interfejs Near Messages API jest częścią Usługi Google Play.

Krok 1. Pobierz Usługi Google Play

Interfejs Near Messages API jest dostępny na urządzeniach z Androidem Usługi Google Play Wersja 7.8.0 lub nowsza. Urządzenia z Androidem 2.3 lub nowszym, na których zainstalowano Aplikacja Sklep Play automatycznie otrzymuje aktualizacje Usług Google Play. Aby sprawdzić która wersja Usług Google Play jest zainstalowana na urządzeniu, wejdź na Ustawienia > Aplikacje > Usługi Google Play.

Upewnij się, że masz na urządzeniu najnowszą bibliotekę klienta Usług Google Play host programistyczny:

  1. Otwórz Menedżera pakietów SDK na Androida.

  2. W sekcji Wygląd i Zachowanie > Ustawienia systemu > SDK dla Androida > SDK Tools sprawdź, czy zainstalowane są następujące pakiety:

    • Usługi Google Play
    • Repozytorium Google

Krok 2. Załóż konto Google

Aby korzystać z interfejsów API Wiadomości w pobliżu, musisz mieć konto Google. Dzięki temu Ty, jako deweloper, możesz w kolejnym (użytkownicy nie muszą mieć konta Google). Jeśli masz już konto, nie musisz nic robić. Warto też oddzielne konto Google do celów testowych.

Krok 3. Uzyskaj klucz interfejsu API

Wykonaj te czynności, aby włączyć Google Messages API na Androida i uzyskać klucz interfejsu API:

  1. Przejdź do Google Developers Console.
  2. Utwórz lub wybierz projekt, w którym chcesz zarejestrować aplikację.
  3. Kliknij Dalej, aby włączyć interfejs API.
  4. Na stronie Dane logowania utwórz nowy klucz Androida (i ustaw interfejs API). Dane logowania).
    Uwaga: jeśli masz klucz Androida, możesz go użyć.
  5. W wyświetlonym oknie wpisz odcisk cyfrowy SHA-1 aplikacji. i nazwę pakietu. Na przykład: 
    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. Nowy klucz interfejsu Android API pojawi się na liście kluczy interfejsu API w projekcie. Klucz interfejsu API to ciąg znaków, na przykład: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Uzyskiwanie odcisku cyfrowego SHA1 certyfikatu

Aby utworzyć nowy klucz interfejsu API dla aplikacji na Androida, musisz mieć odcisk cyfrowy SHA1 certyfikatu używanego do podpisywania pliku APK. Wiadomości można tylko wymieniać między aplikacjami podpisanymi kluczami interfejsu API z tego samego projektu.

Aby uzyskać ten odcisk palca:

  1. Znajdź lokalizację swojego magazynu kluczy.
  2. W terminalu uruchom narzędzie keytool z pakietu JDK. Dla: na przykład jeśli używasz magazynu kluczy `debug`:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    Uwaga: w przypadku magazynu kluczy debugowania hasło to: android W systemach Mac OS i Linux magazyn kluczy debugowania jest zwykle znajduje się pod adresem ~/.android/debug.keystore. W systemie Windows zwykle znajduje się pod adresem %USERPROFILE%\.android\debug.keystore.

  3. Dane wyjściowe polecenia keytool zawierają SHA1 odcisk cyfrowy certyfikatu.
.

Krok 4. Skonfiguruj projekt

Android Studio sprawia, możesz łatwo utworzyć projekt dla interfejsu Near Messages API. Wykonaj opisane czynności. w artykule Tworzenie projektu. aby utworzyć nowy projekt. W Android Studio otwórz plik build.gradle aplikacji moduł i dodaj bibliotekę klienta Usług Google Play jako zależność:

apply plugin: 'android'
...

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

Następnie skonfiguruj plik manifestu za pomocą klucza interfejsu API wygenerowanego w poprzednim kroku:

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

Krok 5. Opublikuj i zasubskrybuj

W aplikacji zacznij korzystać z interfejsu Near 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();
}

Interfejs Near Messages API wymaga zgody użytkownika. Podczas publikowania lub subskrybowania funkcja W pobliżu wyświetli okno akceptacji.