AppBroadcastBackgroundService 類別

定義

命名空間:

Windows.Media.Capture

提供廣播 UWP app 與系統裝載廣播服務之間的介面。 這個類別可讓您存取可協助廣播服務驗證的物件、測試裝置網際網路對廣播提供者服務的頻寬功能，並允許工作取得擷取的音訊和視訊畫面，以便將它們傳送給廣播提供者服務。

注意

此 API 需要 appBroadcast 和 appBroadcastSettings 功能，這不適用於所有 Windows 應用程式。 除非您的開發人員帳戶是由 Microsoft 特別布建，否則對此 API 的呼叫會在執行時間失敗。

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

繼承

Object Platform::Object IInspectable AppBroadcastBackgroundService

屬性

ContractVersionAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows Desktop Extension SDK (已於 10.0.15063.0 引進)
API contract	Windows.Media.Capture.AppBroadcastContract (已於 v1.0 引進)
應用程式功能	appBroadcast appBroadcastSettings

備註

將傳遞至背景工作Run方法的IBackgroundTaskInstance的 TriggerDetails屬性轉換成AppBroadcastTriggerDetails，然後存取BackgroundService屬性，以取得這個類別的實例。

如果背景服務因為閒置逾時而關閉，此 API 可能會擲回錯誤。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1709	16299	BroadcastChannel
1709	16299	BroadcastChannelChanged
1709	16299	BroadcastLanguage
1709	16299	BroadcastLanguageChanged
1709	16299	BroadcastTitleChanged

屬性

AppId	取得字串，其中包含正在廣播之遊戲的識別碼。 在桌面裝置上廣播時，此值是使用者起始廣播的遊戲。
BroadcastChannel	取得包含目前廣播通道名稱的字串。
BroadcastLanguage	取得字串，表示目前廣播通道的語言。
BroadcastTitle	取得包含廣播使用者指定標題的字串。
PlugInState	取得或設定值，指定廣播背景工作的目前狀態。
SignInInfo	取得 物件，表示應用程式廣播背景服務的登入資訊。
StreamInfo	取得 物件，這個物件會管理應用程式廣播背景服務的資料流程狀態。
TitleId	取得要廣播之標題的唯一識別碼。
ViewerCount	取得或設定廣播的檢視者數目。

方法

TerminateBroadcast(AppBroadcastTerminationReason, UInt32)

終止廣播。

事件

BroadcastChannelChanged	當 BroadcastChannel 屬性的值變更時發生。
BroadcastLanguageChanged	當 BroadcastLanguage 屬性的值變更時發生。
BroadcastTitleChanged	當 BroadcastTitle 屬性的值變更時發生。
HeartbeatRequested	由系統定期引發，以確認廣播背景工作目前為作用中。