AppBroadcastBackgroundService Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece uma interface entre o aplicativo UWP de difusão e o serviço de difusão hospedado pelo sistema. Essa classe fornece acesso a objetos que facilitam a autenticação do serviço de difusão, testam os recursos de largura de banda da Internet do dispositivo para o serviço de provedor de difusão e permitem que sua tarefa adquira quadros de áudio e vídeo capturados para que possam ser enviados para o serviço de provedor de difusão.
Observação
Essa API requer a funcionalidade appBroadcast e appBroadcastSettings que não está disponível para todos os aplicativos do Windows. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essa API falharão em runtime.
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
- Herança
- Atributos
Requisitos do Windows
Família de dispositivos |
Windows Desktop Extension SDK (introduzida na 10.0.15063.0)
|
API contract |
Windows.Media.Capture.AppBroadcastContract (introduzida na v1.0)
|
Funcionalidades do aplicativo |
appBroadcast
appBroadcastSettings
|
Comentários
Obtenha uma instância dessa classe convertendo a propriedade TriggerDetails do IBackgroundTaskInstance passado para o método Run da tarefa em segundo plano para um AppBroadcastTriggerDetails e acessando a propriedade BackgroundService .
Essa API poderá gerar um erro se o serviço em segundo plano tiver sido desligado devido ao tempo limite ocioso.
Histórico de versão
Versão do Windows | Versão do SDK | Valor adicionado |
---|---|---|
1.709 | 16299 | BroadcastChannel |
1.709 | 16299 | BroadcastChannelChanged |
1.709 | 16299 | BroadcastLanguage |
1.709 | 16299 | BroadcastLanguageChanged |
1.709 | 16299 | BroadcastTitleChanged |
Propriedades
AppId |
Obtém uma cadeia de caracteres que contém um identificador para o jogo que está sendo transmitido. Ao transmitir em um dispositivo de área de trabalho, esse valor é o jogo no qual o usuário iniciou a transmissão. |
BroadcastChannel |
Obtém uma cadeia de caracteres que contém o nome do canal de transmissão atual. |
BroadcastLanguage |
Obtém uma cadeia de caracteres que representa o idioma do canal de transmissão atual. |
BroadcastTitle |
Obtém uma cadeia de caracteres que contém o título especificado pelo usuário da transmissão. |
PlugInState |
Obtém ou define um valor que especifica o estado atual da tarefa em segundo plano de difusão. |
SignInInfo |
Obtém um objeto que representa as informações de entrada para o serviço em segundo plano de transmissão do aplicativo. |
StreamInfo |
Obtém um objeto que gerencia o estado de fluxo do serviço em segundo plano de transmissão do aplicativo. |
TitleId |
Obtém um identificador exclusivo para o título que está sendo transmitido. |
ViewerCount |
Obtém ou define o número de visualizadores da transmissão. |
Métodos
TerminateBroadcast(AppBroadcastTerminationReason, UInt32) |
Encerra uma transmissão. |
Eventos
BroadcastChannelChanged |
Ocorre quando o valor da propriedade BroadcastChannel é alterado. |
BroadcastLanguageChanged |
Ocorre quando o valor da propriedade BroadcastLanguage é alterado. |
BroadcastTitleChanged |
Ocorre quando o valor da propriedade BroadcastTitle é alterado. |
HeartbeatRequested |
Gerado pelo sistema periodicamente para confirmar que a tarefa em segundo plano de difusão está ativa no momento. |