Rychlý start: Úroveň hlasitosti volání v aplikaci pro volání

Článek
04/07/2024

Důležité

Funkce popsané v tomto článku jsou aktuálně ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Jako vývojář můžete mít kontrolu nad kontrolou hlasitosti mikrofonu. V tomto rychlém startu se dozvíte, jak toho dosáhnout v sadě SDK pro volání služeb Azure Communication Services.

Kontrola hlasitosti místního zvukového streamu

Jako vývojář může být hezké mít možnost kontrolovat a zobrazovat koncovým uživatelům aktuální úroveň hlasitosti místního mikrofonu. Rozhraní API pro volání služby Azure Communication Services zveřejňuje tyto informace pomocí VolumeLevel. Hodnota VolumeLevel je číslo s plovoucí desetinnou čárkou v rozsahu od 0 do 1 (s 0 rozpoznaným nulovým zvukem, 100 jako maximální zjistitelná úroveň, -1, která označuje neúspěšnou operaci).

Příklad využití

Tento příklad ukazuje, jak vygenerovat úroveň hlasitosti přístupem k VolumeLevel místnímu zvukovému streamu.

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

Důležité

Jako vývojář můžete mít kontrolu nad kontrolou hlasitosti mikrofonu. V tomto rychlém startu se dozvíte, jak toho dosáhnout v sadě SDK pro volání služeb Azure Communication Services.

Kontrola hlasitosti místního zvukového streamu

Jako vývojář může být hezké mít možnost kontrolovat a zobrazovat koncovým uživatelům aktuální úroveň hlasitosti místního mikrofonu. Rozhraní API pro volání služby Azure Communication Services zveřejňuje tyto informace pomocí getVolumeLevel. Hodnota getVolumeLevel je číslo s plovoucí desetinnou čárkou v rozsahu od 0 do 1 (s 0 rozpoznaným nulovým zvukem, 100 jako maximální zjistitelná úroveň, -1, která označuje neúspěšnou operaci).

Příklad využití

Tento příklad ukazuje, jak vygenerovat úroveň hlasitosti přístupem k getVolumeLevel místnímu zvukovému streamu.

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

Důležité

Jako vývojář můžete mít kontrolu nad kontrolou hlasitosti mikrofonu. V tomto rychlém startu se dozvíte, jak toho dosáhnout v sadě SDK pro volání služeb Azure Communication Services.

Kontrola hlasitosti místního zvukového streamu

Jako vývojář může být hezké mít možnost kontrolovat a zobrazovat koncovým uživatelům aktuální úroveň hlasitosti místního mikrofonu. Rozhraní API pro volání služby Azure Communication Services zveřejňuje tyto informace pomocí volumeLevel. Hodnota volumeLevel je číslo s plovoucí desetinnou čárkou v rozsahu od 0 do 1 (s 0 rozpoznaným nulovým zvukem, 100 jako maximální zjistitelná úroveň, -1, která označuje neúspěšnou operaci).

Příklad využití

Tento příklad ukazuje, jak vygenerovat úroveň hlasitosti přístupem k volumeLevel místnímu zvukovému streamu.

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

Jako vývojář můžete mít kontrolu nad kontrolou hlasitosti mikrofonu v JavaScriptu. Tento rychlý start ukazuje příklady toho, jak toho dosáhnout ve službě Azure Communication Services WebJS.

Požadavky

Důležité

Tady jsou uvedené příklady rychlého startu, které jsou k dispozici od verze 1.13.1 volající webové sady SDK. Při pokusu o tento rychlý start nezapomeňte použít tuto verzi sady SDK nebo novější.

Kontrola hlasitosti zvukového streamu

Jako vývojář může být hezké mít možnost kontrolovat a zobrazovat koncovým uživatelům aktuální místní hlasitost mikrofonu nebo příchozí úroveň mikrofonu. Rozhraní API pro volání služby Azure Communication Services zveřejňuje tyto informace pomocí getVolume. Hodnota getVolume je číslo v rozsahu od 0 do 100 (s 0 rozpoznaným nulovým zvukem, 100 jako maximální zjistitelnou úrovní). Tato hodnota se vzorkuje každých 200 ms a získá téměř hodnotu úrovně svazku v reálném čase. Různý hardware mikrofonu má jinou úroveň citlivosti a může zobrazovat různé úrovně hlasitosti pro podobné prostředí.

Příklad využití

Tento příklad ukazuje, jak vygenerovat úroveň hlasitosti přístupem k getVolume místnímu zvukovému streamu a vzdálenému příchozímu zvukovému streamu.

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

Podrobnější ukázku kódu o tom, jak vytvořit zobrazení uživatelského rozhraní pro zobrazení místní a aktuální příchozí zvukové úrovně, najdete tady.

Další kroky

Další informace najdete v následujícím článku:

Další informace o možnostech volání sady SDK

Sdílet prostřednictvím

Rychlý start: Úroveň hlasitosti volání v aplikaci pro volání

Kontrola hlasitosti místního zvukového streamu

Příklad využití

Kontrola hlasitosti místního zvukového streamu

Příklad využití

Kontrola hlasitosti místního zvukového streamu

Příklad využití

Požadavky

Kontrola hlasitosti zvukového streamu

Příklad využití

Další kroky

Váš názor

Další materiály