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

Статья
06/30/2023

Центры уведомлений 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) в меню слева.
В разделе Режим проверки подлинности выберите Сертификат или Токен.

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

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

Чтобы настроить 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.

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

Примечание

Служба push-уведомлений (Майкрософт) (MPNS) устарела и больше не поддерживается.

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

На портале Azure на странице Центр уведомлений выберите Windows Phone (MPNS) в меню слева.
Включите push-уведомления с проверкой подлинности или без нее:

а. Чтобы включить push-уведомления без проверки подлинности, выберите Включить push-уведомления без проверки подлинности>Сохранить.

b. Чтобы включить push-уведомления с проверкой подлинности, сделайте следующее:
- На панели инструментов щелкните Отправка сертификата.
- Щелкните значок файла, а затем выберите файл сертификата.
- Введите пароль для сертификата.
- Щелкните ОК.
- На странице Windows Phone(MPNS) выберите Сохранить.

Дополнительные сведения см. в статье Руководство по отправке push-уведомлений в конкретные приложения Windows Phone с помощью Центров уведомлений Azure.

Baidu (Android China)

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

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

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

Дальнейшие действия

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

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

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