Windows アプリ向けのバッジ通知

バッジ通知は、アプリに固有の概要情報や状態情報を伝えます。 数値 (1 から 99) またはシステム提供のグリフのセットの 1 つを指定できます。 バッジを通じて最もよく伝わる情報の例としては、オンライン ゲームのネットワーク接続状態、メッセージング アプリのユーザー状態、メール アプリ内の未読メールの数、ソーシャル メディア アプリの新しい投稿の数などがあります。

通知バッジは、アプリが実行されているかどうかに関係なく、アプリのタスク バー アイコンとスタート タイルの右下隅に表示されます。 バッジは、すべてのタイル サイズに表示できます。

数値バッジ

Value	バッジ	XML
1 から 99 までの数値。 値 0 はグリフ値 "none" に相当し、バッジをクリアします。		<badge value="1"/>
99 を超える任意の数。		<badge value="100"/>

グリフ バッジ

バッジには、数値の代わりに、拡張可能でない状態グリフのセットのいずれかを表示できます。

状態	グリフ	XML
なし	(バッジは表示されません。)	<badge value="none"/>
活動		<badge value="activity"/>
警報		<badge value="alarm"/>
アラート		<badge value="alert"/>
注意を求めています		<badge value="attention"/>
使用可能		<badge value="available"/>
留守		<badge value="away"/>
busy		<badge value="busy"/>
エラー		<badge value="error"/>
newMessage		<badge value="newMessage"/>
paused		<badge value="paused"/>
奏法		<badge value="playing"/>
利用不可		<badge value="unavailable"/>

バッジを作成する

以降の例で、バッジの更新を作成する方法を示します。

数値バッジを作成する

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

}

グリフ バッジを作成する

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

}

バッジをクリアする

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

サンプル コードの入手

• 通知のサンプル
  ライブ タイルの作成、バッジの更新の送信、トースト通知の表示方法を示します。

関連記事

• アダプティブ トースト通知と対話型トースト通知
• タイルの作成
• アダプティブ タイルの作成