빠른 시작: 배지 업데이트 보내기(C#/VB/C++ 및 XAML을 사용하는 Windows 스토어 앱)

이 항목에서는 타일에서 배지를 만들고 업데이트하는 방법을 보여 줍니다. 문자 모양 또는 숫자 값을 포함하는 배지 알림을 보내게 됩니다. 타일에서 배지를 제거하는 방법에 대해서도 알아봅니다.

배지는 앱의 상태를 나타내기 위해 타일의 오른쪽 아래(또는 오른쪽에서 왼쪽으로 쓰기 언어의 UI에서는 왼쪽 아래)에 표시되는 숫자 또는 문자 모양입니다. 배지는 타일 자체의 일부가 아니라 타일 위의 오버레이입니다. 배지는 자체 API 및 스키마를 통해 조작되며 자체 알림을 통해 업데이트됩니다. 이 빠른 시작에서는 배지 콘텐츠를 정의하고, 알림을 통해 보내고, 더 이상 필요 없는 경우 콘텐츠를 제거하는 과정을 안내합니다. 이러한 작업은 가장 단순하게 구현할 수 있는 알림인 로컬 알림을 사용하여 설명됩니다.

이 빠른 시작에 제공된 예제의 JavaScript 버전을 보려면 빠른 시작: 배지 업데이트 보내기(JavaScript)를 참조하세요.

참고  이 빠른 시작에서는 XML DOM(문서 개체 모델)에서 직접 알림 콘텐츠를 조작합니다. NotificationsExtensions 라이브러리에서 선택적 접근 방법을 사용할 수 있습니다. 여기에서는 Intellisense를 비롯한 개체 속성으로 XML 콘텐츠를 나타냅니다. 자세한 내용은 빠른 시작: 코드에 NotificationsExtensions 라이브러리 사용을 참조하세요. 이 빠른 시작에서 NotificationsExtenstions를 사용하여 표현된 코드를 보려면 앱 타일 및 배지 샘플을 참조하세요.

사전 요구 사항

이 항목을 이해하기 위해 필요한 항목은 다음과 같습니다.

  • 배지 및 알림 용어와 개념에 대한 기본 지식 자세한 내용은 타일, 배지 및 알림을 참조하세요.
  • 배지 XML 스키마를 사용한 경험 자세한 내용은 배지 스키마를 참조하세요.
  • Windows 런타임 API를 사용하여 C#, C++ 또는 Microsoft Visual Basic으로 기본 Windows 스토어 앱을 만들 수 있는 능력. 자세한 내용은 C# 또는 Visual Basic으로 작성한 첫 번째 Windows 스토어 앱 만들기를 참조하세요.
  • XAML(eXtensible Application Markup Language)을 사용하여 Windows 스토어 앱의 코드 숨김을 만드는 방법에 대한 이해
  • DOM(문서 개체 모델) API에서 XML 사용 및 XML 조작에 대한 경험

지침

1. 네임스페이스 선언 추가

Windows.UI.Notifications에는 배지 API가 포함되어 있습니다.



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

2. 숫자를 표시할지, 문자 모양을 표시할지 선택

배지는 0-99의 숫자 또는 시스템 정의 상태 문자 모양의 집합 중 하나를 표시할 수 있습니다. 배지 선택은 시나리오에 따라 다릅니다. 예를 들어 메일 프로그램에서는 읽지 않은 메일의 수를 표시하거나 새 메일 도착 시 "새 메시지" 문자 모양을 표시할 수 있습니다. 사용 가능한 문자 모양에 대한 자세한 내용은 배지 개요를 참조하세요. 언제 숫자 또는 문자 모양을 사용할지에 대한 자세한 내용은 타일 및 배지에 대한 지침 및 검사 목록을 참조하세요.

숫자 배지 또는 문자 모양 배지는 배지 템플릿의 서로 다른 XML을 통해 정의됩니다. 결정을 내린 배지 유형에 대한 적절한 템플릿을 검색해야 합니다. 이 예제에서는 숫자 배지용 템플릿을 검색합니다.



XmlDocument badgeXml = BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeNumber);

이 예제에서는 문자 모양 배지용 템플릿을 검색합니다.



XmlDocument badgeXml = BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeGlyph);

3. 배지에 값을 할당합니다.

이 예제에서는 템플릿에서 badge 요소를 검색하고 숫자 값을 할당합니다.



XmlElement badgeElement = (XmlElement)badgeXml.SelectSingleNode("/badge");
badgeElement.SetAttribute("value", "7");

이 예제에서는 배지에 문자 모양 값을 할당합니다.



XmlElement badgeElement = (XmlElement)badgeXml.SelectSingleNode("/badge");
badgeElement.SetAttribute("value", "newMessage");

4. 배지 알림을 만들어 배지로 보냅니다.

이 예제에서는 정의한 XML을 알림으로 패키지하고 배지로 보냅니다.



BadgeNotification badge = new BadgeNotification(badgeXml);
BadgeUpdateManager.CreateBadgeUpdaterForApplication().Update(badge);

5. 옵션: 더 이상 유효하지 않은 배지 지우기

배지 숫자 또는 문자 모양을 통해 전달한 정보가 오래되었거나 더 이상 유용하지 않으면 배지를 제거해야 합니다. 다음 코드는 호출 앱의 타일에서 현재 배지를 제거합니다. 이 코드는 로컬 알림을 사용하지만, 타일과는 달리 배지는 클라우드를 통해 지울 수 있습니다.



BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();

이 빠른 시작에서는 앱 타일의 배지에 대해 새로운 내용을 정의하고 보냈으며, 더 이상 유효하지 않은 배지를 제거했습니다.

이 빠른 시작에서는 배지 업데이트를 로컬 알림으로써 보냈습니다. 다른 알림 전달 방법(예약된 알림, 정기 알림 및 푸시 알림)을 탐색할 수도 있습니다. 자세한 내용은 알림 전달을 참조하세요.

관련 항목

배지 개요
배지 스키마
배지에 대해 정기 알림을 설정하는 방법
BadgeTemplateType
BadgeNotification

 

 

표시:
© 2014 Microsoft. All rights reserved.