WebSocketKeepAlive Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece a capacidade de enviar um protocolo WebSocket keep alive em um WebSocket conectado.
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
- Herança
- Atributos
- Implementações
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. |