Подписаться

Push-уведомления для Android

Есть два способа отправлять push-уведомления на устройство:

1. Отправка уведомлений реализована на вашем сервере (Рекомендуемый)

Вы можете прислать нам URL вашего сервера, на который с сервера LiveTex будут поступать вебхуки с сообщениями в формате JSON. Ваш сервер на основе полученных данных сможет отправить push-уведомление.

Плюсы такого подхода:

  • Безопасность. Вам не требуется передавать третьей стороне ключи и пароли для работы с уведомлениями для вашего приложения. 
  • Гибкость. Вы сами регулируете содержание уведомлений и контролируете их отправку.

Сервер LiveTex посылает вебхук при новом сообщении от оператора в том случае, если связь с приложением прервалась и приложение не восстанавливает соединение с сервером LiveTex заданное время. Из всех сообщений, которые были высланы оператором за время отведённое на восстановление соединения, в вебхуке будет только последнее сообщение. Для отображения в приложении всех сообщений, которые были отправлены, пока отсутствовало соединение, при возвращении на экран чата необходимо загрузить историю при помощи метода getHistory/messageHistory.

Отправляемые в JSON данные:

Поле Тип данных Обязательность Описание
version string + Строка, версия протокола (сейчас только 1) обязательно
platform string + "ios" | "android" - перечисление может быть либо ios либо android
to string + id устройства пользователя
text string - текст сообщения
url string - ссылка на файл

Возможные варианты комбинации text/url:

- задан text, не задан url - текстовое сообщение;
- не задан text, задан url - сообщение содержащее файл;
- задан text, задан url - отправлен файл с комментарием.

 

2. Отправка уведомлений с сервера LiveTex через Firebase Cloud Messaging.

Шаг 1: Подключите сервисы Google к вашему приложению

Если у вас уже есть проект в Firebase с подключенными уведомлениями, то вы можете перейти к следующему шагу.

Если пока еще нет, то откройте страницу консоли FCM и создайте новый проект:

Нажмите на “Добавить проект”, в открывшемся окне укажите название проекта, выберите родительский проект, если это предлагается, и нажмите “Продолжить”._________09-07-2020_131602.pngНа шаге 2 и 3 настройте Google Analytics для вашего проекта, если это требуется. Если такой необходимости нет, то на втором шаге отключите параметр “Включить Google Аналитику в этом проекте” и нажмите на появившуюся кнопку “Создать проект”. Если это будет необходимо, то включить аналитику вы сможете после создания.

_________09-07-2020_131910.png

Запустится процесс создания проекта, после завершения которого нажмите “Далее”, у вас откроется ваш проект. Прокрутите страницу вниз до раздела Cloud Messaging и нажмите на него:

_________09-07-2020_132301.png

На открывшейся странице нажмите на иконку Android:

_________09-07-2020_132444.png

Далее введите название вашего пакета Android и нажмите на “Зарегистрировать приложение”:

_________09-07-2020_134310.png

Шаг 2: Подключите клиент для приёма уведомлений

Нажмите на “Скачать google-services.json” для загрузки файла конфигурации. Вам необходимо разместить данный файл в в корневой каталог модуля вашего приложения:

_________09-07-2020_152343.png

Нажмите “Далее” и затем в build.gradle вашего приложения добавьте следующие строки для указания зависимостей:

dependencies {
    implementation 'com.google.firebase:firebase-messaging:20.+'
}

В нижней части вашего build.gradle, обязательно последней строкой, должно быть указано:

apply plugin: 'com.google.gms.google-services'

Вновь нажмите “Далее” и затем “Открыть консоль”.

Шаг 3: Передайте ваш Server key в LiveTex

Выберите в консоли настройки вашего проекта

_________09-07-2020_155655.png

И перейдите на вкладку Сервисные аккаунты. Если сервисный аккаунт ещё не создан, то нажмите Создать серверный аккаунт. Аккаунт будет создан автоматически. После создания сервисного аккаунта страница будет выглядеть так:

_________09-07-2020_155939.png

Если закрытый ключ ещё не создан, то нажмите “Создание закрытого ключа”. Появится модальное окно с информацией и кнопкой для подтверждения процесса создания ключа. После нажатия на кнопку “Создать ключ” браузер скачает файл с расширением .json, в котором будет содержаться закрытый ключ. Полученный файл необходимо отправить на почту support@livetex.ru, указав ваш ключ разработчика или идентификатор вашего аккаунта в Livetex.

После добавления ключа с нашей стороны сервер LiveTex сможет отправлять уведомления в подключенное в ваш Firebase-проект приложение.

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

Комментарии