DuckingMediaPlayer

Este aplicativo de exemplo demonstra atenuação de fluxo implementando um player de mídia que mostra o comportamento de atenuação padrão fornecido pelo sistema, opta por não se esquivar de eventos e implementa a manipulação personalizada quando eventos de pato são recebidos. Este exemplo deve ser usado em conjunto com DuckingCaptureSample. Para obter mais informações sobre como evitar ou atenuar fluxos, consulte de Experiência de Pato Padrão.

Este tópico contém as seções a seguir.

• descrição
• requisitos de
• baixar o de exemplo
• compilar o de exemplo
• executando o de exemplo
• tópicos relacionados

Descrição

Este exemplo demonstra os seguintes recursos.

• DirectShow para reproduzir um arquivo de mídia.
• WASAPI para gerenciamento de fluxo e manipulação de eventos de esquiva.

Requisitos

Baixando o exemplo

Este exemplo está disponível nos seguintes locais.

Compilando o exemplo

Para criar o exemplo DuckingMediaPlayer, use as seguintes etapas:

1. Abra o DuckingMediaPlayer.sln no Visual Studio 2008.
2. Na janela, selecione o de Depuração ou a configuração da solução de Versão, selecione o menu Criar na barra de menus e selecione a opção Criar. Se você não abrir o Visual Studio do shell do CMD para o SDK, o Visual Studio não terá acesso ao ambiente de build do SDK. Nesse caso, o exemplo não será compilado, a menos que você defina explicitamente a variável de ambiente MSSdk, que é usada no arquivo de projeto, DuckingMediaPlayer.vcproj.

Executando o exemplo

Se você compilar o aplicativo com êxito, um arquivo executável, DuckingMediaPlayer.exe, será gerado. Para executá-lo, selecione Iniciar de Depuração ou Iniciar sem Depurar no menu de depuração ou digite DuckingMediaPlayer em uma janela de comando.

Para exibir uma demonstração de esquiva, você deve executar DuckingMediaPlayer e DuckingCaptureSample simultaneamente. DuckingCaptureSample abre um fluxo de comunicação e sinaliza o sistema para gerar um evento de esquiva. O DuckingMediaPlayer é notificado pelo sistema quando ocorre um evento de pato e o player de mídia executa a ação solicitada pelo usuário.

Para desabilitar o comportamento de pato:

1. Na janela DuckingCaptureSample, selecione Usar o dispositivo de entrada padrãoe clique em Iniciar para iniciar uma sessão de captura do dispositivo de comunicação.
2. No DuckingMediaPlayer, selecione um arquivo de mídia a ser reproduzido e especifique a opção de esquiva como Opt out de Ducking.

Observe que o arquivo de mídia é reproduzido sem interrupção. Os eventos gerados pelo sistema quando o fluxo de comunicação aberto são ignorados.

Para demonstrar o comportamento padrão de esquiva fornecido pelo sistema, faça o seguinte:

1. Selecione a opção Sons no painel de controle. Na guia comunicações, selecione Reduzir o volume de outros sons em 80%.
2. Na janela DuckingCaptureSample, selecione Usar o dispositivo de entrada padrãoe clique em Iniciar para iniciar uma sessão de captura do dispositivo de comunicação.
3. No DuckingMediaPlayer, selecione um arquivo de mídia a ser reproduzido, sem escolher nenhuma das opções de esquiva.
4. Na janela DuckingCaptureSample, clique em Parar para interromper o fluxo de comunicação.

Observe que quando DuckingCaptureSample abre o fluxo de comunicação, o arquivo de mídia reproduzido pelo DuckingMediaPlayer é executado sem interrupção, mas o nível de volume é reduzido. Quando a sessão de comunicação é interrompida, o volume é redefinido para a configuração original. Esse comportamento de atenuação de fluxo é o comportamento padrão de esquiva implementado pelo sistema.

Para exibir um comportamento de pato personalizado implementado pelo player de mídia:

1. Na janela DuckingCaptureSample, selecione Usar o dispositivo de entrada padrãoe clique em Iniciar para iniciar uma sessão de captura do dispositivo de comunicação.
2. No DuckingMediaPlayer, selecione um arquivo de mídia a ser reproduzido e especifique a opção de pato como Pausar no Duck.
3. Na janela DuckingCaptureSample, clique em Parar para interromper o fluxo de comunicação.

Observe que quando DuckingCaptureSample abre o fluxo de comunicação, o arquivo de mídia reproduzido por DuckingMediaPlayer é pausado. A reprodução é retomada quando a sessão de comunicação é interrompida. Esse comportamento de atenuação de fluxo é o comportamento de esquiva implementado pelo player de mídia.

DuckingMediaPlayer também demonstra como integrar o controle de volume para cada aplicativo com o mixer de volume.

Para obter mais informações sobre o recurso de atenuação de fluxo, consulte de Experiência de Esquiva Padrão.

Tópicos relacionados

exemplos de SDK que usam as APIs de áudio principais