Compartilhar via

Reproduzir mídia em segundo plano

  • Artigo

Este artigo mostra como configurar seu aplicativo para que a mídia continue a ser reproduzida quando o aplicativo for movido do primeiro para o segundo plano. Isso significa que, mesmo depois que o usuário minimizar o aplicativo, retornar à tela inicial ou sair do aplicativo de alguma outra forma, o aplicativo poderá continuar a reproduzir o áudio.

Os cenários de reprodução de áudio em segundo plano incluem:

  • Playlists de longa duração: o usuário ativa brevemente o aplicativo em primeiro plano para selecionar e iniciar uma playlist, esperando que depois disso a playlist continue sendo reproduzida em segundo plano.

  • Uso do alternador de tarefas: o usuário ativa brevemente um aplicativo em primeiro plano para iniciar a reprodução de áudio e, em seguida, alterna para outro aplicativo aberto usando o alternador de tarefas. O usuário espera que o áudio continue sendo reproduzido em segundo plano.

A implementação de áudio em segundo plano descrita neste artigo permitirá que seu aplicativo seja executado universalmente em todos os dispositivos Windows, incluindo dispositivos móveis, desktop e Xbox.

Observação

O código neste artigo foi adaptado da Amostra de áudio em segundo plano da UWP.

Explicação do modelo de um processo

Com o Windows 10, versão 1607, foi introduzido um novo modelo de processo único que simplifica significativamente o processo para habilitar áudio em segundo plano. Anteriormente, era necessário que o aplicativo gerenciasse um processo em segundo plano além do aplicativo em primeiro plano e comunicasse manualmente as mudanças de estado entre os dois processos. Com o novo modelo, você simplesmente adiciona a funcionalidade de áudio em segundo plano ao manifesto do aplicativo e ele continuará reproduzindo áudio automaticamente quando for movido para o segundo plano. Dois novos eventos de ciclo de vida do aplicativo, EnteredBackground e LeavingBackground permitem que o aplicativo saiba quando ele entra em segundo plano e sai dele. Quando o aplicativo move para as transições de ou para o segundo plano, as restrições de memória impostas pelo sistema podem mudar, portanto, você pode usar esses eventos para verificar o consumo de memória atual e liberar recursos para ficar abaixo do limite.

Eliminando a complexa comunicação entre processos e o gerenciamento de estados, o novo modelo permite que você implemente áudio em segundo plano de forma muito mais rápida, com uma redução significativa no código. No entanto, o modelo de dois processos ainda tem suporte na versão atual para a compatibilidade com versões anteriores. Para saber mais, consulte Modelo de áudio em segundo plano herdado.

Requisitos para áudio em segundo plano

O aplicativo deve atender aos seguintes requisitos para reprodução de áudio enquanto ele estiver em segundo plano.

  • Adicione a funcionalidade Reprodução de Mídia em Segundo Plano ao manifesto do aplicativo, conforme descrito mais adiante neste artigo.
  • Se o aplicativo desabilita a integração automática do MediaPlayer com o Controle de transporte de mídia do sistema (SMTC), como ao definir a propriedade CommandManager.IsEnabled como falsa, então é necessário implementar a integração manual com o SMTC para habilitar a reprodução de mídia em segundo plano. Você também deve integrar-se manualmente ao SMTC se estiver usando uma API diferente do MediaPlayer, como o AudioGraph, para reproduzir áudio se quiser que o áudio continue a ser reproduzido quando o aplicativo for movido para o segundo plano. Os requisitos mínimos de integração do SMTC são descritos na seção "Usar os controles de transporte de mídia do sistema para áudio em segundo plano" do Controle manual dos controles de transporte de mídia do sistema.
  • Enquanto o aplicativo estiver em segundo plano, você deve permanecer dentro dos limites de uso de memória definidos pelo sistema para aplicativos em segundo plano. Neste artigo, são fornecidas orientações para o gerenciamento de memória enquanto o aplicativo estiver em segundo plano.

Recurso do manifesto de reprodução de mídia em segundo plano

Para habilitar o áudio em segundo plano, você deve adicionar o recurso de reprodução de mídia em segundo plano ao arquivo de manifesto do aplicativo, Package.appxmanifest.

Para adicionar funcionalidades ao manifesto do aplicativo usando o designer de manifesto

  1. No Microsoft Visual Studio, no Gerenciador de Soluções, abra o designer do manifesto do aplicativo clicando duas vezes no item package.appxmanifest.
  2. Selecione a guia Funcionalidades.
  3. Marque a caixa de seleção Reprodução de Mídia em Segundo Plano.

Para definir o recurso editando manualmente o xml de manifesto do aplicativo, primeiro verifique se o prefixo do namespace uap3 está definido no elemento Package. Se não estiver, adicione-o conforme mostrado abaixo.

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap uap3 mp">

Em seguida, adicione a funcionalidade backgroundMediaPlayback ao elemento Capabilities :

<Capabilities>
    <uap3:Capability Name="backgroundMediaPlayback"/>
</Capabilities>

Tratar a transição entre primeiro e segundo plano

Quando o aplicativo é movido do primeiro para o segundo plano, o evento EnteredBackground é acionado. E quando o aplicativo retorna ao primeiro plano, o evento LeavingBackground é acionado. Como eles são eventos de ciclo de vida do aplicativo, é necessário registrar manipuladores para esses eventos quando o aplicativo for criado. No modelo de projeto padrão, isso significa adicioná-los ao construtor de classe App em App.xaml.cs.

public App()
{
    this.InitializeComponent();
    this.Suspending += OnSuspending;

    this.EnteredBackground += App_EnteredBackground;
    this.LeavingBackground += App_LeavingBackground;
}

Crie uma variável para controlar se você está em execução em segundo plano.

bool _isInBackgroundMode = false;

Quando o evento EnteredBackground for acionado, defina a variável de rastreamento para indicar que você está em execução em segundo plano. Você não deve executar tarefas de longa duração no evento EnteredBackground porque isso pode fazer com que a transição para o segundo plano pareça lenta para o usuário.

private void App_EnteredBackground(object sender, EnteredBackgroundEventArgs e)
{
    _isInBackgroundMode = true;
}

No manipulador de eventos LeavingBackground, você deve definir a variável de rastreamento para indicar que o aplicativo não está mais em execução em segundo plano.

private void App_LeavingBackground(object sender, LeavingBackgroundEventArgs e)
{
    _isInBackgroundMode = false;
}

Requisitos de gerenciamento de memória

A parte mais importante de manipulação da transição entre primeiro e segundo plano é o gerenciamento da memória que seu aplicativo usa. Como a execução em segundo plano reduz os recursos de memória que seu aplicativo tem permissão para reter pelo sistema, você também deve ser registrado para os eventos AppMemoryUsageIncreased e AppMemoryUsageLimitChanging. Quando esses eventos são gerados, você deve verificar o uso atual da memória e o limite atual do seu aplicativo e, em seguida, reduzir o uso de memória, se necessário. Para obter informações sobre como reduzir o uso da memória durante a execução em segundo plano, consulte Liberar memória quando seu aplicativo é movido para o segundo plano.

Disponibilidade da rede para aplicativos de mídia em segundo plano

Todas as fontes de mídia com reconhecimento de rede, aquelas que não são criadas de um fluxo ou de um arquivo, manterão a conexão de rede ativa enquanto recuperam conteúdo remoto, e a liberarão quando não estiverem recuperando conteúdo remoto. MediaStreamSource, especificamente, depende do aplicativo reportar corretamente o intervalo de buffer correto à plataforma, usando SetBufferedRange. Depois que todo o conteúdo for armazenado totalmente em buffer, a rede não será mais reservada em nome do aplicativo.

Se você precisar fazer chamadas de rede que ocorrem em segundo plano quando a mídia não estiver sendo baixada, elas deverão ser encapsuladas em uma tarefa apropriada como MaintenanceTrigger ou TimeTrigger. Para obter mais informações, consulte Suporte ao aplicativo com tarefas em segundo plano.