Начало работы

В этом документе объясняется, как начать разработку с помощью Nearby Messages API на Android. Nearby Messages API входит в состав сервисов Google Play.

Шаг 1. Установите сервисы Google Play

Nearby Messages API доступен на устройствах Android с сервисами Google Play версии 7.8.0 или более поздней. На устройствах с Android 2.3 и более поздними версиями, на которых установлено приложение Google Play, сервисы Google Play обновляются автоматически. Чтобы узнать, какая версия сервисов Google Play установлена на вашем устройстве, выберите Настройки > Приложения > Сервисы Google Play.

Убедитесь, что на хосте разработки установлена последняя версия клиентской библиотеки для сервисов Google Play.

  1. Откройте Android SDK Manager.
  2. В разделе Appearance & Behavior (Внешний вид и поведение) > System Settings (Системные настройки) > Android SDK > SDK Tools убедитесь, что установлены следующие пакеты:

    • Сервисы Google Play
    • Репозиторий Google

Шаг 2. Создайте аккаунт Google

Чтобы использовать Nearby Messages API, вам потребуется аккаунт Google. Это необходимо, чтобы вы, как разработчик, могли включить Nearby API на следующем шаге (вашим пользователям не потребуется аккаунт Google). Если он у вас уже есть, то этот шаг можно пропустить. Также возможно, что вам понадобится отдельный аккаунт Google для тестирования.

3. Получите ключ API

Чтобы включить Google Nearby Messages API для Android и получить ключ API, выполните следующие действия:

  1. Перейдите в Google Developers Console.
  2. Создайте или выберите проект, в котором будет зарегистрировано ваше приложение.
  3. Нажмите Continue (Продолжить), чтобы включить API.
  4. На странице Credentials (Учетные данные) создайте новый ключ Android и задайте для него учетные данные API.
    Примечание. Если у вас есть действующий ключ Android, можете использовать его.
  5. В открывшемся диалоговом окне введите цифровой отпечаток SHA-1 и название пакета приложения. Пример:
    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. Новый ключ API для Android появится в списке ключей API для вашего проекта. Ключ API представляет собой строку символов, которая выглядит примерно так:
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Получите цифровой отпечаток SHA1 своего сертификата

Чтобы создать ключ API для приложения Android, вам потребуется цифровой отпечаток SHA-1 сертификата, который вы используете для подписи APK. Обмен сообщениями возможен только между приложениями, подписанными ключами API из одного проекта.

Чтобы получить этот отпечаток, выполните следующие действия:

  1. Найдите хранилище ключей.
  2. В терминале запустите утилиту keytool из JDK. Например, если вы используете хранилище ключей `debug`:
  3. $ keytool -alias \
    androiddebugkey -keystore \
    ~/.android/debug.keystore -list -v
    

    Примечание. Пароль для хранилища ключей отладки – android. В macOS и Linux хранилище ключей отладки обычно находится в каталоге ~/.android/debug.keystore. В Windows он обычно находится в папке %USERPROFILE%\.android\debug.keystore.

  4. Выходные данные команды keytool содержат цифровой отпечаток SHA-1 для сертификата.

Шаг 4. Настройте проект

Android Studio позволяет легко создать проект для Nearby Messages API. Создайте проект, следуя инструкциям в статье Создание проекта. В Android Studio откройте файл build.gradle для своего модуля и добавьте клиентскую библиотеку сервисов Google Play в качестве зависимости:

apply plugin: 'android'
...

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

Затем настройте манифест, используя ключ API, созданный на предыдущем шаге.

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

Шаг 5. Публикация и подписка

Начните использовать 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();
}

Для работы Nearby Messages API требуется согласие пользователя. При первом вызове publish или subscribe Nearby покажет диалоговое окно с предложением включить функцию.