Självstudie: Skicka meddelanden till universella Windows-plattformsappar med hjälp av Azure Notification Hubs

I den här självstudien skapar du en meddelandehubb för att skicka push-meddelanden till en UWP-app (Universal Windows Platform). Du skapar en tom Windows Store-app som tar emot push-meddelanden med hjälp av Windows Push Notification Service (WNS). Sedan använder du meddelandehubben för att skicka push-meddelanden till alla enheter som kör din app.

Du utför följande steg:

Förutsättningar

• Azure-prenumeration. Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto innan du börjar.
• Microsoft Visual Studio 2017 eller senare. I exemplet i den här självstudien används Visual Studio 2019.
• UWP-apputvecklingsverktyg installerade.
• Ett aktivt Windows Store-konto.
• Bekräfta att inställningen Hämta meddelanden från appar och andra avsändare är aktiverad.
  • Starta fönstret Inställningar på datorn.
  • Välj rutan System.
  • Välj Meddelanden och åtgärder på den vänstra menyn.
  • Bekräfta att inställningen Hämta meddelanden från appar och andra avsändare är aktiverad. Om den inte är aktiverad aktiverar du den.

Att slutföra den här självstudien är en förutsättning för alla andra Notification Hubs-självstudier för UWP-appar.

Skapa en app i Windows Store

Om du vill skicka push-meddelanden till UWP-appar associerar du din app med Windows Store. Konfigurera sedan meddelandehubben så att den integreras med WNS.

1. Gå till Windows Dev Center, logga in med ditt Microsoft-konto och välj sedan Skapa en ny app.

   

2. Ange ett namn för din app och välj sedan Reservera produktnamn. När du gör det skapas en ny Windows Store-registrering för din app.

   

3. Expandera Produkthantering och välj sedan Produktidentitet. Anteckna värdena Package SID, Package/Identity/Name, Package/Identity/Publisher och Package/Properties/PublisherDisplayName .

   

4. Under Produkthantering väljer du WNS/MPNS och sedan Appregistreringsportal. Logga in på ditt Microsoft-konto. Programregistreringssidan öppnas på en ny flik.

   

5. Under Essentials väljer du Klientautentiseringsuppgifter: Lägg till ett certifikat eller en hemlighet.

   

6. På sidan Certifikat och hemligheter går du till Klienthemligheter och väljer Ny klienthemlighet. När du har skapat en klienthemlighet (kallas även en programhemlighet) bör du anteckna den innan du lämnar sidan.

   Varning

   Du kan bara visa klienthemlighetsvärden (programhemlighet) omedelbart efter att du har skapat dem. Spara hemligheten innan du lämnar sidan.

   

   Varning

   Applikationshemligheten och paket-SID är viktiga säkerhetsuppgifter. Dela inte dessa värden med någon och distribuera dem inte med din app.

Skapa en meddelandehubb

1. Logga in på Azure-portalen.

2. Välj Alla tjänster på den vänstra menyn.

3. Skriv Notification Hubs i textrutan Filtertjänster . Välj stjärnikonen bredvid tjänstnamnet för att lägga till tjänsten i avsnittet FAVORITER på den vänstra menyn. Välj Notification Hubs.

   

4. På sidan Notification Hubs väljer du Skapa i verktygsfältet.

   

5. Gör följande på fliken Grundläggande på sidan Notification Hub:

   1. I Prenumeration väljer du namnet på den Azure-prenumeration som du vill använda och väljer sedan en befintlig resursgrupp eller skapar en ny.

   2. Ange ett unikt namn för det nya namnområdet i Namnområdesinformation.

   3. Ett namnområde innehåller en eller flera meddelandehubbar, så skriv ett namn för hubben i Meddelandehubbens information.

   4. Välj ett värde i listrutan Plats . Det här värdet anger den plats där du vill skapa hubben.

      

   5. Granska alternativet Tillgänglighetszoner. Om du väljer en region som har tillgänglighetszoner markeras kryssrutan som standard. Tillgänglighetszoner är en betald funktion, så en extra avgift läggs till på din nivå.

   6. Välj ett havåterställningsalternativ: Ingen, Parvis återställningsregion eller Flexibel återställningsregion. Om du väljer parkopplad återställningsregionvisas failoverregionen. Om du väljer Flexibel återställningsregion använder du listrutan för att välja från en lista över återställningsregioner.

      

   7. Välj Skapa.

6. När distributionen är klar väljer du Gå till resurs.

Konfigurera WNS-inställningar för hubben

1. I kategorin MEDDELANDEINSTÄLLNINGAR väljer du Windows (WNS).

2. Ange värden för Paket-SID (till exempel "ms-app://<Your Package SID>") och Säkerhetsnyckel ( programhemligheten) som du antecknade i föregående avsnitt.

3. Klicka på Spara i verktygsfältet.

   

Meddelandehubben har nu konfigurerats för att fungera med WNS. Du har anslutningssträngarna för att registrera din app och skicka meddelanden.

Skapa en Windows-exempelapp

1. I Visual Studio öppnar du menyn Arkiv. Välj Nytt och sedan Projekt.

2. Slutför följande steg i dialogrutan Skapa ett nytt projekt :

   • I sökrutan längst upp skriver du Windows Universal.

   • I sökresultaten väljer du Tom app (Universell Windows) och sedan Nästa.

     dialogrutan

   • I dialogrutan Konfigurera det nya projektet anger du ett projektnamn och en plats för projektfilerna.

   • Välj Skapa.

3. Acceptera standardvärdena för mål - och minimiplattformsversionerna och välj OK.

4. Högerklicka på Windows Store-appprojektet i Solution Explorer, välj Publicera och välj sedan Associera app med Store. Guiden Associera din app med Windows Store visas.

5. Logga in med ditt Microsoft-konto i inställningsguiden.

6. Välj den app som du registrerade i steg 2, välj Nästa och välj sedan Associera. På så sätt läggs den nödvändiga Registreringsinformationen för Windows Store till i programmanifestet.

7. Högerklicka på lösningen i Visual Studio och välj sedan Hantera NuGet-paket. Fönstret Hantera NuGet-paket öppnas.

8. I sökrutan anger du WindowsAzure.Messaging.Managed, väljer Installera och godkänner användningsvillkoren.

   

   Den här åtgärden laddar ned, installerar och lägger till en referens till Azure Notification Hubs-biblioteket för Windows med hjälp av NuGet-paketet Microsoft.Azure.NotificationHubs.

9. App.xaml.cs Öppna projektfilen och lägg till följande instruktioner:

   using Windows.Networking.PushNotifications;
   using Microsoft.WindowsAzure.Messaging;
   using Windows.UI.Popups;
   

10. Leta upp klassen i App.xaml.cs projektets App fil och lägg till följande InitNotificationsAsync metoddefinition. Ersätt <your hub name> med namnet på meddelandehubben som du skapade i Azure-portalen och ersätt <Your DefaultListenSharedAccessSignature connection string> med anslutningssträngen DefaultListenSharedAccessSignature från sidan Åtkomstprinciper i meddelandehubben:

    private async void InitNotificationsAsync()
    {
        var channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();
    
        var hub = new NotificationHub("<your hub name>", "<Your DefaultListenSharedAccessSignature connection string>");
        var result = await hub.RegisterNativeAsync(channel.Uri);
    
        // Displays the registration ID so you know it was successful
        if (result.RegistrationId != null)
        {
            var dialog = new MessageDialog("Registration successful: " + result.RegistrationId);
            dialog.Commands.Add(new UICommand("OK"));
            await dialog.ShowAsync();
        }
    }
    

    Den här koden hämtar kanal-URI:n för appen från WNS och registrerar sedan kanal-URI:n med din meddelandehubb.

    Anmärkning

    hub name Ersätt platshållaren med namnet på meddelandehubben som visas i Azure-portalen. Ersätt även platshållaren för anslutningssträngen med anslutningssträngen DefaultListenSharedAccessSignature som du fick från sidan Åtkomstprinciper i meddelandehubben i ett tidigare avsnitt.

11. Överst i OnLaunched händelsehanteraren i App.xaml.cslägger du till följande anrop till den nya InitNotificationsAsync metoden:

    InitNotificationsAsync();
    

    Den här åtgärden garanterar att kanal-URI:n registreras i meddelandehubben varje gång programmet startas.

12. Högerklicka Package.appxmanifest och välj Visa kod (F7). Leta upp <Identity .../> och ersätt värdet Namn med värdet Package/Identity/Name och ersätt dess Publisher-värde med värdet Package/Identity/Publisher från appen som du skapade tidigare.

13. Om du vill köra appen trycker du på tangentbordets F5-tangent . En dialogruta som innehåller registreringsnyckeln visas. Stäng dialogrutan genom att klicka på OK.

    

Din app är nu redo att ta emot toast-meddelanden.

Skicka testmeddelanden

Du kan snabbt testa att ta emot meddelanden i din app genom att skicka meddelanden i Azure-portalen.

1. I Azure-portalen växlar du till fliken Översikt och väljer Testa skicka i verktygsfältet.

   

2. Gör följande i fönstret Skicka test :

   • För Plattformar väljer du Windows.

   • För Meddelandetyp, välj Toastmeddelande.

   • Välj Skicka.

     

3. Se resultatet av åtgärden Skicka i resultatlistan längst ned i fönstret. Du ser också ett aviseringsmeddelande.

   

4. Du ser meddelandet: Testa meddelandet på skrivbordet.

   

Nästa steg

Du har skickat sändningsmeddelanden till alla dina Windows-enheter med hjälp av Azure-portalen eller en konsolapp. Om du vill lära dig hur du skickar notifieringar till specifika enheter går du vidare till följande guide: