Signalbenachrichtigungen für Windows-Apps

  • Artikel
Eine Kachel mit einem numerischen Signal, das die Zahl 63 anzeigt, um 63 ungelesene E-Mails anzugeben.
Eine Kachel, die mit dem numerischen Signal „63“
auf 63 ungelesene E-Mails hinweist.

Ein Benachrichtigungssignal enthält eine Zusammenfassung oder Statusinformationen für Ihre App. Diese Informationen können numerisch (1–99) oder eine Gruppe der vom System bereitgestellten Glyphen sein. Beispiele für Informationen, die am besten über ein Signal vermittelt werden, sind der Netzwerkverbindungsstatus in einem Onlinespiel, der Benutzerstatus in einer Nachrichten-App, die Anzahl ungelesener Nachrichten in einer E-Mail-App und die Anzahl neuer Beiträge in einer Social-Media-App.

Benachrichtigungssignale werden unabhängig davon, ob die App gerade ausgeführt wird, auf dem Taskleisten-Symbol Ihrer App und in der unteren rechten Ecke der zugehörigen Kachel angezeigt. Signale können auf allen Kachelgrößen angezeigt werden.

Hinweis

Es ist nicht möglich, ein eigenes Signalbild bereitzustellen. Sie können nur die vom System bereitgestellten Signalbilder verwenden.

Numerische Signale

Wert Badge XML
Eine Zahl zwischen 1 und 99 Ein Nullwert entspricht dem Glyphenwert "none" und führt dazu, dass das Signal gelöscht wird. Ein numerisches Signal unter 100 <badge value="1"/>
Eine beliebige Zahl über 99 Ein numerisches Signal über 99 <badge value="100"/>

Glyphensignale

Anstelle einer Zahl kann in einem Signal eine der nicht erweiterbaren Statusglyphen angezeigt werden.

Status Glyphe XML
Keine (Es wird kein Signal angezeigt.) <badge value="none"/>
activity <badge value="activity"/>
Alarm <badge value="alarm"/>
Warnung <badge value="alert"/>
Achtung <badge value="attention"/>
verfügbar <badge value="available"/>
abwesend <badge value="away"/>
beschäftigt <badge value="busy"/>
error <badge value="error"/>
newMessage <badge value="newMessage"/>
angehalten <badge value="paused"/>
Wiedergabe <badge value="playing"/>
nicht verfügbar <badge value="unavailable"/>

Erstellen eines Signals

In diesen Beispielen wird gezeigt, wie Sie ein Badgeupdate erstellen.

Erstellen eines numerischen Signals

private void setBadgeNumber(int num)
{

    // Get the blank badge XML payload for a badge number
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeNumber);

    // Set the value of the badge in the XML to our number
    XmlElement badgeElement = badgeXml.SelectSingleNode("/badge") as XmlElement;
    badgeElement.SetAttribute("value", num.ToString());

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

Erstellen eines Glyphensignals

private void updateBadgeGlyph()
{
    string badgeGlyphValue = "alert";

    // Get the blank badge XML payload for a badge glyph
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeGlyph);

    // Set the value of the badge in the XML to our glyph value
    Windows.Data.Xml.Dom.XmlElement badgeElement = 
        badgeXml.SelectSingleNode("/badge") as Windows.Data.Xml.Dom.XmlElement;
    badgeElement.SetAttribute("value", badgeGlyphValue);

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

Löschen eines Signals

private void clearBadge()
{
    BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();
}

Beispielcode herunterladen

  • Benachrichtigungsbeispiel
    Zeigt, wie Sie Live-Kacheln erstellen, Signalupdates senden und Popupbenachrichtigungen anzeigen können.