WebSocketKeepAlive Classe

Definição

Namespace:

Windows.Networking.Sockets

Fornece a capacidade de enviar um protocolo WebSocket keep alive em um 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

Herança

Object Platform::Object IInspectable WebSocketKeepAlive

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IBackgroundTask

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

A classe WebSocketKeepAlive é usada em conjunto com a classe ControlChannelTrigger e interfaces relacionadas para habilitar status de rede em tempo real e gatilhos para as classes StreamWebSocket e MessageWebSocket. Os gatilhos de canal de controle são usados por aplicativos de rede de longa execução para minimizar o uso de recursos de rede e sistema. Os gatilhos de rede permitem que um aplicativo seja movido para um modo de baixa potência por períodos de tempo, mantendo as conexões de rede estabelecidas intactas, mas em um estado de baixa energia. Um aplicativo pode definir um gatilho keep alive usado pelo sistema para quando o aplicativo deve ativar e enviar um pacote keep alive do WebSocket.

Um aplicativo UWP normalmente é suspenso quando não está mais em primeiro plano. Há algumas exceções em que um aplicativo não deve ser suspenso (imprimir ativamente, acessar um fluxo de áudio e transferir arquivos em segundo plano, por exemplo). A classe ControlChannelTrigger permite que um aplicativo de rede que estabeleceu uma conexão WebSocket notifique o sistema de que a conexão de rede deve ser mantida operacional e que o sistema deve ativar o aplicativo suspenso quando os dados de rede forem recebidos para o aplicativo ou enviar um pacote keep alive do WebSocket.

WebSocketKeepAlive é usado como TaskEntryPoint para um keep alive em ControlChannelTrigger. Um desenvolvedor precisará escrever código para lidar com o recebimento de dados.

Para obter mais informações sobre como suspender e ativar um aplicativo, Como definir opções de conectividade em segundo plano.

Para obter mais informações sobre os quadros de controle keep alive do WebSocket, consulte o Protocolo WebSocket.

Construtores

WebSocketKeepAlive()

Cria um novo objeto WebSocketKeepAlive .

Métodos

Run(IBackgroundTaskInstance)

Envia um protocolo WebSocket keep alive em um WebSocket conectado.