Condividi tramite

Guida introduttiva: Accedere al livello di volume delle chiamate nell'app chiamante

  • Articolo

Importante

La funzionalità descritta in questo articolo è attualmente disponibile in anteprima pubblica. Questa versione di anteprima viene fornita senza contratto di servizio, pertanto non è consigliabile usarla per i carichi di lavoro in ambienti di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Gli sviluppatori possono avere il controllo sul controllo del volume del microfono. Questa guida introduttiva illustra esempi di come eseguire questa operazione all'interno di Servizi di comunicazione di Azure Calling SDK.

Controllo del volume del flusso audio locale

In qualità di sviluppatore può essere bello avere la possibilità di controllare e visualizzare agli utenti finali il livello di volume del microfono locale corrente. Servizi di comunicazione di Azure'API chiamante espone queste informazioni usando VolumeLevel. Il VolumeLevel valore è un numero float compreso tra 0 e 1 (con 0 che nota zero audio rilevato, 100 come il livello massimo rilevabile, -1 che nota un'operazione non riuscita).

Esempio di utilizzo

Questo esempio mostra come generare il livello di volume accedendo VolumeLevel al flusso audio locale.

//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

La funzionalità descritta in questo articolo è attualmente disponibile in anteprima pubblica. Questa versione di anteprima viene fornita senza contratto di servizio, pertanto non è consigliabile usarla per i carichi di lavoro in ambienti di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Gli sviluppatori possono avere il controllo sul controllo del volume del microfono. Questa guida introduttiva illustra esempi di come eseguire questa operazione all'interno di Servizi di comunicazione di Azure Calling SDK.

Controllo del volume del flusso audio locale

In qualità di sviluppatore può essere bello avere la possibilità di controllare e visualizzare agli utenti finali il livello di volume del microfono locale corrente. Servizi di comunicazione di Azure'API chiamante espone queste informazioni usando getVolumeLevel. Il getVolumeLevel valore è un numero float compreso tra 0 e 1 (con 0 che nota zero audio rilevato, 100 come il livello massimo rilevabile, -1 che nota un'operazione non riuscita).

Esempio di utilizzo

Questo esempio mostra come generare il livello di volume accedendo getVolumeLevel al flusso audio locale.

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

Importante

La funzionalità descritta in questo articolo è attualmente disponibile in anteprima pubblica. Questa versione di anteprima viene fornita senza contratto di servizio, pertanto non è consigliabile usarla per i carichi di lavoro in ambienti di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Gli sviluppatori possono avere il controllo sul controllo del volume del microfono. Questa guida introduttiva illustra esempi di come eseguire questa operazione all'interno di Servizi di comunicazione di Azure Calling SDK.

Controllo del volume del flusso audio locale

In qualità di sviluppatore può essere bello avere la possibilità di controllare e visualizzare agli utenti finali il livello di volume del microfono locale corrente. Servizi di comunicazione di Azure'API chiamante espone queste informazioni usando volumeLevel. Il volumeLevel valore è un numero float compreso tra 0 e 1 (con 0 che nota zero audio rilevato, 100 come il livello massimo rilevabile, -1 che nota un'operazione non riuscita).

Esempio di utilizzo

Questo esempio mostra come generare il livello di volume accedendo volumeLevel al flusso audio locale.

//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")
}

Gli sviluppatori possono avere il controllo sul controllo del volume del microfono in JavaScript. Questo argomento di avvio rapido illustra esempi di come eseguire questa operazione all'interno del Servizi di comunicazione di Azure WebJS.

Prerequisiti

Importante

Gli esempi di avvio rapido sono disponibili a partire dalla versione 1.13.1 di Web SDK chiamante. Quando si prova questa guida introduttiva, assicurarsi di usare la versione dell'SDK o una versione più recente.

Controllo del volume del flusso audio

Come sviluppatore può essere bello avere la possibilità di controllare e visualizzare agli utenti finali il volume del microfono locale corrente o il livello del microfono in ingresso. Servizi di comunicazione di Azure'API chiamante espone queste informazioni usando getVolume. Il getVolume valore è un numero compreso tra 0 e 100 (con 0 che nota zero audio rilevato, 100 come rilevabile di livello massimo). Questo valore viene campionato ogni 200 ms per ottenere il valore quasi in tempo reale del livello di volume. L'hardware del microfono diverso ha un livello di sensibilità diverso e può mostrare livelli di volume diversi per l'ambiente simile.

Esempio di utilizzo

Questo esempio mostra come generare il livello di volume accedendo getVolume al flusso audio locale e al flusso audio in ingresso 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}`)
})

Per un esempio di codice più dettagliato su come creare una visualizzazione dell'interfaccia utente per visualizzare il livello audio locale e corrente in ingresso, vedi qui.

Passaggi successivi

Per altre informazioni, vedere l'articolo seguente: