다음을 통해 공유


Windows 앱에 대한 배지 알림

알림 배지는 앱과 관련된 요약 또는 상태 정보를 전달합니다. 숫자(1-99) 또는 시스템 제공 문자 모양 집합 중 하나일 수 있습니다. 배지를 통해 가장 잘 전달되는 정보의 예시로는 온라인 게임의 네트워크 연결 상태, 메시징 앱의 사용자 상태, 메일 앱에서 읽지 않은 메일 수, 소셜 미디어 앱의 새 게시물 수 등이 있습니다.

알림 배지는 앱 실행 여부와 관계없이 앱의 작업 표시줄 아이콘과 시작 타일의 오른쪽 아래 모서리에 표시됩니다. 배지는 모든 타일 크기에 표시할 수 있습니다.

Note

사용자 고유의 배지 이미지를 제공할 수 없습니다. 시스템 제공 배지 이미지만 사용할 수 있습니다.

Numeric badges

Value Badge XML
1~99 사이의 숫자입니다. 0의 값은 글리프 값 "none"과 동일하며 배지를 삭제합니다. 100 미만의 숫자 배지입니다. <badge value="1"/>
99보다 큰 모든 숫자 99보다 큰 숫자 배지입니다. <badge value="100"/>

Glyph badges

배지는 숫자 대신 확장할 수 없는 상태 문자 모양 집합 중 하나를 표시할 수 있습니다.

Status Glyph XML
none (표시되는 배지가 없습니다.) <badge value="none"/>
activity '활동' 상태를 나타내는 문자 모양 배지입니다. <badge value="activity"/>
alarm '경보' 상태를 나타내는 문자 모양 배지입니다. <badge value="alarm"/>
alert '경고' 상태를 나타내는 문자 모양 배지입니다. <badge value="alert"/>
attention '주의' 상태를 나타내는 문자 모양 배지입니다. <badge value="attention"/>
available '사용 가능' 상태를 나타내는 문자 모양 배지입니다. <badge value="available"/>
away 'away' 상태를 나타내는 문자 모양 배지입니다. <badge value="away"/>
busy '사용 중' 상태를 나타내는 문자 모양 배지입니다. <badge value="busy"/>
error 'error' 상태를 나타내는 문자 모양 배지입니다. <badge value="error"/>
newMessage 'newMessage' 상태를 나타내는 문자 모양 배지입니다. <badge value="newMessage"/>
paused '일시 중지됨' 상태를 나타내는 문자 모양 배지입니다. <badge value="paused"/>
playing '재생' 상태를 나타내는 문자 모양 배지입니다. <badge value="playing"/>
unavailable '사용할 수 없음' 상태를 나타내는 문자 모양 배지입니다. <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();
}

샘플 코드 가져오기

  • Notifications sample
    라이브 타일을 만들고, 배지 업데이트를 보내고, 토스트 알림을 표시하는 방법을 보여 줍니다.