通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：访问通话应用中的通话音量级别

  • 项目

重要

本文中所述的功能目前以公共预览版提供。 此预览版在提供时没有附带服务级别协议，我们不建议将其用于生产工作负荷。 某些功能可能不受支持或者受限。 有关详细信息，请参阅 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 显示以显示本地当前的传入音频电平，请参阅此文。

后续步骤

有关详细信息，请参阅以下文章：