Share via

알림 헤더

  • 아티클

알림에서 알림 헤더를 사용하여 알림 센터 내부의 관련 알림 세트를 시각적으로 그룹화할 수 있습니다.

Important

Desktop Fall Creators Update 및 알림 라이브러리 1.4.0 필요: 알림 머리글을 보려면 Desktop 빌드 15063 이상을 실행해야 합니다. UWP 커뮤니티 도구 키트 알림 NuGet 라이브러리 버전 1.4.0 이상을 사용하여 알림 콘텐츠에서 머리글을 생성해야 합니다. 헤더만 데스크톱에서 지원됩니다.

아래와 같이 이 그룹 대화는 단일 헤더 'Camping!!'에서 통합됩니다. 대화의 각 개별 메시지는 동일한 알림 헤더를 공유하는 별도의 알림 메시지입니다.

Toasts with header

또한 항공편 미리 알림, 패키지 추적 등과 같은 범주별로 알림을 시각적으로 그룹화할 수도 있습니다.

알림에 헤더 추가

다음은 알림 메시지에 헤더를 추가하는 방법입니다.

참고 항목

헤더만 데스크톱에서 지원됩니다. 헤더를 지원하지 않는 디바이스는 간단히 헤더를 무시합니다.

new ToastContentBuilder()
    .AddHeader("6289", "Camping!!", "action=openConversation&id=6289")
    .AddText("Anyone have a sleeping bag I can borrow?");

요약하면 다음과 같습니다.

  1. ToastContent에 헤더 추가
  2. 필요한 Id, 제목, 인 속성 할당
  3. 알림 보내기(자세히 알아보기)
  4. 다른 알림에서 동일한 헤더 Id을 사용하여 헤더에서 통일합니다. Id는 알림이 그룹화되어야 하는지를 결정하는 데 사용되는 유일한 속성입니다. 즉 제목과 인수는 다를 수 있습니다. 그룹에서 최근 알림의 제목 및 인수를 사용합니다. 해당 알림이 제거되면 제목 및 인수는 다음 가장 최근 알림으로 대체됩니다.

헤더에서 활성화 처리

헤더는 사용자가 클릭할 수 있으므로, 사용자가 헤더를 클릭하면 앱에서 더 많은 정보를 찾을 수 있습니다.

따라서 앱은 알림 자체의 시작 인수와 마찬가지로 헤더에서 인수를 제공할 수 있습니다.

활성화는 기본 알림 활성화와 동일하게 처리됩니다. 즉, App.xaml.cs의 OnActivated 메서드에서 이러한 인수를 검색할 수 있으며, 이는 사용자가 알림 본문이나 알림의 단추를 클릭할 때의 작업과 같습니다.

protected override void OnActivated(IActivatedEventArgs e)
{
    // Handle toast activation
    if (e is ToastNotificationActivatedEventArgs)
    {
        // Arguments specified from the header
        string arguments = (e as ToastNotificationActivatedEventArgs).Argument;
    }
}

추가 정보

헤더는 시각적으로 알림을 구분하고 그룹화합니다. 앱에 포함될 수 있는 최대 알림 개수(20개) 및 알림 목록의 FIFO(선입 선출) 동작에 대한 다른 계획은 변경하지 않습니다.

헤더 내의 알림 순서는 다음과 같습니다. 지정된 앱의 경우 이 앱에서 가장 최근의 알림(헤더의 일부인 경우 전체 헤더 그룹)이 먼저 표시됩니다.

Id는 선택한 문자열일 수 있습니다. ToastHeader의 속성에는 길이 또는 문자 제한이 없습니다. 유일한 제약 조건은 전체 XML 알림 콘텐츠가 5KB를 초과할 수 없다는 것입니다.

헤더를 만들면 '자세한 내용' 단추가 표시되기 전에 알림 센터에 표시되는 알림 개수가 변경되지 않습니다. 이 개수는 기본적으로 3개이며 알림용 시스템 설정에서 각 앱별로 사용자가 구성할 수 있습니다.

앱 이름을 클릭하는 것처럼 헤더를 클릭해도 이 헤더에 속한 알림이 삭제되지 않습니다(앱에서 관련 알림을 지우려면 알림 API 사용).