AppBroadcastBackgroundService Klasse

Definition

Namespace:

Windows.Media.Capture

Stellt eine Schnittstelle zwischen der Broadcast-UWP-App und dem vom System gehosteten Broadcastdienst bereit. Diese Klasse bietet Zugriff auf Objekte, die die Authentifizierung des Broadcastdiensts erleichtern, die Bandbreitenfunktionen des Geräts internets für den Rundfunkanbieterdienst testen und es Ihrer Aufgabe ermöglichen, aufgezeichnete Audio- und Videoframes zu erfassen, sodass sie an den Rundfunkanbieterdienst gesendet werden können.

Hinweis

Diese API erfordert die Funktionen appBroadcast und appBroadcastSettings , die nicht für alle Windows-Apps verfügbar sind. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser API zur Laufzeit fehl.

public ref class AppBroadcastBackgroundService sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Media.Capture.AppBroadcastContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppBroadcastBackgroundService final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Media.Capture.AppBroadcastContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppBroadcastBackgroundService

Public NotInheritable Class AppBroadcastBackgroundService

Vererbung

Object Platform::Object IInspectable AppBroadcastBackgroundService

Attribute

ContractVersionAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows Desktop Extension SDK (eingeführt in 10.0.15063.0)
API contract	Windows.Media.Capture.AppBroadcastContract (eingeführt in v1.0)
App-Funktionen	appBroadcast appBroadcastSettings

Hinweise

Rufen Sie eine instance dieser Klasse ab, indem Sie die TriggerDetails-Eigenschaft des IBackgroundTaskInstance-Objekts an die Run-Methode Ihrer Hintergrundaufgabe an eine AppBroadcastTriggerDetails-Instanz umwandeln und dann auf die BackgroundService-Eigenschaft zugreifen.

Diese API löst möglicherweise einen Fehler aus, wenn der Hintergrunddienst aufgrund eines Leerlauftimeouts heruntergefahren wurde.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1709	16299	BroadcastChannel
1709	16299	BroadcastChannelChanged
1709	16299	BroadcastLanguage
1709	16299	BroadcastLanguageChanged
1709	16299	BroadcastTitleChanged

Eigenschaften

AppId	Ruft eine Zeichenfolge ab, die einen Bezeichner für das übertragene Spiel enthält. Bei der Übertragung auf einem Desktopgerät ist dieser Wert das Spiel, für das der Benutzer die Übertragung initiiert hat.
BroadcastChannel	Ruft eine Zeichenfolge ab, die den Namen des aktuellen Broadcastkanals enthält.
BroadcastLanguage	Ruft eine Zeichenfolge ab, die die Sprache des aktuellen Broadcastkanals darstellt.
BroadcastTitle	Ruft eine Zeichenfolge ab, die den vom Benutzer angegebenen Titel der Übertragung enthält.
PlugInState	Ruft einen Wert ab, der den aktuellen Zustand der Broadcast-Hintergrundaufgabe angibt, oder legt diese fest.
SignInInfo	Ruft ein -Objekt ab, das die Anmeldeinformationen für den App-Broadcast-Hintergrunddienst darstellt.
StreamInfo	Ruft ein -Objekt ab, das den Streamstatus des App-Broadcast-Hintergrunddiensts verwaltet.
TitleId	Ruft einen eindeutigen Bezeichner für den übertragenen Titel ab.
ViewerCount	Ruft die Anzahl der Zuschauer der Übertragung ab oder legt sie fest.

Methoden

TerminateBroadcast(AppBroadcastTerminationReason, UInt32)

Beendet eine Übertragung.

Ereignisse

BroadcastChannelChanged	Tritt auf, wenn sich der Wert der BroadcastChannel-Eigenschaft ändert.
BroadcastLanguageChanged	Tritt auf, wenn sich der Wert der BroadcastLanguage-Eigenschaft ändert.
BroadcastTitleChanged	Tritt auf, wenn sich der Wert der BroadcastTitle-Eigenschaft ändert.
HeartbeatRequested	Wird vom System in regelmäßigen Abständen ausgelöst, um zu bestätigen, dass die Hintergrundaufgabe für die Übertragung derzeit aktiv ist.