Rozpocznij

Z tego dokumentu dowiesz się, jak zacząć tworzyć aplikacje na Androida za pomocą interfejsu Nearby Messages API. Interfejs Nearby Messages API jest częścią Usług Google Play.

Krok 1. Pobierz Usługi Google Play

Interfejs Nearby Messages API jest dostępny na urządzeniach z Androidem z Usługami Google Play w wersji 7.8.0 lub nowszej. Urządzenia z Androidem 2.3 lub nowszym, na których jest zainstalowana aplikacja Sklep Google Play, automatycznie otrzymują aktualizacje Usług Google Play. Aby sprawdzić, która wersja Usług Google Play jest zainstalowana na urządzeniu, otwórz Ustawienia > Aplikacje > Usługi Google Play.

Sprawdź, czy na komputerze deweloperskim masz najnowszą bibliotekę klienta Usług Google Play:

  1. Otwórz Menedżera pakietu Android SDK.

  2. W sekcji Wygląd i zachowanie > Ustawienia systemu > Android SDK > Narzędzia SDK sprawdź, czy zainstalowane są te pakiety:

    • Usługi Google Play
    • Google Repository

Krok 2. Załóż konto Google

Aby korzystać z interfejsów Nearby Messages API, musisz mieć konto Google. Dzięki temu w następnym kroku Ty, jako deweloper, możesz włączyć interfejs Nearby API (użytkownicy nie będą musieli mieć konta Google). Jeśli masz już konto, nie musisz nic więcej robić. Możesz też potrzebować osobnego konta Google do celów testowych.

Krok 3. Uzyskaj klucz interfejsu API

Aby włączyć interfejs Google Nearby Messages API na Androida i uzyskać klucz API, wykonaj te czynności:

  1. Otwórz 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 skonfiguruj dane logowania interfejsu API).
    Uwaga: jeśli masz już klucz Androida, możesz go użyć.
  5. W wyświetlonym oknie wpisz odcisk cyfrowy SHA-1 i nazwę pakietu aplikacji. 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 API na Androida pojawi się na liście kluczy interfejsu API w Twoim projekcie. Klucz interfejsu API to ciąg znaków, np.: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Uzyskiwanie odcisku cyfrowego SHA1 certyfikatu

Aby utworzyć nowy klucz interfejsu API dla aplikacji na Androida, potrzebujesz odcisku cyfrowego SHA1 certyfikatu, którego używasz do podpisywania pliku APK. Wymiana wiadomości może odbywać się tylko między aplikacjami podpisanymi kluczami interfejsu API z tego samego projektu.

Aby uzyskać ten odcisk:

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

    Uwaga: hasło magazynu kluczy debugowania to android. W systemach macOS i Linux magazyn kluczy debugowania zwykle znajduje się w ~/.android/debug.keystore. W systemie Windows zwykle znajduje się w lokalizacji %USERPROFILE%\.android\debug.keystore.

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

Krok 4. Skonfiguruj projekt

Android Studio ułatwia tworzenie projektu na potrzeby Nearby Messages API. Aby utworzyć nowy projekt, wykonaj czynności opisane w artykule Tworzenie projektu. W Android Studio otwórz plik build.gradle modułu 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

Zacznij używać w aplikacji interfejsu 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();
}

Interfejs Nearby Messages API wymaga zgody użytkownika. Gdy po raz pierwszy zostanie wywołana funkcja publikowania lub subskrybowania, Nearby wyświetli okno z prośbą o zgodę na korzystanie z tej funkcji.