Freigeben über


AppBroadcastBackgroundService Klasse

Definition

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

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.

Gilt für: