Compartir vía

Inicio rápido: Acceso al nivel de volumen de llamadas en la aplicación de llamada

  • Artículo

Importante

La funcionalidad descrita en este artículo se encuentra actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin un Acuerdo de Nivel de Servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.

Como desarrollador, puedes tener el control de la comprobación del volumen del micrófono. Este inicio rápido muestra ejemplos de cómo lograr esto dentro del SDK de llamada de Azure Communication Services.

Comprobación del volumen de la transmisión de audio local

Como desarrollador, puede que quieras poder comprobar y mostrar a los usuarios finales el nivel del volumen del micrófono local actual. La API de llamadas de Azure Communication Services expone esta información utilizando VolumeLevel. El valor de VolumeLevel es un número float comprendido entre 0 y 1 (donde 0 indica cero audio detectado, 100 el nivel máximo detectable y -1 una operación con errores).

Ejemplo de uso

En este ejemplo se muestra cómo generar el nivel de volumen accediendo a VolumeLevel de la transmisión de audio 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

La funcionalidad descrita en este artículo se encuentra actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin un Acuerdo de Nivel de Servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.

Como desarrollador, puedes tener el control de la comprobación del volumen del micrófono. Este inicio rápido muestra ejemplos de cómo lograr esto dentro del SDK de llamada de Azure Communication Services.

Comprobación del volumen de la transmisión de audio local

Como desarrollador, puede que quieras poder comprobar y mostrar a los usuarios finales el nivel del volumen del micrófono local actual. La API de llamadas de Azure Communication Services expone esta información utilizando getVolumeLevel. El valor de getVolumeLevel es un número float comprendido entre 0 y 1 (donde 0 indica cero audio detectado, 100 el nivel máximo detectable y -1 una operación con errores).

Ejemplo de uso

En este ejemplo se muestra cómo generar el nivel de volumen accediendo a getVolumeLevel de la transmisión de audio local.

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

Importante

La funcionalidad descrita en este artículo se encuentra actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin un Acuerdo de Nivel de Servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.

Como desarrollador, puedes tener el control de la comprobación del volumen del micrófono. Este inicio rápido muestra ejemplos de cómo lograr esto dentro del SDK de llamada de Azure Communication Services.

Comprobación del volumen de la transmisión de audio local

Como desarrollador, puede que quieras poder comprobar y mostrar a los usuarios finales el nivel del volumen del micrófono local actual. La API de llamadas de Azure Communication Services expone esta información utilizando volumeLevel. El valor de volumeLevel es un número float comprendido entre 0 y 1 (donde 0 indica cero audio detectado, 100 el nivel máximo detectable y -1 una operación con errores).

Ejemplo de uso

En este ejemplo se muestra cómo generar el nivel de volumen accediendo a volumeLevel de la transmisión de audio 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 desarrollador, puede tener el control de la comprobación del volumen del micrófono en JavaScript. Este inicio rápido muestra ejemplos de cómo lograr esto dentro de WebJS de Azure Communication Services.

Prerrequisitos

Importante

Los ejemplos de inicio rápido que se muestran aquí están disponibles a partir de la versión 1.13.1 del SDK web de llamada. Asegúrese de usar esa versión del SDK o una más reciente al probar este inicio rápido.

Comprobación del volumen de la secuencia de audio

Como desarrollador, puede que quiera poder comprobar y mostrar a los usuarios finales el volumen del micrófono local actual o el nivel del micrófono entrante. La API de llamadas de Azure Communication Services expone esta información utilizando getVolume. El valor getVolume es un número comprendido entre 0 y 100 (donde 0 indica cero audio detectado y 100 el nivel máximo detectable). Este valor se muestrea cada 200 ms para obtener un valor casi en tiempo real del nivel del volumen. El hardware de micrófono diferente tiene un nivel de sensibilidad diferente y puede mostrar diferentes niveles de volumen para el entorno similar.

Ejemplo de uso

En este ejemplo, se muestra cómo generar el nivel de volumen con el acceso al valor getVolume de la secuencia de audio local y de la secuencia de audio entrante remota.

//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 obtener un ejemplo de código más detallado sobre cómo crear una pantalla de interfaz de usuario para mostrar el nivel de audio de entrada local y actual, consulta aquí.

Pasos siguientes

Para obtener más información, consulte el artículo siguiente: