WebSocketKeepAlive Klasse

Definition

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

Vererbung

Object Platform::Object IInspectable WebSocketKeepAlive

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IBackgroundTask

Windows-Anforderungen

Hinweise

Die WebSocketKeepAlive-Klasse wird in Verbindung mit der ControlChannelTrigger-Klasse und verwandten Schnittstellen verwendet, um den Echtzeitnetzwerkstatus und Trigger für die StreamWebSocket - und MessageWebSocket-Klassen zu ermöglichen. Steuerkanaltrigger werden von lang ausgeführten Netzwerk-Apps verwendet, um die Netzwerk- und Systemressourcennutzung zu minimieren. Netzwerktrigger ermöglichen es einer App, einen Energiesparmodus für Zeiträume abzulegen, während die etablierten Netzwerkverbindungen intakt bleiben, aber in einem Energiesparzustand bleiben. Eine App kann einen Keep-Alive-Trigger festlegen, der vom System verwendet wird, 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 soll (z. B. aktiv drucken, auf einen Audiodatenstrom zugreifen und Dateien im Hintergrund übertragen). Die ControlChannelTrigger-Klasse ermöglicht eine Netzwerk-App, die eine WebSocket-Verbindung eingerichtet hat, um das System zu benachrichtigen, dass die Netzwerkverbindung betriebsbereit gehalten werden soll und dass das System die angehaltene App aufwachen soll, wenn Netzwerkdaten für die App empfangen werden oder ein WebSocket-Keep-Alive-Paket senden.

WebSocketKeepAlive wird als TaskEntryPoint für einen 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, erfahren Sie, wie Sie Optionen für die Hintergrundkonnektivität festlegen.

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