Schnellstart: Einrichten regelmäßiger Benachrichtigungen (HTML)

Artikel
12/12/2015

[ 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]

Hinweis Sie verwenden nicht JavaScript? Weitere Informationen finden Sie unter Schnellstart: Einrichten regelmäßiger Benachrichtigungen (XAML).

In diesem Thema erfahren Sie, wie Sie das regelmäßige Abfragen einer URL implementieren, um aktualisierte Inhalte für die Kachel Ihrer App zu erhalten.

Es wird empfohlen, dass alle abgerufenen Benachrichtigungen den X-WNS-Expires-HTTP-Antwortheader nutzen, um eine explizite Ablaufzeit festzulegen. Weitere Informationen zum Festlegen von X-WNS-Expires finden Sie unter TileUpdater.StartPeriodicUpdate oder TileUpdater.StartPeriodicUpdateBatch.

Hinweis In dieser Anleitung wird der Benachrichtigungsinhalt direkt über das XML-DOM (Dokumentobjektmodell) gesteuert. Über die NotificationsExtensions-Bibliothek steht ein optionaler Ansatz zur Verfügung, bei dem der XML-Inhalt in Form von Objekteigenschaften dargestellt wird, wobei Sie u. a. IntelliSense nutzen können. Weitere Informationen finden Sie unter Schnellstart: Verwenden der NotificationsExtensions-Bibliothek im Code. Die NotificationsExtensions-Variante des Codes in dieser Schnellstartanleitung finden Sie unter Beispiel für Pushbenachrichtigungen und regelmäßige Benachrichtigungen.

Voraussetzungen

Grundkenntnisse der Begriffe und Konzepte für Kacheln und Benachrichtigungen. Weitere Informationen finden Sie unter Kacheln, Infoanzeiger und Benachrichtigungen.
Grundlegendes Verständnis der Konzepte für regelmäßige (Abruf-)Benachrichtigungen. Weitere Informationen finden Sie unter Übersicht über regelmäßige Benachrichtigungen.
Die Fähigkeit zum Erstellen einer einfachen Windows Store-App mit JavaScript mithilfe von Windows-Runtime-APIs. Weitere Informationen finden Sie unter Erstellen Ihrer ersten Windows Store-App mit JavaScript.
Ein Webdienst zum Hosten der Kachelbenachrichtigungsinhalte.

Anweisungen

1. Erstellen oder identifizieren Sie einen Webdienst, der den XML-Inhalt der Kachel hostet

In einem definierten Intervall fragt Windows den angegebenen Webdienst im Hinblick auf aktualisierte Kachelinhalte für die App ab. Der Webdienst muss HTTP unterstützen. Zu Testzwecken können Sie auch einen Webdienst wie die Microsoft-Internetinformationsdienste (Internet Information Services, IIS) auf dem lokalen Computer einrichten, um den XML-Inhalt zu testen.

2. Legen Sie die XML-Datei für den Kachelinhalt an einem Speicherort mit Webzugriff ab

Der Webdienst fungiert als Host für den XML-Inhalt der Kachel. Zuerst müssen Sie den hier abgebildeten Kachel-XML-Inhalt auf der Website hosten. Speichern Sie diesen Inhalt in einer Datei mit dem Namen "Tile.xml", und legen Sie die Datei auf dem Server an einem über das Web zugänglichen Speicherort (beispielsweise "http://www.fabrikam.com/tile.xml)" ab. Der Inhalt des XML-Dokuments muss eine UTF-8-Codierung verwenden und dem Kachelschema entsprechen. Die Häufigkeit, mit der dieses XML-Dokument aktualisiert wird, sollte mindestens dem Wiederholungsintervall des angegebenen Abrufintervalls entsprechen.


<tile>
  <visual version="2">
    <binding template="TileSquare150x150Text04" fallback="TileSquareText04">
      <text id="1">Hello world!</text>
    </binding>  
  </visual>
</tile>

3. Beginnen Sie mit den regelmäßigen Updates (einzelne URL)

In diesem Beispiel wird gezeigt, wie Sie das Abfragen einer einzelnen URL auslösen, um einmal pro Stunde neue Inhalte für die Kachel bereitzustellen. In diesem Code wird die zuvor definierte Variable polledUrl verwendet. Hierbei handelt es sich um eine Zeichenfolge, die die abzufragende URL angibt.


var notifications = Windows.UI.Notifications;
var recurrence = notifications.PeriodicUpdateRecurrence.hour;
var url = new Windows.Foundation.Uri(polledUrl);

notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdate(url, recurrence);

4. Beginnen Sie mit den regelmäßigen Updates (mehrere URLs)

Alternativ zum vorherigen Schritt kann Windows bis zu fünf verschiedene URLs abfragen, um einen Satz mit Inhalten bereitzustellen, die die Benachrichtigungswarteschlange der Kachel durchlaufen.

In diesem Beispiel wird gezeigt, wie Sie einmal pro Stunde neue Inhalte von mehreren URLs abrufen. Falls noch nicht geschehen, müssen Sie zuerst die Benachrichtigungswarteschlange aktivieren. Beachten Sie, dass der Aufruf von enableNotificationQueue nur einmal erfolgen sollten, nachdem der Benutzer die App installiert oder eine sekundäre Kachel erstellt hat. In diesem Beispiel wird die zuvor definierte Variable urisToPoll verwendet, die ein Array aus Windows.Foundation.Uri-Objekten ist.

Hinweis Regelmäßige Kachelupdates unterstützen die Benachrichtigungsmarkierung für Kacheln, die Teil der Ersetzungslogik der Benachrichtigungswarteschlange ist. Ihr Dienst kann die Markierung bei jeder Benachrichtigung setzen, indem der X-WNS-Tag-HTTP-Antwortheader bereitgestellt wird. Weitere Informationen zur Verwendung von Markierungen und der Benachrichtigungswarteschlange finden Sie unter So wird's gemacht: Verwenden der Benachrichtigungswarteschlange mit lokalen Benachrichtigungen. Weitere Informationen zur Verwendung des X-WNS-Tag-HTTP-Antwortheaders bei Benachrichtigungen finden Sie unter TileUpdater.startPeriodicUpdateBatch.


var notifications = Windows.UI.Notifications;                        
var recurrence = notifications.PeriodicUpdateRecurrence.hour;

notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdateBatch(urisToPoll, recurrence);

Zusammenfassung und nächste Schritte

In dieser Schnellstartanleitung wurde die Einrichtung einer regelmäßigen Kachelbenachrichtigung erläutert.Dieses Verfahren kann auch für Signale verwendet werden.