WebSocketKeepAlive Klasse

Definition

Namespace:

Windows.Networking.Sockets

Bietet die Möglichkeit, ein WebSocket-Protokoll keep-alive auf einem verbundenen WebSocket zu senden.

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

Vererbung

Object Platform::Object IInspectable WebSocketKeepAlive

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IBackgroundTask

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die WebSocketKeepAlive-Klasse wird in Verbindung mit der ControlChannelTrigger-Klasse und zugehörigen Schnittstellen verwendet, um Echtzeitnetzwerk-status und Trigger für die StreamWebSocket- und MessageWebSocket-Klassen zu aktivieren. Steuerungskanaltrigger werden von Netzwerk-Apps mit langer Laufzeit verwendet, um die Netzwerk- und Systemressourcennutzung zu minimieren. Netzwerktrigger ermöglichen es einer App, für einige Zeit in einen Energiesparmodus zu wechseln, während die bestehenden Netzwerkverbindungen intakt bleiben, aber sich in einem Zustand mit geringer Leistung befinden. Eine App kann einen vom System verwendeten Keep-Alive-Trigger festlegen, wenn die App aufwachen und ein WebSocket-Keep-Alive-Paket senden soll.

Eine UWP-App wird normalerweise angehalten, wenn sie sich nicht mehr im Vordergrund befindet. Es gibt einige Ausnahmen, bei denen eine App nicht angehalten werden sollte (z. B. aktiv drucken, auf einen Audiodatenstrom zugreifen und Dateien im Hintergrund übertragen). Die ControlChannelTrigger-Klasse ermöglicht es einer Netzwerk-App, die eine WebSocket-Verbindung hergestellt hat, das System zu benachrichtigen, dass die Netzwerkverbindung betriebsbereit bleiben soll und dass das System die angehaltene App aktivieren soll, wenn Netzwerkdaten für die App empfangen oder ein WebSocket-Keep-Alive-Paket gesendet wird.

WebSocketKeepAlive wird als TaskEntryPoint für ein Keep-Alive in ControlChannelTrigger verwendet. Ein Entwickler muss Code schreiben, um den Empfang von Daten zu verarbeiten.

Weitere Informationen zum Anhalten und Aufwachen einer App finden Sie unter Festlegen von Optionen für Die Hintergrundkonnektivität.

Weitere Informationen zu den WebSocket Keep-Alive-Steuerelementframes finden Sie im WebSocket-Protokoll.

Konstruktoren

WebSocketKeepAlive()

Erstellt ein neues WebSocketKeepAlive-Objekt .

Methoden

Run(IBackgroundTaskInstance)

Sendet ein WebSocket-Protokoll, das auf einem verbundenen WebSocket beibehalten wird.