Freigeben über

Schnellstart: Hinzufügen von Pushbenachrichtigungen für einen mobilen Dienst (JavaScript)

  • Artikel

[ Dieser Artikel richtet sich an Windows 8.x- und Windows Phone 8.x-Entwickler, die Windows-Runtime-Apps schreiben. Wenn Sie für Windows 10 entwickeln, finden Sie weitere Informationen unter neueste Dokumentation]

In dieser Schnellstartanleitung aktivieren Sie Pushbenachrichtigungen in einer App mithilfe von Azure Mobile Services. Mobile Services vereinfacht das Senden von Pushbenachrichtigungen an Ihre App mit dem Windows-Pushbenachrichtigungsdienst (Windows Push Notification Services, WNS). Weitere Informationen finden Sie unter Mobile Services-Developer Center. Wenn Sie mit Microsoft Visual Studio 2013 arbeiten, können Sie einfach Pushbenachrichtigungen in Ihrer Mobile Services-App aktivieren. Dieses Thema baut auf dem vorangegangenen Thema Schnellstart: Hinzufügen eines mobilen Dienstes auf. Nach Abschluss haben Sie Pushbenachrichtigungen zu Ihrem neuen mobilen Dienst hinzugefügt und die App durch Senden einer neuen Benachrichtigung getestet.

Voraussetzungen

Hinzufügen und Konfigurieren von Pushbenachrichtigungen in der App

Zunächst verwenden Sie den Assistenten zum Hinzufügen von Pushbenachrichtigungen in Visual Studio 2013, um Ihre App beim Windows Store zu registrieren, Ihren mobilen Dienst zur Aktivierung von Pushbenachrichtigungen zu konfigurieren und Code zur App hinzuzufügen, um einen Gerätekanal zu registrieren.

Hinweis  In diesem Thema wird davon ausgegangen, dass Sie dem Projekt bereits eine Verbindung zum mobilen Dienst hinzugefügt haben. Die Durchführung dieses Vorgang wurde im vorangegangenen Thema erläutert. Wenn keine Verbindung zu einem mobilen Dienst hergestellt wurde, stellt der Assistent zum Hinzufügen von Pushbenachrichtigungen diese Verbindung für Sie her.

 

  1. Öffnen Sie in Visual Studio 2013 den Projektmappen-Explorer, klicken Sie mit der rechten Maustaste auf das Projekt, und klicken Sie anschließend auf Hinzufügen gefolgt von Pushbenachrichtigung …. Dadurch wird der Assistent zum Hinzufügen von Pushbenachrichtigungen gestartet.
  2. Klicken Sie auf Weiter, melden Sie sich bei Ihrem Windows Store-Konto an, geben Sie einen Namen in Neuen Namen reservieren an, und klicken Sie auf Reservieren. Dadurch wird eine neue App-Registrierung im Windows Store erstellt.
  3. Klicken Sie in der Liste App-Name auf die neue Registrierung und dann auf Weiter.
  4. Wählen Sie den mobilen Dienst, den Sie im Thema Schnellstart: Hinzufügen eines mobilen Dienstes oder Schnellstart: Hinzufügen eines mobilen Dienstes mit C++ erstellt haben, und klicken Sie auf Weiter gefolgt von Fertig stellen. Dadurch wird Ihr mobiler Dienst für die Funktion mit dem Windows-Pushbenachrichtigungsdienst (Windows Push Notification Services, WNS) konfiguriert, damit er Benachrichtigungen an die App senden kann.Hinweis  Wenn Ihre App noch nicht für die Verbindung mit dem mobilen Dienst konfiguriert ist, führt der Assistent auch die Konfigurationsaufgaben durch, die in Schnellstart: Hinzufügen eines mobilen Dienstes demonstriert werden.  
  5. (Optional) Öffnen Sie die generierte YourMobileService-Codedatei „Push.Register.js“, und überprüfen Sie den Code. Dieser Code stellt sicher, dass bei jeder Aktivierung der App die Registrierung des Gerät überprüft und die benutzerdefinierte Notifyallusers-API aufgerufen wird.
  6. (Optional) Erweitern Sie im Server-Explorer Mobile Dienste Ihren Dienstnamen, und öffnen Sie die notifyallusers.js-Datei. Diese Datei ist in Ihrem mobilen Dienst gespeichert und enthält JavaScript-Code, der Push-Benachrichtigungen an alle registrierten Benutzer versendet.
  7. Drücken Sie die F5-Taste, um die App auszuführen, und überprüfen Sie, ob unmittelbar eine Benachrichtigung vom mobilen Dienst empfangen wird.

Aktualisieren des generierten Pushbenachrichtigungscodes

Der Assistent zum Hinzufügen von Pushbenachrichtigungen fügt Code hinzu, über den eine Testbenachrichtigung an alle registrierten Benutzer versendet wird. Dadurch wird es zwar einfacher, eine Benachrichtigung zu demonstrieren, wenn die App ausgeführt wird, aber im Allgemeinen stellt dies kein nützliches Szenario dar. Daher löschen Sie den Aufruf von Notifyallusers und ersetzen ihn nach einigen Änderungen durch Code, über den eine Benachrichtigung an alle registrierten Geräte versandt wird, wenn etwas in der TodoItem-Tabelle eingefügt wird.

  1. Erweitern Sie im Server-Explorer Mobile Dienste, den Namen des Diensts, und klicken Sie dann auf „notifyallusers.js“. Er enthält Code zum Senden einer Pushbenachrichtigung. Hinweis  Der Code, der eine Pushbenachrichtigung sendet, kann in jede registrierte Skriptdatei aufgenommen werden. Der Speicherort des Skripts hängt davon ab, wie die Benachrichtigung ausgelöst wird. Skripts können für einen Einfüge-, Aktualisierungs-, Lösch- und Lesevorgang mit einer Tabelle als geplanter Auftrag oder als benutzerdefinierte API registriert werden. Weitere Informationen finden Sie unter Arbeiten mit Serverskripts in Mobile Services. In diesem Fall wird dieser Code in die Skriptdatei verschoben, die für den Einfügevorgang in der TodoItem-Tabelle registriert ist.

     

  2. Erweitern Sie die TodoItem-Tabelle, öffnen Sie die Datei „Insert.js“, ersetzen Sie die aktuelle Einfügefunktion durch den folgenden Code, und speichern Sie die Änderungen:

    function insert(item, user, request) {
// Define a payload for the Windows Store toast notification.
var payload = '<?xml version="1.0" encoding="utf-8"?><toast><visual>' +    
    '<binding template="ToastText01">  <text id="1">' +
    item.text + '</text></binding></visual></toast>';

request.execute({
    success: function() {
        // If the insert succeeds, send a notification.
        push.wns.send(null, payload, 'wns/toast', {
            success: function(pushResponse) {
                console.log("Sent push:", pushResponse);
                request.respond();
                },              
                error: function (pushResponse) {
                    console.log("Error Sending push:", pushResponse);
                    request.respond(500, { error: pushResponse });
                    }
                });
            }
        });
}

    Wenn Sie Änderungen an der Datei „insert.js“ speichern, wird eine neue Version des Skripts in Ihren mobilen Dienst hochgeladen.

    Beim Einfügen eines neuen TodoItem wird sofort eine neue Pushbenachrichtigung an das Gerät zurückgesendet, das die Einfügung vorgenommen hat.

  3. Drücken Sie in Visual Studio die Taste F5, um die App auszuführen.

  4. Geben Sie in der App Text in Insert a TodoItem ein, und klicken Sie dann auf Speichern. Beachten Sie, dass, nachdem der Einfügevorgang in der Tabelle in Azure durchgeführt wurde, umgehend eine Benachrichtigung zurück an das Gerät gesendet wird.

  5. (Optional) Führen Sie die App auf zwei Geräten gleichzeitig aus, und wiederholen Sie den letzten Schritt. Stellen Sie sicher, dass die Benachrichtigung an alle aktiven App-Instanzen gesendet wird.

Zusammenfassung und nächste Schritte

Jetzt wissen Sie, wie Sie mit Mobile Services Pushbenachrichtigungen zu Ihrer Windows Store-App hinzufügen können.

Als Nächstes sollten Sie sich damit vertraut machen, wie Sie mit Mobile Services Benutzer anhand von Identitätsanbietern, wie Microsoft-Konto, Facebook, Twitter oder Google, authentifizieren. Weitere Informationen finden Sie unter Erste Schritte mit der Authentifizierung.

Verwandte Themen

Planen von wiederkehrenden Aufträgen in Mobile Services

Arbeiten mit Serverskripts in Mobile Services