WebSocketKeepAlive Clase

Definición

Espacio de nombres:

Windows.Networking.Sockets

Proporciona la capacidad de enviar un protocolo WebSocket keep-alive en un WebSocket conectado.

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

Herencia

Object Platform::Object IInspectable WebSocketKeepAlive

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IBackgroundTask

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La clase WebSocketKeepAlive se usa junto con la clase ControlChannelTrigger y las interfaces relacionadas para habilitar el estado y los desencadenadores de red en tiempo real para las clases StreamWebSocket y MessageWebSocket . Las aplicaciones de red de larga duración usan desencadenadores de canal de control para minimizar el uso de recursos de red y del sistema. Los desencadenadores de red permiten que una aplicación se coloque en un modo de bajo consumo durante períodos de tiempo mientras se mantienen intactas las conexiones de red establecidas, pero en un estado de bajo consumo. Una aplicación puede establecer un desencadenador keep-alive usado por el sistema para cuando la aplicación se desencadene y envíe un paquete keep-alive de WebSocket.

Normalmente, una aplicación para UWP se suspende cuando ya no está en primer plano. Hay algunas excepciones en las que una aplicación no debe suspenderse (impresión activa, acceso a una secuencia de audio y transferencia de archivos en segundo plano, por ejemplo). La clase ControlChannelTrigger permite que una aplicación de red que haya establecido una conexión WebSocket notifique al sistema que la conexión de red debe mantenerse operativa y que el sistema debe reactivar la aplicación suspendida cuando se reciben datos de red para la aplicación o enviar un paquete keep-alive de WebSocket.

WebSocketKeepAlive se usa como TaskEntryPoint para mantenerse activo en ControlChannelTrigger. Un desarrollador tendrá que escribir código para controlar la recepción de datos.

Para obtener más información sobre cómo suspender y despertar una aplicación, Cómo establecer las opciones de conectividad en segundo plano.

Para obtener más información sobre los marcos de control keep-alive de WebSocket, consulte el protocolo WebSocket.

Constructores

WebSocketKeepAlive()

Crea un nuevo objeto WebSocketKeepAlive .

Métodos

Run(IBackgroundTaskInstance)

Envía un protocolo WebSocket keep-alive en un WebSocket conectado.