AppBroadcastBackgroundService 类

定义

命名空间:

Windows.Media.Capture

提供广播 UWP 应用与系统托管的广播服务之间的接口。 此类提供对有助于广播服务身份验证的对象的访问权限，测试设备 Internet 对广播提供商服务的带宽功能，并允许任务获取捕获的音频和视频帧，以便它们可以发送到广播提供商服务。

注意

此 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	由系统定期引发，以确认广播后台任务当前处于活动状态。