ChatMessageNotificationTriggerDetails Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет уведомление о сообщении, активированное из зарегистрированной фоновой задачи. Приложение чата может получать уведомления о входящих сообщениях или отправлять события, задавая триггер задачи и точку входа задачи.
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
- Наследование
- Атрибуты
Требования к 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 |
Возвращает логическое значение, указывающее, что фоновая задача должна обновить число плиток приложения для сообщения. |