다음을 통해 공유

빠른 시작: 통화 앱에서 통화 볼륨 수준에 액세스

  • 아티클

Important

이 문서에 설명된 기능은 현재 공개 미리 보기로 제공됩니다. 이 미리 보기 버전은 서비스 수준 계약 없이 제공되며, 프로덕션 워크로드에는 권장되지 않습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.

개발자는 마이크 볼륨 확인을 제어할 수 있습니다. 이 빠른 시작에서는 Azure Communication Services 호출 SDK 내에서 이 작업을 수행하는 방법의 예를 설명합니다.

로컬 오디오 스트림 볼륨 확인

개발자는 최종 사용자에게 현재 로컬 마이크 볼륨 또는 수준을 검사 및 표시할 수 있습니다. Azure Communication Services 호출 API는 VolumeLevel을 사용하여 이 정보를 노출합니다. VolumeLevel 값은 0에서 1 사이의 부동 소수입니다(0은 감지된 오디오가 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");
    }
}

Important

이 문서에 설명된 기능은 현재 공개 미리 보기로 제공됩니다. 이 미리 보기 버전은 서비스 수준 계약 없이 제공되며, 프로덕션 워크로드에는 권장되지 않습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.

개발자는 마이크 볼륨 확인을 제어할 수 있습니다. 이 빠른 시작에서는 Azure Communication Services 호출 SDK 내에서 이 작업을 수행하는 방법의 예를 설명합니다.

로컬 오디오 스트림 볼륨 확인

개발자는 최종 사용자에게 현재 로컬 마이크 볼륨 또는 수준을 검사 및 표시할 수 있습니다. Azure Communication Services 호출 API는 getVolumeLevel을 사용하여 이 정보를 노출합니다. getVolumeLevel 값은 0에서 1 사이의 부동 소수입니다(0은 감지된 오디오가 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();
}

Important

이 문서에 설명된 기능은 현재 공개 미리 보기로 제공됩니다. 이 미리 보기 버전은 서비스 수준 계약 없이 제공되며, 프로덕션 워크로드에는 권장되지 않습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.

개발자는 마이크 볼륨 확인을 제어할 수 있습니다. 이 빠른 시작에서는 Azure Communication Services 호출 SDK 내에서 이 작업을 수행하는 방법의 예를 설명합니다.

로컬 오디오 스트림 볼륨 확인

개발자는 최종 사용자에게 현재 로컬 마이크 볼륨 또는 수준을 검사 및 표시할 수 있습니다. Azure Communication Services 호출 API는 volumeLevel을 사용하여 이 정보를 노출합니다. volumeLevel 값은 0에서 1 사이의 부동 소수입니다(0은 감지된 오디오가 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 Communication Services WebJS 내에서 이를 수행하는 방법의 예를 설명합니다.

필수 조건

Important

이 빠른 시작 예제는 호출 웹 SDK의 1.13.1 버전부터 사용할 수 있습니다. 이 빠른 시작을 진행할 때는 해당 SDK 버전 또는 더 높은 버전을 사용해야 합니다.

오디오 스트림 볼륨 확인

개발자는 최종 사용자에게 현재 로컬 마이크 볼륨 또는 들어오는 마이크 수준을 검사 및 표시할 수 있습니다. Azure Communication Services 호출 API는 getVolume을 사용하여 이 정보를 노출합니다. getVolume 값은 0에서 100 사이의 숫자입니다(0이 감지된 오디오가 0개이고 최대 수준이 검색 가능한 경우 100). 이 값은 볼륨 수준의 거의 실시간 값을 얻기 위해 200ms마다 샘플링됩니다. 마이크 하드웨어마다 감도 수준이 다르며 비슷한 환경에서도 다른 볼륨 수준을 표시할 수 있습니다.

예제 사용

이 예제에서는 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 디스플레이를 만드는 방법에 대한 자세한 코드 샘플은 여기를 참조하세요.

다음 단계

자세한 내용은