AppBroadcastBackgroundService 类

定义

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

注意

此 API 需要 appBroadcastappBroadcastSettings 功能,此功能并非对所有 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
属性

Windows 要求

设备系列
Windows Desktop Extension SDK (在 10.0.15063.0 中引入)
API contract
Windows.Media.Capture.AppBroadcastContract (在 v1.0 中引入)
应用功能
appBroadcast appBroadcastSettings

注解

通过将传递到后台任务的 Run 方法的 IBackgroundTaskInstanceTriggerDetails 属性转换为 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

由系统定期引发,以确认广播后台任务当前处于活动状态。

适用于