Краткое руководство. Настройка push-уведомлений в центре уведомлений

Статья
12/14/2024

Центры уведомлений Azure предоставляют обработчик push-уведомлений, который легко использовать и масштабируется. Используйте Центры уведомлений для отправки уведомлений на любую платформу (iOS, Android, Windows, Baidu) и из любой серверной части (облачной или локальной). Дополнительные сведения см. в статье Что такое Центры уведомлений Azure?.

В этом кратком руководстве вы используете параметры системы отправки уведомлений платформы (PNS) в Центрах уведомлений для настройки push-уведомлений для нескольких платформ. Здесь описаны действия, которые необходимо выполнить на портале Azure. Раздел Google Firebase Cloud Messaging содержит инструкции по использованию Azure CLI.

Примечание.

Сведения об отмене и миграции Firebase Cloud Messaging см. в статье о миграции Google Firebase Cloud Messaging.

Если вы еще не создали центр уведомлений, сделайте это сейчас. Дополнительные сведения см. в кратких руководствах по созданию центра уведомлений Azure с помощью портала Azure и Azure CLI.

Служба push-уведомлений Apple

Чтобы настроить Службу push-уведомлений Apple (APNS), сделайте следующее:

На портале Azure на странице Центр уведомлений выберите Apple (APNS) в меню слева.
В разделе Режим проверки подлинности выберите Сертификат или Токен.

a. Если вы выбрали Сертификат:
- Щелкните значок файла и выберите файл .p12, который нужно отправить.
- Введите пароль.
- Выберите режим Песочница. Если нужно отправлять push-уведомления пользователям, которые приобрели приложение в магазине, выберите режим Рабочий.
  
  b. Если вы выбрали Токен:
- Введите значения для параметров Идентификатор ключа, Идентификатор набора, Идентификатор команды и Токен.
- Выберите режим Песочница. Если нужно отправлять push-уведомления пользователям, которые приобрели приложение в магазине, выберите режим Рабочий.

См. статью Руководство. Отправка push-уведомлений в приложения iOS с помощью Центров уведомлений Azure.

Google Firebase Cloud Messaging версии 1 (FCMv1)

Чтобы настроить push-уведомления для Google FCMv1, выполните приведенные действия.

В портал Azure на странице Центра уведомлений выберите Google (FCMv1) в меню слева.
Обновите значения закрытого ключа, идентификатора проекта и электронной почты клиента из JSON-файла учетной записи службы, полученного из консоли Firebase.
Выберите Сохранить.

Снимок экрана: настройка центров уведомлений для Google FCMv1.

Когда вы выполните эти шаги, появится оповещение о том, что Центр уведомлений успешно обновлен. Кнопка Сохранить отключена.

Google Firebase Cloud Messaging (FCM)

Примечание.

Firebase Cloud Messaging (FCM) устарел и больше не поддерживается.

Портал
Azure CLI

Чтобы настроить push-уведомления для Google FCM:

На портале Azure на странице Центр уведомлений выберите Google (GCM/FCM) в меню слева.
В соответствующее поле вставьте ключ API для проекта Google FCM, сохраненного ранее.
Выберите Сохранить.

Вам понадобится ключ API для проекта Google Firebase Cloud Messaging (FCM).

Подготовка среды к работе с Azure CLI

Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.
Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.
- Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.
- Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.
- Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

Для работы с этой статьей требуется Azure CLI версии 2.0.67 или более поздней. Если вы используете Azure Cloud Shell, последняя версия уже установлена.

Настройка push-уведомлений для Google FCM

Чтобы добавить ключ API Google в центр уведомлений, используйте команду az notification-hub credential gcm update.
```
az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey
```
Для подключения к центру уведомлений приложению Android нужна строка подключения. Чтобы получить список доступных политик доступа, используйте команду az notification-hub authorization-rule list. Чтобы получить строки подключения к политике доступа, используйте команду az notification-hub authorization-rule list-keys. Чтобы получить непосредственно основную строку подключения, укажите primaryConnectionString или secondaryConnectionString в параметре --query.
```
#list access policies for a notification hub
az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table

#list keys and connection strings for a notification hub access policy
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json

#get the primaryConnectionString for an access policy
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString
```

Чтобы протестировать отправку сообщений в приложение Android, используйте команду az notification-hub test-send.

#test with message body
az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"

#test with JSON string
az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"

Получите ссылки на Azure CLI для других платформ с помощью команды az notification-hub credential.

Дополнительные сведения об отправке уведомлений в приложение Android с помощью Firebase см. в этом руководстве.

Служба push-уведомлений Windows

Чтобы настроить службу push-уведомлений Windows (WNS), сделайте следующее:

На портале Azure на странице Центр уведомлений выберите Windows (WNS) в меню слева.
Введите значения для идентификатора безопасности пакета и ключа безопасности.
Выберите Сохранить.

Дополнительные сведения см. в статье Руководство по отправке уведомлений в приложения универсальной платформы Windows с использованием Центров уведомлений Azure.

Baidu (Android China)

Чтобы настроить push-уведомления для Baidu, сделайте следующее:

На портале Azure на странице Центр уведомлений выберите Baidu (Android China) в меню слева.
В соответствующее поле введите ключ API, полученный в консоли Baidu в проекте службы push-уведомлений облака Baidu.
Введите секретный ключ, полученный из консоли Baidu в проекте службы push-уведомлений облака Baidu.
Выберите Сохранить.

Дополнительные сведения см. в статье Начало работы с Центрами уведомлений с помощью Baidu.

Следующие шаги

В этом кратком руководстве вы узнали, как настроить параметры системы отправки уведомлений платформы для центра уведомлений на портале Azure.

Дополнительные сведения о том, как отправлять push-уведомления на различные платформы, см. в следующих учебниках:

Поделиться через