다음을 통해 공유


AppBroadcastBackgroundService 클래스

정의

브로드캐스트 UWP 앱과 시스템 호스팅 브로드캐스트 서비스 간의 인터페이스를 제공합니다. 이 클래스는 브로드캐스트 서비스 인증을 용이하게 하는 개체에 대한 액세스를 제공하고, 디바이스 인터넷의 대역폭 기능을 브로드캐스트 공급자 서비스로 테스트하고, 캡처된 오디오 및 비디오 프레임을 획득하여 브로드캐스트 공급자 서비스로 보낼 수 있도록 합니다.

참고

이 API에는 모든 Windows 앱에서 사용할 수 없는 appBroadcastappBroadcastSettings 기능이 필요합니다. 개발자 계정이 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 속성에 액세스하여 이 클래스의 instance 가져옵니다.

이 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

시스템에서 정기적으로 발생하여 브로드캐스팅 백그라운드 작업이 현재 활성 상태인지 확인합니다.

적용 대상