WebSocketKeepAlive Класс

Определение

Пространство имен:

Windows.Networking.Sockets

Предоставляет возможность отправки протокола WebSocket в подключенном webSocket.

public ref class WebSocketKeepAlive sealed : IBackgroundTask

/// [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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class WebSocketKeepAlive final : IBackgroundTask

[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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WebSocketKeepAlive : IBackgroundTask

Public NotInheritable Class WebSocketKeepAlive
Implements IBackgroundTask

Наследование

Object Platform::Object IInspectable WebSocketKeepAlive

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

IBackgroundTask

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Класс WebSocketKeepAlive используется в сочетании с классом ControlChannelTrigger и связанными интерфейсами для включения состояния сети в режиме реального времени и триггеров для классов StreamWebSocket и MessageWebSocket . Триггеры канала управления используются длительными сетевыми приложениями, чтобы свести к минимуму использование сетевых и системных ресурсов. Сетевые триггеры позволяют приложению переключиться в режим с низким энергопотреблением в течение определенного периода времени, сохраняя при этом установленные сетевые подключения без изменений, но в состоянии с низким энергопотреблением. Приложение может задать триггер поддержания активности, используемый системой для того, когда приложение должно проснуться и отправить пакет WebSocket для поддержания активности.

Приложение UWP обычно приостанавливается, когда оно больше не находится на переднем плане. Существуют исключения, в которых приложение не должно быть приостановлено (например, при активной печати, доступе к звуковому потоку и передаче файлов в фоновом режиме). Класс ControlChannelTrigger позволяет сетевому приложению, которое установило подключение WebSocket, уведомлять систему о том, что сетевое подключение должно поддерживаться и что система должна разбудить приостановленное приложение при получении сетевых данных для приложения или отправить пакет WebSocket для поддержания активности.

WebSocketKeepAlive используется в качестве TaskEntryPoint для поддержания активности в ControlChannelTrigger. Разработчику потребуется написать код для обработки получения данных.

Дополнительные сведения о приостановке и пробуждении приложения см. в статье Настройка параметров фонового подключения.

Дополнительные сведения о кадрах элементов управления WebSocket для поддержания активности см. в разделе Протокол WebSocket.

Конструкторы

WebSocketKeepAlive()

Создает новый объект WebSocketKeepAlive .

Методы

Run(IBackgroundTaskInstance)

Отправляет протокол WebSocket в подключенном webSocket.