Share via

Schnellstart: Zugreifen auf Anruflautstärke in Ihrer Anruf-App

  • Artikel

Wichtig

Die in diesem Artikel beschriebenen Funktionen befinden sich derzeit in der öffentlichen Vorschauphase. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und ist nicht für Produktionsworkloads vorgesehen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Als Entwickler können Sie das Überprüfen der Mikrofonlautstärke steuern. In dieser Schnellstartanleitung wird gezeigt, wie dies in Azure Communication Services-Anruf SDK realisiert werden kann.

Überprüfen der lokalen Lautstärke des Audiodatenstroms

Für Entwickler kann es reizvoll sein, Endbenutzern zu ermöglichen, die aktuelle lokale Mikrofonlautstärke zu überprüfen und anzuzeigen. Die Azure Communication Services Calling-API macht diese Informationen mithilfe von VolumeLevel verfügbar. Der VolumeLevel-Wert ist eine Fließkommazahl zwischen 0 und 1 (wobei 0 bedeutet, dass kein Audio erkannt wird, und 100 für den maximal erkennbaren Pegel steht, -1 bedeutet, dass der Vorgang fehlgeschlagen ist).

Beispielverwendung

In diesem Beispiel wird gezeigt, wie Sie den Lautstärkepegel durch Zugriff auf das VolumeLevel des lokalen Audiodatenstroms generieren.

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

Wichtig

Die in diesem Artikel beschriebenen Funktionen befinden sich derzeit in der öffentlichen Vorschauphase. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und ist nicht für Produktionsworkloads vorgesehen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Als Entwickler können Sie das Überprüfen der Mikrofonlautstärke steuern. In dieser Schnellstartanleitung wird gezeigt, wie dies in Azure Communication Services-Anruf SDK realisiert werden kann.

Überprüfen der lokalen Lautstärke des Audiodatenstroms

Für Entwickler kann es reizvoll sein, Endbenutzern zu ermöglichen, die aktuelle lokale Mikrofonlautstärke zu überprüfen und anzuzeigen. Die Azure Communication Services Calling-API macht diese Informationen mithilfe von getVolumeLevel verfügbar. Der getVolumeLevel-Wert ist eine Fließkommazahl zwischen 0 und 1 (wobei 0 bedeutet, dass kein Audio erkannt wird, und 100 für den maximal erkennbaren Pegel steht, -1 bedeutet, dass der Vorgang fehlgeschlagen ist).

Beispielverwendung

In diesem Beispiel wird gezeigt, wie Sie den Lautstärkepegel durch Zugriff auf das getVolumeLevel des lokalen Audiodatenstroms generieren.

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

Wichtig

Die in diesem Artikel beschriebenen Funktionen befinden sich derzeit in der öffentlichen Vorschauphase. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und ist nicht für Produktionsworkloads vorgesehen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Als Entwickler können Sie das Überprüfen der Mikrofonlautstärke steuern. In dieser Schnellstartanleitung wird gezeigt, wie dies in Azure Communication Services-Anruf SDK realisiert werden kann.

Überprüfen der lokalen Lautstärke des Audiodatenstroms

Für Entwickler kann es reizvoll sein, Endbenutzern zu ermöglichen, die aktuelle lokale Mikrofonlautstärke zu überprüfen und anzuzeigen. Die Azure Communication Services Calling-API macht diese Informationen mithilfe von volumeLevel verfügbar. Der volumeLevel-Wert ist eine Fließkommazahl zwischen 0 und 1 (wobei 0 bedeutet, dass kein Audio erkannt wird, und 100 für den maximal erkennbaren Pegel steht, -1 bedeutet, dass der Vorgang fehlgeschlagen ist).

Beispielverwendung

Dieses Beispiel zeigt, wie der Lautstärkepegel durch Zugriff auf volumeLevel des lokalen Audiostroms erzeugt wird.

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

Als Entwickler können Sie das Überprüfen der Mikrofonlautstärke in JavaScript steuern. In dieser Schnellstartanleitung wird gezeigt, wie dies in Azure Communication Services-WebJS realisiert werden kann.

Voraussetzungen

Wichtig

Die hier aufgeführten Schnellstart-Beispiele sind ab Version 1.13.1 des Calling Web SDK verfügbar. Stellen Sie sicher, dass Sie diese oder eine neuere SDK-Version verwenden, wenn Sie diese Schnellstartanleitung ausprobieren.

Überprüfen der Lautstärke des Audiodatenstroms

Für Entwickler kann es reizvoll sein, Endbenutzern zu ermöglichen, die aktuelle lokale Mikrofonlautstärke oder den eingehenden Mikrofonpegel zu überprüfen und anzuzeigen. Die Azure Communication Services Calling-API macht diese Informationen mithilfe von getVolume verfügbar. Der getVolume-Wert ist eine Zahl zwischen 0 und 100 (wobei 0 bedeutet, dass kein Audio erkannt wird, und 100 für den maximal erkennbaren Pegel steht). Dieser Wert wird alle 200 ms abgefragt, um einen annähernden Echtzeitwert des Lautstärkepegels zu erhalten. Unterschiedliche Mikrofonhardware verfügt über unterschiedliche Empfindlichkeitsstufen und kann für die gleiche Umgebung unterschiedliche Lautstärken anzeigen.

Beispielverwendung

In diesem Beispiel wird gezeigt, wie Sie den Lautstärkepegel durch Zugriff auf das getVolume des lokalen Audiodatenstroms und des eingehenden Remote-Audiodatenstroms generieren.

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

Ein ausführlicheres Codebeispiel zum Erstellen einer UI-Anzeige zum Anzeigen des lokalen und aktuell eingehenden Audiopegels finden Sie hier.

Nächste Schritte

Weitere Informationen finden Sie im folgenden Artikel: