ChatMessageNotificationTriggerDetails 클래스

정의

네임스페이스:

Windows.ApplicationModel.Chat

등록된 백그라운드 작업에서 트리거되는 메시지 알림을 나타냅니다. 채팅 앱은 작업 트리거 및 작업 진입점을 설정하여 들어오는 메시지의 알림을 받거나 이벤트를 보낼 수 있습니다.

public ref class ChatMessageNotificationTriggerDetails sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ChatMessageNotificationTriggerDetails final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ChatMessageNotificationTriggerDetails

Public NotInheritable Class ChatMessageNotificationTriggerDetails

상속

Object Platform::Object IInspectable ChatMessageNotificationTriggerDetails

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
앱 기능	chat chatSystem smsSend

설명

채팅 앱은 들어오는 메시지의 기본 처리기로 사용하려면 백그라운드 작업을 등록하여 알림을 처리해야 합니다. 백그라운드 작업을 등록하려면 Package.appxmanifest 파일에 백그라운드 작업 확장 프로그램이 포함되어야 합니다. 요소에 다음 코드 조각을 Application/Extensions 추가합니다.

<Extension Category="windows.backgroundTasks" Entry-Point="Tasks.ExampleBackgroundTask">
    <BackgroundTasks>
        <Task Type="chatMessageNotification"/>
        <Task Type="systemEvent"/>
    </BackgroundTasks>
</Extension>

백그라운드 작업의 Run 메서드는 알림 트리거 세부 정보가 포함된 작업 instance 받습니다. TriggerDetails 속성은 ChatMessageNotificationTriggerDetails 개체로 캐스팅됩니다. 채팅 메시지에 대한 트리거 세부 정보는 다음 예제와 같이 가져옵니다.

public void Run(IBackgroundTaskInstance taskInstance)
{
    BackgroundTaskDeferral deferral = taskInstance.GetDeferral();
    ChatMessageNotificationTriggerDetails triggerDetails =
        (ChatMessageNotificationTriggerDetails) taskInstance.TriggerDetails;

    if (triggerDetails != null)
    {
        SendToast(triggerDetails.ChatMessage);
    }
}

속성

ChatMessage	알림과 연결된 메시지를 가져옵니다. 수신 메시지 또는 송신 상태 이벤트가 있는 나가는 메시지입니다.
ShouldDisplayToast	백그라운드 작업이 메시지에 대한 알림 메시지를 실행해야 하는지 여부를 나타내는 부울 값을 가져옵니다.
ShouldUpdateActionCenter	Windows 알림 센터를 메시지로 업데이트해야 하는지 여부를 나타내는 부울 값을 가져옵니다.
ShouldUpdateBadge	백그라운드 작업이 앱의 잠금 화면 수를 업데이트해야 하는지 여부를 나타내는 부울 값을 가져옵니다.
ShouldUpdateDetailText	백그라운드 작업이 메시지에 대한 앱의 타일 수를 업데이트해야 함을 나타내는 부울 값을 가져옵니다.