Snabbstart: Konfigurera push-meddelanden i en meddelandehubb

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.

Kommentar

Information om utfasning och migrering av 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):

1. I Azure Portal går du till sidan Notification Hub och väljer Apple (APNS) på den vänstra menyn.

2. 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.

Google Firebase Cloud Messaging V1 (FCMv1)

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

1. I Azure Portal går du till sidan Notification Hub och väljer Google (FCMv1) på den vänstra menyn.
2. Uppdatera värdena För privat nyckel, Projekt-ID och Klient-E-post från JSON-filen för tjänstkontot som hämtats från Firebase-konsolen.
3. Välj Spara.

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

Google Firebase Cloud Messaging (FCM)

Kommentar

Firebase Cloud Messaging (FCM) har föråldrats och stöds inte längre.

Portal

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

1. I Azure Portal går du till sidan Notification Hub och väljer Google (GCM/FCM) på den vänstra menyn.

2. Klistra in API-nyckeln för Google FCM-projektet som du sparade tidigare.

3. Välj Spara.

   

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

Azure CLI

Du behöver API-nyckeln för ditt Projekt för 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 installera 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

1. 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
   

2. 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 åtkomstprincipen anslutningssträng s. Ange primaryConnectionString eller secondaryConnectionString i parametern --query för att hämta den primära anslutningssträng 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
   

3. 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):

1. I Azure Portal går du till sidan Notification Hub och väljer Windows (WNS) på den vänstra menyn.

2. Ange värden för Package SID (Paket-SID) och Security Key (Säkerhetsnyckel).

3. Välj Spara.

   

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

Baidu (Android China)

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

1. I Azure Portal går du till sidan Notification Hub och väljer Baidu (Android China) på den vänstra menyn.

2. Ange den API-nyckel som du hämtade från Baidu-konsolen i Baidu-moln push-projektet.

3. Ange den hemliga nyckel som du hämtade från Baidu-konsolen i Baidu-moln push-projektet.

4. 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 Kom 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:

• Skicka push-meddelanden till iOS-appar med Hjälp av Azure Notification Hubs
• Skicka meddelanden till Android-enheter med hjälp av Notification Hubs och Google FCM
• Skicka meddelanden till en UWP-app som körs på en Windows-enhet
• Skicka meddelanden med hjälp av Notification Hubs och Baidu cloud push