快速入門：存取通話應用程式中的通話音量層級

重要

本文中所述的功能目前處於公開預覽狀態。 此預覽版本沒有服務等級協定，不建議用於處理生產工作負載。 可能不支援特定功能，或可能已經限制功能。 如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

身為開發人員，您可以控制檢查麥克風音量。 本快速入門示範如何在 Azure 通訊服務呼叫 SDK 內完成此作業的範例。

檢查本機音訊串流音量

身為開發人員，能夠檢查並向用戶顯示目前的本機麥克風音量層級，這很好。 Azure 通訊服務呼叫 API 會使用 VolumeLevel公開此資訊。 此值 VolumeLevel 是一個浮點數，範圍從 0 到 1（偵測到 0 表示未偵測到零音訊，100 作為可偵測到的最大層級，-1 表示失敗的作業）。

使用方式範例

此範例示範如何藉由存取 VolumeLevel 本機音訊串流來產生音量層級。

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

重要

本文中所述的功能目前處於公開預覽狀態。 此預覽版本沒有服務等級協定，不建議用於處理生產工作負載。 可能不支援特定功能，或可能已經限制功能。 如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

身為開發人員，您可以控制檢查麥克風音量。 本快速入門示範如何在 Azure 通訊服務呼叫 SDK 內完成此作業的範例。

檢查本機音訊串流音量

身為開發人員，能夠檢查並向用戶顯示目前的本機麥克風音量層級，這很好。 Azure 通訊服務呼叫 API 會使用 getVolumeLevel公開此資訊。 此值 getVolumeLevel 是一個浮點數，範圍從 0 到 1（偵測到 0 表示未偵測到零音訊，100 作為可偵測到的最大層級，-1 表示失敗的作業）。

使用方式範例

此範例示範如何藉由存取 getVolumeLevel 本機音訊串流來產生音量層級。

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

重要

本文中所述的功能目前處於公開預覽狀態。 此預覽版本沒有服務等級協定，不建議用於處理生產工作負載。 可能不支援特定功能，或可能已經限制功能。 如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

身為開發人員，您可以控制檢查麥克風音量。 本快速入門示範如何在 Azure 通訊服務呼叫 SDK 內完成此作業的範例。

檢查本機音訊串流音量

身為開發人員，能夠檢查並向用戶顯示目前的本機麥克風音量層級，這很好。 Azure 通訊服務呼叫 API 會使用 volumeLevel公開此資訊。 此值 volumeLevel 是一個浮點數，範圍從 0 到 1（偵測到 0 表示未偵測到零音訊，100 作為可偵測到的最大層級，-1 表示失敗的作業）。

使用方式範例

此範例示範如何藉由存取 volumeLevel 本機音訊串流來產生音量層級。

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

身為開發人員，您可以控制在 JavaScript 中檢查麥克風音量。 本快速入門示範如何在 Azure 通訊服務 WebJS 內完成此作業的範例。

必要條件

重要

這裡的快速入門範例可從呼叫 Web SDK 1.13.1 版開始提供。 嘗試本快速入門時，請務必使用該 SDK 版本或更新版本。

檢查音訊串流音量

身為開發人員，能夠檢查和顯示目前的本機麥克風音量或傳入麥克風層級，對終端用戶來說可能很好。 Azure 通訊服務呼叫 API 會使用 getVolume公開這項資訊。 值為 getVolume 介於 0 到 100 的數位（偵測到 0 表示零的音訊，100 作為可偵測到的最大層級）。 此值每隔 200 毫秒取樣一次，以取得接近即時的磁碟區層級值。 不同的麥克風硬體具有不同程度的敏感度，它可以針對類似的環境顯示不同的音量層級。

使用方式範例

此範例示範如何藉由存取 getVolume 本機音訊數據流和遠端傳入音訊數據流來產生音量層級。

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

如需如何建立UI顯示以顯示本機和目前傳入音訊層級的詳細程式碼範例，請參閱 這裡。

下一步

如需詳細資訊，請參閱下列文章：

• 深入了解 通話 SDK 功能