Quickstart: Pushmeldingen instellen in een notification hub

Artikel
08/15/2023

Azure Notification Hubs biedt een push-engine die gebruiksvriendelijk is en kan worden geschaald. Gebruik Notification Hubs om meldingen te verzenden naar elk platform (iOS, Android, Windows, Baidu) en vanaf elke mogelijke back-end (in de cloud of on-premises). Zie Wat is Azure Notification Hubs? voor meer informatie.

In deze quickstart gebruikt u de PNS-instellingen (Platform Notification System) in Notification Hubs om pushmeldingen in te stellen op meerdere platforms. In de quickstart ziet u de stappen die in de Azure Portal worden gezet. Google Firebase Cloud Messaging bevat instructies voor het gebruik van de Azure CLI.

Notitie

Zie Migratie van Google Firebase Cloud Messaging voor informatie over de afschaffing en migratiestappen voor Firebase Cloud Messaging.

Maak nu een notification hub als u dat nog niet hebt gedaan. Zie Een Azure notification hub maken met behulp van Azure Portal of Een Azure notification hub maken met behulp van de Azure-CLI voor meer informatie.

Apple Push Notification Service

Apple Push Notification Service (APNS) instellen:

Selecteer in de Azure Portal op de pagina Notification HubApple (APNS) in het menu aan de linkerkant.
Selecteer Certificaat of Token als Verificatiemodus.

a. Als u Certificaat selecteert:
- Selecteer het pictogram van het bestand en selecteer het .p12-bestand dat u wilt uploaden.
- Voer een wachtwoord in.
- Selecteer de modus Sandbox. Of selecteer de modus Productie als u pushmeldingen wilt verzenden naar gebruikers die uw app in de Store hebben gekocht.
b. Als u Token selecteert:
- Voer de waarden in voor sleutel-id, bundel-id, team-id en token.
- Selecteer de modus Sandbox. Of selecteer de modus Productie als u pushmeldingen wilt verzenden naar gebruikers die uw app in de Store hebben gekocht.

Zie Pushmeldingen verzenden naar iOS-apps met Azure Notification Hubs voor meer informatie.

Ga als volgt te werk om pushmeldingen in te stellen voor Google FCM:

Selecteer in de Azure Portal op de pagina Notification HubGoogle (GCM/FCM) in het menu aan de linkerkant.
Plak de API-sleutel voor het Google FCM-project dat u eerder hebt opgeslagen.
Selecteer Opslaan.

Als u deze stappen hebt voltooid, ziet u een waarschuwing die aangeeft dat de notification hub is bijgewerkt. De knop Opslaan kan niet worden gekozen.

U hebt de API-sleutel voor uw Google Firebase Cloud Messaging-project (FCM) nodig.

De omgeving voorbereiden op de Azure CLI

Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Quickstart voor Bash in Azure Cloud Shell voor meer informatie.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.
- Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht AZ login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.
- Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
- Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

Voor dit artikel is versie 2.0.67 of hoger van Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.

Pushmeldingen instellen voor Google FCM

Gebruik de opdrachtaz notification-hub credential gcm update om uw Google API-sleutel toe te voegen aan uw notification hub.

az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey

De Android-app heeft een verbindingsreeks nodig om verbinding te maken met de notification hub. Gebruik de opdracht az notification-hub authorization-rule list om het beschikbare toegangsbeleid weer te geven. Gebruik de opdracht az notification-hub authorization-rule list-keys om de verbindingsreeksen voor het toegangsbeleid te verkrijgen. Geef de primaryConnectionString of secondaryConnectionString in de --query-parameter op om de primaire verbindingsreeks rechtstreeks te verkrijgen.

#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

Gebruik de opdracht az notification-hub test-send om het verzenden van berichten naar de Android-app te testen.

#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\"}}"

Verkrijg Azure CLI-verwijzingen voor andere platforms met de opdracht az notification-hub credential.

Zie Pushmeldingen naar Android-apparaten verzenden met Firebase voor meer informatie over het verzenden van meldingen naar een Android-app.

Windows Push Notification Services

Windows Push Notification Services (WNS) instellen:

Selecteer in de Azure Portal op de pagina Notification HubWindows (WNS) in het menu aan de linkerkant.
Voer waarden in voor Pakket-SID en Beveiligingssleutel.
Selecteer Opslaan.

Zie Meldingen verzenden naar UWP-apps met Azure Notification Hubs voor meer informatie.

Microsoft Push Notification Service voor Windows Phone

Notitie

Microsoft Push Notification Service (MPNS) is afgeschaft en wordt niet meer ondersteund.

Ga als volgt te werk om Microsoft Push Notification Service (MPNS) voor Windows Phone in te stellen:

Selecteer in de Azure Portal op de pagina Notification HubWindows Phone (WNS) in het menu aan de linkerkant.
Niet-geverifieerde of geverifieerde pushmeldingen inschakelen:

a. Selecteer Niet-geverifieerde push inschakelen>Opslaan om niet-geverifieerde pushmeldingen in te schakelen.

b. Geverifieerde pushmeldingen inschakelen:
- Selecteer Certificaat uploaden op de werkbalk.
- Selecteer het pictogram van het bestand en selecteer vervolgens het certificaatbestand.
- Voer het wachtwoord voor het certificaat in.
- Selecteer OK.
- Selecteer Opslaan op de pagina Windows Phone (MPNS) .

Zie Pushmeldingen verzenden naar Windows Phone-apps met Azure Notification Hubs voor meer informatie.

Baidu (Android China)

Ga als volgt te werk om pushmeldingen in te stellen voor Baidu:

Selecteer in de Azure Portal op de pagina Notification HubBaidu (Android China) in het menu aan de linkerkant.
Voer de API-sleutel in die u via de Baidu-console hebt gekregen in het Baidu Cloud Push-project.
Voer de geheime sleutel in die u hebt gekregen via de Baidu-console, in het Baidu Cloud Push-project.
Selecteer Opslaan.

Als u deze stappen hebt voltooid, ziet u een waarschuwing die aangeeft dat de notification hub is bijgewerkt. De knop Opslaan kan niet worden gekozen.

Zie Aan de slag met Notification Hubs met behulp van Baidu voor meer informatie.

Volgende stappen

In deze quickstart hebt u geleerd hoe u instellingen voor platformmeldingensystemen kunt configureren voor een notification hub in de Azure Portal.

Zie deze zelfstudies voor meer informatie over het pushen van meldingen naar verschillende platforms: