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 фоновой задачи получает экземпляр задачи со сведениями о триггере уведомления. Свойство 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

Возвращает логическое значение, указывающее, что фоновая задача должна обновить число плиток приложения для сообщения.

Применяется к