WebSocketKeepAlive Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет возможность отправки протокола WebSocket в подключенном webSocket.
public ref class WebSocketKeepAlive sealed : IBackgroundTask
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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 WebSocketKeepAlive final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 WebSocketKeepAlive : 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
- Наследование
- Атрибуты
- Реализации
Требования к 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. |