Language: HTML | XAML

Schnellstart: Senden von Benachrichtigungen an eine sekundäre Kachel (Windows-Runtime-Apps mit C#/VB/C++ und XAML)

Applies to Windows and Windows Phone

Hinweis  Sie verwenden nicht C#/VB/C++? Siehe Schnellstart: Senden von Benachrichtigungen an eine sekundäre Kachel (Windows Store-Apps mit JavaScript und HTML)

In dieser Schnellstartanleitung wird gezeigt, wie Sie die sekundäre Kachel einer App aktualisieren, indem Sie eine lokale Benachrichtigung senden. Sie werden bemerken, dass der Vorgang zum Senden einer Benachrichtigung an eine sekundäre Kachel mit Ausnahme des letzten Schritts identisch mit dem Vorgang zum Senden einer Benachrichtigung an die Hauptkachel der App ist. Der einzige Unterschied besteht darin, dass Sie bei sekundären Kacheln ein spezielles Kachelupdate für sekundäre Kacheln (createTileUpdaterForSecondaryTile) verwenden.

Unter Beispiel für sekundäre Kacheln wird der in diesem Thema bereitgestellte Code in einem vollständigen Beispiel angewendet. Das Beispiel wird als JavaScript-, C#-, C++- und Visual Basic-Version zur Verfügung gestellt.

Wenn eine App gestartet wird, sollte diese immer ihre sekundären Kacheln aufzählen, um zu überprüfen, ob Kacheln hinzugefügt oder entfernt wurden, ohne dass die App dies erfasst hat. Wenn ein Benutzer eine sekundäre Kachel löscht, entfernt Windows die Kachel lediglich. Die App muss alle von der sekundären Kachel verwendeten Ressourcen freigeben. Wenn Windows sekundäre Kacheln über die Cloud kopiert, werden aktuelle Kachel- oder Signalbenachrichtigungen der sekundären Kachel, geplante Benachrichtigungen, Pushbenachrichtigungskanäle und bei regelmäßigen Benachrichtigungen verwendete URIs (Uniform Resource Identifier) nicht mit der sekundären Kachel kopiert und müssen neu eingerichtet werden.

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 sekundäre Kacheln.

Voraussetzungen

Die Ausführungen in diesem Thema setzen Folgendes voraus:

  • Grundkenntnisse der Begriffe und Konzepte für Kacheln und Benachrichtigungen. Weitere Informationen finden Sie unter Kacheln, Signale und Benachrichtigungen.
  • Kenntnisse des XML-Schemas für Kacheln. Weitere Informationen finden Sie unter Kachelschema.
  • Die Fähigkeit zum Erstellen einer einfachen Windows Store-App mit C#, C++ oder Microsoft Visual Basic mithilfe von Windows-Runtime-APIs. Weitere Informationen finden Sie unter Erstellen Ihrer ersten Windows Store-App mit C# oder Visual Basic.
  • Grundlegendes Verständnis zum Erstellen von CodeBehind für eine Windows Store-App mithilfe von XAML (Extensible Application Markup Language).
  • Kenntnisse in XML und der XML-Bearbeitung über Dokumentobjektmodell (DOM)-APIs.
  • In diesem Thema wird davon ausgegangen, dass Sie bereits eine sekundäre Kachel erstellt und diese an die Startseite angeheftet haben. Eine Anleitung hierzu finden Sie unter Schnellstart: Anheften einer sekundären Kachel.

Anweisungen

1. Hinzufügen von Namespacedeklarationen

Windows.UI.StartScreen enthält die APIs für die sekundäre Kachel. Windows.UI.Notifications enthält die Benachrichtigungs-APIs.



using Windows.UI.Notifications;
using Windows.UI.StartScreen;
using Windows.Data.Xml.Dom;

2. Abrufen einer leeren Kachelvorlage

Für eine sekundäre Kachel kann jede beliebige Kachelvorlage verwendet werden. Hier verwenden wir die Nur-Text-Vorlage TileWide310x150Text04.



XmlDocument tileXml = TileUpdateManager.GetTemplateContent(TileTemplateType.TileWide310x150Text04);

3. Zuweisen von Text zur Benachrichtigung

Die TileWide310x150Text04-Vorlage enthält ein einziges Textelement, dem wir eine Zeichenfolge zuweisen.


   
XmlNodeList tileTextAttributes = tileXml.GetElementsByTagName("text");
tileTextAttributes[0].InnerText = "This text was delivered through a notification";

4. Bereitstellen der quadratischen Version der Benachrichtigung

Es empfiehlt sich, in jeder an eine Kachel gesendeten Benachrichtigungsnutzlast stets eine Bindung für jede von der App unterstützte Kachelgröße anzugeben. Im Rahmen des Anheftungsvorgangs kann der Benutzer aus den von Ihnen bereitgestellten Optionen die Größe der sekundären Kachel auswählen. Wenn Sie in jeder Benachrichtigung eine Bindung für jede dieser Größenoptionen bereitstellen, können Sie sicherstellen, dass Ihre Benachrichtigung unabhängig von der Kachelgröße angezeigt wird. Wenn Sie auch eine große sekundäre Kachel unterstützen, wiederholen Sie diesen und den nächsten Schritt für eine der großen Vorlagen.

  • Applies to Windows Phone

Unter Windows Phone 8.1 werden alle Kacheln als mittelgroße Kacheln angeheftet und können anschließend vom Benutzer vergrößert/verkleinert werden. Dies gilt auch für sekundäre Kacheln.



XmlDocument squareTileXml = TileUpdateManager.GetTemplateContent(TileTemplateType.TileSquare150x150Text04);

XmlNodeList squareTileTextAttributes = squareTileXml.GetElementsByTagName("text");
squareTileTextAttributes[0].AppendChild(squareTileXml.CreateTextNode("This text was delivered through a notification"));

5. Anfügen der quadratischen Benachrichtigung an die Nutzlast der breiten Benachrichtigung



IXmlNode node = tileXml.ImportNode(squareTileXml.GetElementsByTagName("binding").Item(0), true);
tileXml.GetElementsByTagName("visual").Item(0).AppendChild(node);

6. Verpacken der fertigen XML-Datei als Kachelbenachrichtigung



TileNotification tileNotification = new TileNotification(tileXml);

7. Erstellen Sie ein Update für sekundäre Kacheln

Bis zu diesem Schritt ist das Verfahren identisch mit dem für eine Standardkachelbenachrichtigung. In diesem Schritt verwenden wir jedoch die für sekundäre Kacheln spezifische CreateTileUpdaterForSecondaryTile-Methode. Diese Methode erfordert die eindeutige ID der sekundären Zielkachel. Wir gehen in diesem Beispiel davon aus, dass eine sekundäre Kachel mit einer in der Variable appbarTileId gespeicherten ID aktuell an die Startseite geheftet ist.



TileUpdater secondaryTileUpdater = TileUpdateManager.CreateTileUpdaterForSecondaryTile(appbarTileId);

8. Senden der Benachrichtigung an die sekundäre Kachel



secondaryTileUpdater.Update(tile);

9. Optional: Aktualisieren des Logos der sekundären Kachel

Beim Erstellen der sekundären Kachel müssen Sie ein Logobild angeben. Das Logobild – dessen Name daher rührt, dass es normalerweise das Logo einer App zeigt – ist ein Bild in der vollen Kachelgröße, das auf der Kachel angezeigt wird, bevor Benachrichtigungen empfangen werden. Wenn die Benachrichtigung entfernt wird oder abläuft, wird auf der Kachel wieder das Logobild angezeigt. In einigen Szenarien kann es sinnvoll sein, das standardmäßige Logobild zu ändern, z. B. um eine Änderung des angehefteten Inhalts anzuzeigen, wenn Sie kein vollständiges Benachrichtigungsupdate senden möchten. In diesem Schritt wird gezeigt, wie Sie das Logo für die sekundäre Kachel mit einer in der Variable appbarTileId gespeicherten ID anhand eines Bilds aus dem lokalen Speicher der App ändern.



SecondaryTile tileToUpdate = new SecondaryTile(appbarTileId);
tileToUpdate.Logo = new Uri("ms-appx:///Assets/NewSecondaryTileDefaultImage.png");
tileToUpdate.UpdateAsync();

Zusammenfassung und nächste Schritte

In dieser Schnellstartanleitung haben Sie eine Benachrichtigung an eine zugeordnete sekundäre Kachel Ihrer App gesendet. Sie haben gesehen, dass sich die Verfahren zum Senden einer Benachrichtigung an die Hauptkachel der App und zum Senden einer Benachrichtigung an eine sekundäre Kachel nur in einem Punkt unterscheiden. Außerdem haben Sie das standardmäßige Logobild Ihrer sekundären Kachel aktualisiert.

In dieser Schnellstartanleitung wurde das Update für die sekundäre Kachel in Form einer lokalen Benachrichtigung gesendet. Zum Übermitteln von Benachrichtigungen stehen Ihnen außerdem folgende Methoden zur Verfügung: geplante Benachrichtigung, regelmäßige Benachrichtigung und Pushbenachrichtigung. Weitere Informationen finden Sie unter Zustellen von Benachrichtigungen.

Verwandte Themen

Schnellstart: Anheften einer sekundären Kachel
Schnellstart: Senden eines Kachelupdates
Beispiel für sekundäre Kacheln
Übersicht über sekundäre Kacheln
Richtlinien und Prüfliste für sekundäre Kacheln
Kachelschema

 

 

Anzeigen:
© 2014 Microsoft