Dela via

Snabbstart: Åtkomst till samtalsvolymnivå i din samtalsapp

  • Artikel

Viktigt!

Funktioner som beskrivs i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Som utvecklare kan du ha kontroll över att kontrollera mikrofonvolymen. Den här snabbstarten visar exempel på hur du utför det i Azure Communication Services Calling SDK.

Kontrollera den lokala ljudströmvolymen

Som utvecklare kan det vara trevligt att ha möjlighet att kontrollera och visa för slutanvändarna den aktuella lokala mikrofonvolymnivån. Azure Communication Services-anrops-API:et exponerar den här informationen med hjälp av VolumeLevel. Värdet VolumeLevel är ett flyttalsnummer som sträcker sig från 0 till 1 (med 0 som anger noll ljud upptäckt, 100 som högsta nivå som kan identifieras, -1 som anger en misslyckad åtgärd).

Exempel på användning

Det här exemplet visar hur du genererar volymnivån genom att VolumeLevel komma åt den lokala ljudströmmen.

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

Viktigt!

Funktioner som beskrivs i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Som utvecklare kan du ha kontroll över att kontrollera mikrofonvolymen. Den här snabbstarten visar exempel på hur du utför det i Azure Communication Services Calling SDK.

Kontrollera den lokala ljudströmvolymen

Som utvecklare kan det vara trevligt att ha möjlighet att kontrollera och visa för slutanvändarna den aktuella lokala mikrofonvolymnivån. Azure Communication Services-anrops-API:et exponerar den här informationen med hjälp av getVolumeLevel. Värdet getVolumeLevel är ett flyttalsnummer som sträcker sig från 0 till 1 (med 0 som anger noll ljud upptäckt, 100 som högsta nivå som kan identifieras, -1 som anger en misslyckad åtgärd).

Exempel på användning

Det här exemplet visar hur du genererar volymnivån genom att getVolumeLevel komma åt den lokala ljudströmmen.

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

Viktigt!

Funktioner som beskrivs i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Som utvecklare kan du ha kontroll över att kontrollera mikrofonvolymen. Den här snabbstarten visar exempel på hur du utför det i Azure Communication Services Calling SDK.

Kontrollera den lokala ljudströmvolymen

Som utvecklare kan det vara trevligt att ha möjlighet att kontrollera och visa för slutanvändarna den aktuella lokala mikrofonvolymnivån. Azure Communication Services-anrops-API:et exponerar den här informationen med hjälp av volumeLevel. Värdet volumeLevel är ett flyttalsnummer som sträcker sig från 0 till 1 (med 0 som anger noll ljud upptäckt, 100 som högsta nivå som kan identifieras, -1 som anger en misslyckad åtgärd).

Exempel på användning

Det här exemplet visar hur du genererar volymnivån genom att volumeLevel komma åt den lokala ljudströmmen.

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

Som utvecklare kan du ha kontroll över att kontrollera mikrofonvolymen i JavaScript. Den här snabbstarten visar exempel på hur du gör det i Azure Communication Services WebJS.

Förutsättningar

Viktigt!

Snabbstartsexemplen här är tillgängliga från och med version 1.13.1 av den anropande Webb-SDK:t. Se till att använda den SDK-versionen eller senare när du provar den här snabbstarten.

Kontrollera ljudströmvolymen

Som utvecklare kan det vara trevligt att kunna kontrollera och visa den aktuella lokala mikrofonvolymen eller den inkommande mikrofonnivån för slutanvändarna. Azure Communication Services-anrops-API:et exponerar den här informationen med hjälp av getVolume. Värdet getVolume är ett tal som sträcker sig från 0 till 100 (med 0 som anger att inget ljud har identifierats, 100 som maximal nivåidentifieringsbar). Det här värdet samplas var 200 ms för att komma nära realtidsvärdet för volymnivån. Olika mikrofonmaskinvara har olika känslighetsnivå och kan visa olika volymnivåer för liknande miljö.

Exempel på användning

Det här exemplet visar hur du genererar volymnivån genom att getVolume komma åt den lokala ljudströmmen och fjärrströmmen för inkommande ljud.

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

Ett mer detaljerat kodexempel på hur du skapar en gränssnittsvisning för att visa den lokala och aktuella inkommande ljudnivån finns här.

Nästa steg

Mer information finns i följande artikel: