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

快速入门:访问呼叫应用中的呼叫量级别

重要

Azure 通信服务的这一功能目前以预览版提供。 预览版中的功能已公开发布,可供所有新客户和现有Microsoft客户使用。

此预览版在提供时没有附带服务级别协议,我们不建议将其用于生产工作负荷。 某些功能可能不受支持,或者功能可能受到限制。

有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款

作为开发人员,你可以监控和管理麦克风音量。 本快速入门演示了如何在 Azure 通信服务呼叫 SDK 中完成它的示例。

检查本地音频流音量

作为开发人员,能够检查和显示最终用户当前的本地麦克风音量级别可能很好。 Azure 通信服务调用 API 使用 VolumeLevel公开此信息。 该值 VolumeLevel 是一个浮点数,范围为 0 到 100(其中 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");
    }
}

重要

Azure 通信服务的这一功能目前以预览版提供。 预览版中的功能已公开发布,可供所有新客户和现有Microsoft客户使用。

此预览版在提供时没有附带服务级别协议,我们不建议将其用于生产工作负荷。 某些功能可能不受支持,或者功能可能受到限制。

有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款

作为开发人员,你可以监控和管理麦克风音量。 本快速入门演示了如何在 Azure 通信服务呼叫 SDK 中完成它的示例。

检查本地音频流音量

作为开发人员,能够检查和显示最终用户当前的本地麦克风音量级别可能很好。 Azure 通信服务调用 API 使用 getVolumeLevel公开此信息。 该值 getVolumeLevel 是一个浮点数,范围为 0 到 100(其中 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();
}

重要

Azure 通信服务的这一功能目前以预览版提供。 预览版中的功能已公开发布,可供所有新客户和现有Microsoft客户使用。

此预览版在提供时没有附带服务级别协议,我们不建议将其用于生产工作负荷。 某些功能可能不受支持,或者功能可能受到限制。

有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款

作为开发人员,你可以监控和管理麦克风音量。 本快速入门演示了如何在 Azure 通信服务呼叫 SDK 中完成它的示例。

检查本地音频流音量

作为开发人员,能够检查和显示最终用户当前的本地麦克风音量级别可能很好。 Azure 通信服务调用 API 使用 volumeLevel公开此信息。 该值 volumeLevel 是一个浮点数,范围为 0 到 100(其中 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 显示以显示本地和当前传入音频级别的更详细的代码示例,请参阅 此处

后续步骤

有关详细信息,请参阅以下文章: