Tutorial: Senden von Benachrichtigungen an Apps für die universelle Windows-Plattform mit Azure Notification HubsTutorial: Send notifications to Universal Windows Platform apps by using Azure Notification Hubs

In diesem Tutorial erstellen Sie einen Notification Hub, um Pushbenachrichtigungen an eine App für die universelle Windows-Plattform (UWP) zu senden.In this tutorial, you create a notification hub to send push notifications to a Universal Windows Platform (UWP) app. Sie erstellen eine leere Windows Store-App, die Pushbenachrichtigungen unter Verwendung des Windows-Pushbenachrichtigungsdiensts (WNS) empfängt.You create a blank Windows Store app that receives push notifications by using the Windows Push Notification Service (WNS). Dann senden Sie über Ihren Notification Hub Pushbenachrichtigungen an alle Geräte, die Ihre App ausführen.Then, you use your notification hub to broadcast push notifications to all devices that are running your app.

Hinweis

Den vollständigen Code für dieses Tutorial finden Sie auf GitHub.You can find the completed code for this tutorial on GitHub.

Führen Sie die folgenden Schritte aus:You take the following steps:

  • Erstellen einer App im Windows StoreCreate an app in Windows Store
  • Erstellen eines Notification HubsCreate a Notification Hub
  • Erstellen einer Beispiel-Windows-AppCreate a sample Windows app
  • Senden von TestbenachrichtigungenSend test notifications

VoraussetzungenPrerequisites

  • Azure-Abonnement.Azure subscription. Wenn Sie über kein Azure-Abonnement verfügen, können Sie ein kostenloses Azure-Konto erstellen, bevor Sie beginnen.If you don't have an Azure subscription, create a free Azure account before you begin.
  • Microsoft Visual Studio Community 2015 oder höherMicrosoft Visual Studio Community 2015 or later or later.
  • Installierte Entwicklungstools für UWP-AppsUWP app-development tools installed
  • Ein aktives Windows Store-KontoAn active Windows Store account
  • Vergewissern Sie sich, dass die Einstellung Benachrichtigungen von Apps und anderen Absendern abrufen aktiviert ist.Confirm that Get notifications from apps and other senders setting is enabled.
    • Starten Sie das Fenster Einstellungen auf Ihrem Computer.Launch Settings window on your computer.
    • Wählen Sie die Kachel System aus.Select the System tile.
    • Wählen Sie links im Menü Benachrichtigungen und Aktionen aus.Select Notifications & actions from the left menu.
    • Vergewissern Sie sich, dass die Einstellung Benachrichtigungen von Apps und anderen Absendern abrufen aktiviert ist.Confirm that the Get notifications from apps and other senders setting is enabled. Ist sie nicht aktiviert, aktivieren Sie sie.If it isn't enabled, enable it.

Dieses Tutorial muss für alle anderen Notification Hubs-Tutorials für UWP-Apps abgeschlossen werden.Completing this tutorial is a prerequisite for all other Notification Hubs tutorials for UWP apps.

Erstellen einer App im Windows StoreCreate an app in Windows Store

Ordnen Sie Ihre App dem Windows Store zu, um Pushbenachrichtigungen an UWP-Apps senden zu können.To send push notifications to UWP apps, associate your app to the Windows Store. Konfigurieren Sie anschließend Ihren Notification Hub für die Integration in WNS.Then, configure your notification hub to integrate with WNS.

  1. Navigieren Sie zum Windows Dev Center, melden Sie sich dort mit Ihrem Microsoft-Konto an, und wählen Sie dann Neue App erstellen aus.Navigate to the Windows Dev Center, sign in with your Microsoft account, and then select Create a new app.

    „Neue App“-Schaltfläche

  2. Geben Sie einen Namen für Ihre App ein, und wählen Sie anschließend Produktname reservieren aus.Type a name for your app, and then select Reserve product name. Dadurch wird eine neue Windows Store-Registrierung für Ihre App erstellt.Doing so creates a new Windows Store registration for your app.

    Store-App-Name

  3. Erweitern Sie App-Verwaltung, wählen Sie WNS/MPNS und dann Live Services-Website aus.Expand App Management, select WNS/MPNS, and then select Live Services site. Anmelden bei Ihrem Azure-KontoSign in to your Microsoft account. Das App-Registrierungsportal wird auf einer neuen Registerkarte geöffnet. Alternativ können Sie direkt zum App-Registrierungsportal navigieren und Ihren Anwendungsnamen auswählen, um zu dieser Seite zu gelangen.The Application Registration Portal opens in a new tab. Alternatively, you can navigate directly to the Application Registration Portal, select your application name to get to this page.

    WNS/MPNS-Seite

  4. Notieren Sie sich das Kennwort unter Anwendungsgeheimnis sowie die Paketsicherheits-ID (SID) .Note the Application Secret password and the Package security identifier (SID).

    Warnung

    Der geheime Schlüssel der Anwendung und die Paket-SID sind wichtige Sicherheitsanmeldeinformationen.The application secret and package SID are important security credentials. Geben Sie diese Werte nicht weiter, und verteilen Sie sie nicht mit Ihrer Anwendung.Do not share these values with anyone or distribute them with your app.

Erstellen eines Notification HubsCreate a Notification Hub

  1. Melden Sie sich beim Azure-Portal an.Sign in to the Azure portal.

  2. Wählen Sie im Menü auf der linken Seite die Option Alle Dienste und dann im Abschnitt Mobil die Option Notification Hubs aus.Select All services on the left menu, and then select Notification Hubs in the Mobile section. Wählen Sie das Sternsymbol neben dem Dienstnamen aus, um den Dienst im linken Menü zum Abschnitt FAVORITEN hinzuzufügen.Select the star icon next to the service name to add the service to the FAVORITES section on the left menu. Nachdem Notification Hubs unter FAVORITEN hinzugefügt wurde, können Sie diesen Eintrag im Menü auf der linken Seite auswählen.After you add Notification Hubs to FAVORITES, select it on the left menu.

    Azure-Portal – Auswählen von Notification Hubs

  3. Wählen Sie auf der Seite Notification Hubs in der Symbolleiste die Option Hinzufügen.On the Notification Hubs page, select Add on the toolbar.

    Notification Hubs – Symbolleistenschaltfläche „Hinzufügen“

  4. Führen Sie auf der Seite Notification Hub die folgenden Schritte aus:On the Notification Hub page, do the following steps:

    1. Geben Sie ins Feld Notification Hub einen Namen ein.Enter a name in Notification Hub.

    2. Geben Sie ins Feld Neuen Namespace erstellen einen Namen ein.Enter a name in Create a new namespace. Ein Namespace enthält mindestens einen Hub.A namespace contains one or more hubs.

    3. Wählen Sie im Dropdown-Listenfeld Standort einen Wert aus.Select a value from the Location drop-down list box. Dieser Wert gibt den Standort an, an dem der Hub erstellt werden soll.This value specifies the location in which you want to create the hub.

    4. Wählen Sie unter Ressourcengruppe eine vorhandene Ressourcengruppe aus, oder erstellen Sie einen Namen für eine neue Ressourcengruppe.Select an existing resource group in Resource Group, or create a name for a new resource group.

    5. Klicken Sie auf Erstellen.Select Create.

      Azure-Portal – Festlegen von Eigenschaften für den Notification Hub

  5. Wählen Sie Benachrichtigungen (Glockensymbol) und dann Zu Ressource wechseln aus.Select Notifications (the bell icon), and then select Go to resource. Sie können auch die Liste auf der Seite Notification Hubs aktualisieren und Ihren Hub auswählen.You can also refresh the list on the Notification Hubs page and select your hub.

    Azure-Portal – Benachrichtigungen -> Zu Ressource wechseln

  6. Wählen Sie in der Liste die Option Zugriffsrichtlinien aus.Select Access Policies from the list. Notieren Sie sich die beiden Verbindungszeichenfolgen, die für Sie verfügbar sind.Note that the two connection strings are available to you. Sie werden später für die Behandlung von Pushbenachrichtigungen benötigt.You'll need them later to handle push notifications.

    Wichtig

    Verwenden Sie nicht die Richtlinie DefaultFullSharedAccessSignature in Ihrer Anwendung.Do not use the DefaultFullSharedAccessSignature policy in your application. Diese ist nur für die Verwendung in Ihrem Back-End vorgesehen.This is meant to be used in your back end only.

    Azure-Portal – Verbindungszeichenfolgen für den Notification Hub

Konfigurieren der WNS-Einstellungen für den HubConfigure WNS settings for the hub

  1. Wählen Sie in der Kategorie BENACHRICHTIGUNGSEINSTELLUNGEN die Option Windows (WNS) aus.In the NOTIFICATION SETTINGS category, select Windows (WNS).

  2. Geben Sie die Werte für Paket-SID und Sicherheitsschlüssel ein, die Sie im vorherigen Abschnitt notiert haben.Enter values for Package SID and Security Key you noted from the previous section.

  3. Klicken Sie in der Symbolleiste auf Speichern .Click Save on the toolbar.

    Die Felder für Paket-SID und Sicherheitsschlüssel

Ihr Notification Hub ist jetzt für die Zusammenarbeit mit WNS konfiguriert.Your notification hub is now configured to work with WNS. Sie verfügen über die Verbindungszeichenfolgen, die Sie zum Registrieren Ihrer App und zum Senden von Benachrichtigungen benötigen.You have the connection strings to register your app and send notifications.

Erstellen einer Beispiel-Windows-AppCreate a sample Windows app

  1. Öffnen Sie in Visual Studio das Menü Datei, und wählen Sie die Optionen Neu und Projekt.In Visual Studio, open the File menu, select New, and then select Project.

  2. Führen Sie im Dialogfenster Neues Projekt die folgenden Schritte aus:In the New Project dialog, complete the following steps:

    1. Erweitern Sie Visual C# .Expand Visual C#.

    2. Wählen Sie Windows Universal aus.Select Windows Universal.

    3. Wählen Sie Leere App (universelles Windows) aus.Select Blank App (Universal Windows).

    4. Geben Sie einen Namen für das Projekt ein.Enter a name for the project.

    5. Klicken Sie auf OK.Select OK.

      Dialogfeld "Neues Projekt"

  3. Übernehmen Sie die Standardwerte für die Zielversion und die Mindestversion der Plattform, und wählen Sie OK aus.Accept the defaults for the target and minimum platform versions, and select OK.

  4. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Windows Store-App-Projekt, und wählen Sie Store und anschließend App mit Store verknüpfen aus.In Solution Explorer, right-click the Windows Store app project, select Store, and then select Associate App with the Store. Daraufhin wird der Assistent App mit Windows Store verknüpfen angezeigt.The Associate Your App with the Windows Store wizard appears.

  5. Melden Sie sich im Assistenten mit Ihrem Microsoft-Konto an.In the wizard, sign in with your Microsoft account.

  6. Wählen Sie die App aus, die Sie in Schritt 2 registriert haben. Wählen Sie dann Weiter und anschließend Zuordnen aus.Select the app that you registered in step 2, select Next, and then select Associate. Dadurch werden die erforderlichen Windows Store-Registrierungsinformationen zum Anwendungsmanifest hinzugefügt.Doing so adds the required Windows Store registration information to the application manifest.

  7. Klicken Sie in Visual Studio mit der rechten Maustaste auf die Projektmappe, und wählen Sie NuGet-Pakete verwalten aus.In Visual Studio, right-click the solution, and then select Manage NuGet Packages. Das Fenster NuGet-Pakete verwalten wird geöffnet.The Manage NuGet Packages window opens.

  8. Geben Sie in das Suchfeld die Zeichenfolge WindowsAzure.Messaging.Managed ein, wählen Sie Installieren aus, und akzeptieren Sie die Nutzungsbedingungen.In the search box, enter WindowsAzure.Messaging.Managed, select Install, and accept the terms of use.

    Das Fenster „NuGet-Pakete verwalten“

    Mit dieser Aktion wird unter Verwendung des Microsoft.Azure.NotificationHubs-NuGet-Pakets die Azure Notification Hubs-Bibliothek für Windows heruntergeladen, installiert und ein Verweis hinzugefügt.This action downloads, installs, and adds a reference to the Azure Notification Hubs library for Windows by using the Microsoft.Azure.NotificationHubs NuGet package.

  9. Öffnen Sie die Projektdatei App.xaml.cs, und fügen Sie die folgenden Anweisungen hinzu:Open the App.xaml.cs project file, and add the following statements:

    using Windows.Networking.PushNotifications;
    using Microsoft.WindowsAzure.Messaging;
    using Windows.UI.Popups;
    
  10. Suchen Sie in der Datei App.xaml.cs des Projekts die Klasse App, und fügen Sie die folgende InitNotificationsAsync-Methodendefinition hinzu:In the project's App.xaml.cs file, locate the App class, and add the following InitNotificationsAsync method definition:

    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();
        }
    }
    

    Dieser Code ruft den Kanal-URI für die App von WNS ab und registriert dann diesen Kanal-URI bei Ihrem Benachrichtigungshub.This code retrieves the channel URI for the app from WNS, and then registers that channel URI with your notification hub.

    Hinweis

    Ersetzen Sie den Platzhalter hub name durch den Namen des Notification Hubs aus dem Azure-Portal.Replace the hub name placeholder with the name of the notification hub that appears in the Azure portal. Ersetzen Sie außerdem den Verbindungszeichenfolgen-Platzhalter durch die Verbindungszeichenfolge DefaultListenSharedAccessSignature, die Sie in einem der vorherigen Abschnitte über die Seite Zugriffsrichtlinien Ihres Notification Hubs ermittelt haben.Also replace the connection string placeholder with the DefaultListenSharedAccessSignature connection string that you obtained from the Access Polices page of your notification hub in a previous section.

  11. Fügen Sie in der Datei App.xaml.cs oben im Ereignishandler OnLaunched den folgenden Aufruf zur neuen InitNotificationsAsync-Methode hinzu:At the top of the OnLaunched event handler in App.xaml.cs, add the following call to the new InitNotificationsAsync method:

    InitNotificationsAsync();
    

    Dadurch wird gewährleistet, dass der Kanal-URI bei jedem Start der Anwendung beim Notification Hub registriert wird.This action guarantees that the channel URI is registered in your notification hub each time the application launches.

  12. Drücken Sie zum Ausführen der App auf der Tastatur die Taste F5.To run the app, press the keyboard's F5 key. Ein Dialogfeld mit dem Registrierungsschlüssel wird angezeigt.A dialog box containing the registration key will display. Klicken Sie auf OK, um das Dialogfeld zu schließen.To close the dialog, click OK.

    Erfolgreiche Registrierung

Ihre App kann jetzt Popupbenachrichtigungen empfangen.Your app is now ready to receive toast notifications.

Senden von TestbenachrichtigungenSend test notifications

Der Benachrichtigungsempfang in der App kann schnell durch Senden von Benachrichtigungen im Azure-Portal getestet werden.You can quickly test receiving notifications in your app by sending notifications in the Azure portal.

  1. Wechseln Sie im Azure-Portal zur Registerkarte Übersicht, und wählen Sie auf der Symbolleiste Testsendevorgang aus.In the Azure portal, switch to the Overview tab, and select Test Send on the toolbar.

    Schaltfläche „Testsendevorgang“

  2. Führen Sie im Fenster Testsendevorgang die folgenden Aktionen aus:In the Test Send window, do the following actions:

    1. Wählen Sie für Plattformen die Option Windows aus.For Platforms, select Windows.

    2. Wählen Sie für Benachrichtigungstyp die Option Popup aus.For Notification Type, select Toast.

    3. Wählen Sie Senden aus.Select Send.

      Der Bereich „Testsendevorgang“

  3. Das Ergebnis des Sendevorgangs wird am unteren Rand des Fensters in der Liste Ergebnis angezeigt.See the result of the Send operation in the Result list at the bottom of the window. Sie sehen auch eine Warnmeldung.You also see an alert message.

    Ergebnis des Sendevorgangs

  4. Sie sehen die Benachrichtigungsmeldung Testmeldung auf Ihrem Desktop.You see the notification message: Test message on your desktop.

    Benachrichtigungsmeldung

Nächste SchritteNext steps

Sie haben über das Portal oder über eine Konsolen-App Übertragungsbenachrichtigungen an alle Ihre Windows-Geräte gesendet.You have sent broadcast notifications to all your Windows devices by using the portal or a console app. Um zu erfahren, wie Sie Pushbenachrichtigungen an bestimmte Geräte senden, fahren Sie mit dem folgenden Tutorial fort:To learn how to push notifications to specific devices, advance to the following tutorial: