Snabbstart: Konfigurera push-meddelanden i en meddelandehubb

Artikel
08/15/2023

Azure Notification Hubs tillhandahåller en push-motor som är enkel att använda och som skalar ut. Använd Notification Hubs för att skicka meddelanden till valfri plattform (iOS, Android, Windows, Baidu) och från valfri serverdel (moln eller lokalt). Mer information finns i Vad är Azure Notification Hubs?.

I den här snabbstarten använder du PNS-inställningarna (Platform Notification System) i Notification Hubs för att konfigurera push-meddelanden på flera plattformar. Snabbstarten visar de steg som ska utföras i Azure Portal. Google Firebase Cloud Messaging innehåller instruktioner för att använda Azure CLI.

Anteckning

Information om utfasnings- och migreringssteg för Firebase Cloud Messaging finns i Google Firebase Cloud Messaging-migrering.

Om du inte redan har skapat en meddelandehubb skapar du en nu. Mer information finns i Skapa en Azure-meddelandehubb i Azure Portal eller Skapa en Azure-meddelandehubb med hjälp av Azure CLI.

Apple Push Notification Service

Så här konfigurerar du Apple Push Notification Service (APNS):

I Azure Portal går du till sidan Notification Huboch väljer Apple (APNS) på den vänstra menyn.
För Autentiseringsläge väljer du antingen Certifikat eller Token.

a. Om du väljer Certifikat:
- Välj filikonen och välj sedan den .p12-fil som du vill ladda upp.
- Ange ett lösenord.
- Välj Sandbox-läge. Om du vill skicka push-meddelanden till användare som har köpt din app från butiken väljer du Produktionsläge .
b. Om du väljer Token:
- Ange värdena för nyckel-ID, paket-ID, team-ID och token.
- Välj Sandbox-läge. Om du vill skicka push-meddelanden till användare som har köpt din app från butiken väljer du Produktionsläge .

Mer information finns i Skicka push-meddelanden till iOS-appar med Azure Notification Hubs.

Så här konfigurerar du push-meddelanden för Google FCM:

I Azure Portal går du till sidan Notification Huboch väljer Google (GCM/FCM) på den vänstra menyn.
Klistra in API-nyckeln för Google FCM-projektet som du sparade tidigare.
Välj Spara.

När du slutför de här stegen anger en avisering att meddelandehubben har uppdaterats. Knappen Spara är inaktiverad.

Du behöver API-nyckeln för projektet Google Firebase Cloud Messaging (FCM).

Förbereda din miljö för Azure CLI

Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
- När du uppmanas att göra det installerar du Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.
- Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Den här artikeln kräver version 2.0.67 eller senare av Azure CLI. Om du använder Azure Cloud Shell är den senaste versionen redan installerad.

Konfigurera push-meddelanden för Google FCM

Använd kommandot az notification-hub credential gcm update för att lägga till din Google API-nyckel i meddelandehubben.

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

Android-appen behöver en anslutningssträng för att ansluta till meddelandehubben. Använd kommandot az notification-hub authorization-rule list för att visa en lista över tillgängliga åtkomstprinciper. Använd kommandot az notification-hub authorization-rule list-keys för att hämta anslutningssträngarna för åtkomstprincipen. Ange primaryConnectionString eller secondaryConnectionString i parametern --query för att hämta den primära anslutningssträngen direkt.

#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

Använd kommandot az notification-hub test-send för att testa att skicka meddelanden till Android-appen.

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

Hämta Azure CLI-referenser för andra plattformar med kommandot az notification-hub credential .

Mer information om hur du skickar meddelanden till ett Android-program finns i Skicka push-meddelanden till Android-enheter med Firebase.

Windows Push Notification Service

Så här konfigurerar du Windows Push Notification Service (WNS):

I Azure Portal går du till sidan Notification Huboch väljer Windows (WNS) på den vänstra menyn.
Ange värden för Package SID (Paket-SID) och Security Key (Säkerhetsnyckel).
Välj Spara.

Mer information finns i Skicka meddelanden till UWP-appar med hjälp av Azure Notification Hubs.

Microsoft Push Notification Service för Windows Phone

Anteckning

Microsoft Push Notification Service (MPNS) har blivit inaktuell och stöds inte längre.

Så här konfigurerar du Microsoft Push Notification Service (MPNS) för Windows Phone:

I Azure Portal går du till sidan Notification Hub och väljer Windows Phone (MPNS) på den vänstra menyn.
Aktivera antingen oautentiserade eller autentiserade push-meddelanden:

a. Om du vill aktivera oautentiserade push-meddelanden väljer du Aktivera oautentiserad push-spara>.

b. Så här aktiverar du autentiserade push-meddelanden:
- I verktygsfältet väljer du Ladda upp certifikat.
- Välj filikonen och välj sedan certifikatfilen.
- Ange lösenordet för certifikatet.
- Välj OK.
- På sidan Windows Phone (MPNS) väljer du Spara.

Mer information finns i Push-meddelanden till Windows Phone appar med hjälp av Notification Hubs.

Baidu (Android China)

Så här konfigurerar du push-meddelanden för Baidu:

I Azure Portal går du till sidan Notification Hub och väljer Baidu (Android China) på den vänstra menyn.
Ange den API-nyckel som du hämtade från Baidu-konsolen i Baidu Cloud Push-projektet.
Ange den hemliga nyckel som du hämtade från Baidu-konsolen i Baidu Cloud Push-projektet.
Välj Spara.

När du slutför de här stegen anger en avisering att meddelandehubben har uppdaterats. Knappen Spara är inaktiverad.

Mer information finns i Komma igång med Notification Hubs med hjälp av Baidu.

Nästa steg

I den här snabbstarten har du lärt dig hur du konfigurerar systeminställningar för plattformsmeddelanden för en meddelandehubb i Azure Portal.

Mer information om hur du push-överför meddelanden till olika plattformar finns i de här självstudierna:

Dela via