Compartilhar via

Início Rápido: Acessar o nível de volume de chamadas em seu aplicativo de chamada

  • Artigo

Importante

A funcionalidade descrita neste artigo está atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.

Como desenvolvedor, você pode ter controle sobre a verificação do volume do microfone. Este início rápido mostra exemplos de como realizá-lo no SDK de Chamada dos Serviços de Comunicação do Azure.

Verificando o volume de fluxo de áudio local

Como desenvolvedor, pode ser útil poder verificar e exibir aos usuários finais o volume do microfone local atual. A API de chamada dos Serviços de Comunicação do Azure expõe essas informações usando VolumeLevel. O valor VolumeLevel é um número flutuante que varia de 0 a 1 (com 0 significando zero áudio detectado, 100 como detectável no nível máximo, -1 significando uma operação com falha).

Exemplo de uso

Este exemplo mostra como gerar o nível de volume acessando VolumeLevel do fluxo de áudio local.

//Get the volume of the local audio source
OutgoingAudioStream stream = call.ActiveOutgoingAudioStream;

if (stream != null)
{
    try
    {
        Trace.WriteLine("Current volume is: " + stream.VolumeLevel.ToString());
    }
    catch (Exception ex)
    {
        Trace.WriteLine("Failed to get volume for this audio stream");
    }
}

Importante

A funcionalidade descrita neste artigo está atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.

Como desenvolvedor, você pode ter controle sobre a verificação do volume do microfone. Este início rápido mostra exemplos de como realizá-lo no SDK de Chamada dos Serviços de Comunicação do Azure.

Verificando o volume de fluxo de áudio local

Como desenvolvedor, pode ser útil poder verificar e exibir aos usuários finais o volume do microfone local atual. A API de chamada dos Serviços de Comunicação do Azure expõe essas informações usando getVolumeLevel. O valor getVolumeLevel é um número flutuante que varia de 0 a 1 (com 0 significando zero áudio detectado, 100 como detectável no nível máximo, -1 significando uma operação com falha).

Exemplo de uso

Este exemplo mostra como gerar o nível de volume acessando getVolumeLevel do fluxo de áudio local.

//Get the volume of the local audio source
OutgoingAudioStream stream = call.getActiveOutgoingAudioStream();
try{
    float volume = stream.getVolumeLevel();
}catch (Exception e) {
    e.printStackTrace();
}

Importante

A funcionalidade descrita neste artigo está atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.

Como desenvolvedor, você pode ter controle sobre a verificação do volume do microfone. Este início rápido mostra exemplos de como realizá-lo no SDK de Chamada dos Serviços de Comunicação do Azure.

Verificando o volume de fluxo de áudio local

Como desenvolvedor, pode ser útil poder verificar e exibir aos usuários finais o volume do microfone local atual. A API de chamada dos Serviços de Comunicação do Azure expõe essas informações usando volumeLevel. O valor volumeLevel é um número flutuante que varia de 0 a 1 (com 0 significando zero áudio detectado, 100 como detectável no nível máximo, -1 significando uma operação com falha).

Exemplo de uso

Este exemplo mostra como gerar o nível de volume acessando volumeLevel do fluxo de áudio local.

//Get the volume of the local audio source
if let volume = call?.activeOutgoingAudioStream.volumeLevel {    
    print("Outgoing audio volume is %d", log:log, volume)
} else {
    print("Get volume error")
}

Como desenvolvedor, você pode ter controle sobre a verificação do volume do microfone em JavaScript. Este início rápido mostra exemplos de como fazer isso no WebJS dos Serviços de Comunicação do Azure.

Pré-requisitos

Importante

Os exemplos de início rápido estão disponíveis a partir da versão 1.13.1 do SDK Web de chamada. Use essa versão do SDK ou mais recente ao tentar este início rápido.

Verificar o volume do fluxo de áudio

Como desenvolvedor, pode ser útil poder verificar e exibir aos usuários finais o volume do microfone local atual ou o nível do microfone de entrada. A API de chamada dos Serviços de Comunicação do Azure expõe essas informações usando getVolume. O valor getVolume é um número que varia de 0 a 100 (com 0 indicando nenhum áudio detectado e 100 como o nível máximo detectável). Esse valor é amostrado a cada 200 ms para obter um valor quase em tempo real do nível de volume. Diferentes hardwares de microfone possuem diferentes níveis de sensibilidade e podem mostrar diferentes níveis de volume para um ambiente semelhante.

Exemplo de uso

Este exemplo mostra como gerar o nível de volume acessando getVolume do fluxo de áudio local e do fluxo de áudio de entrada remoto.

//Get the volume of the local audio source
const volumeIndicator = await new SDK.LocalAudioStream(deviceManager.selectedMicrophone).getVolume();
volumeIndicator.on('levelChanged', ()=>{
    console.log(`Volume is ${volumeIndicator.level}`)
})

//Get the volume level of the remote incoming audio source
const remoteAudioStream = call.remoteAudioStreams[0];
const volumeIndicator = await remoteAudioStream.getVolume();
volumeIndicator.on('levelChanged', ()=>{
    console.log(`Volume is ${volumeIndicator.level}`)
})

Para obter um exemplo de código mais detalhado sobre como criar uma exibição de interface do usuário para mostrar o nível de áudio de entrada local e atual, confira aqui.

Próximas etapas

Para obter mais informações, consulte o seguinte artigo: