본문으로 건너뛰기
Version: 5.5

음 소거 상태 공유 및 제어

음 소거란 로컬 마이크 장비로부터 전송하는 오디오를 비활성화하는 것을 말합니다. 로컬 오디오를 음 소거하거나 음 소거 해제하고 애플리케이션의 음 소거 상태를 피어와 공유할 수 있습니다. 또한 특정 피어 또는 모든 피어에게 음 소거하거나 음 소거 해제하도록 요청할 수도 있습니다.

로컬 오디오 음 소거 제어 및 공유​

로컬 오디오를 음 소거하거나 음 소거 해제하려면 muteMyAudio()를 사용하세요.

1대1 통화​

1대1 통화에서는 로컬 오디오의 음 소거 상태 변경이 onPeerMicMuted 또는 onPeerMicUnmuted를 통해 피어에게 전송됩니다.

1대1 통화 로컬 오디오 음 소거 시퀀스 다이어그램

그룹 통화​

그룹 통화에서는 로컬 오디오의 음 소거 상태 변경이 onPeersMicMuted 또는 onPeersMicUnmuted를 통해 피어에게 전송됩니다.

그룹 통화 로컬 오디오 음 소거 시퀀스 다이어그램

원격 오디오 음 소거 요청​

특정 피어 또는 모든 피어에게 오디오를 음 소거하거나 음 소거 해제하도록 요청할 수 있습니다.

  • 1대1 통화나 그룹 통화에서 특정 피어에게 음 소거 또는 음 소거 해제하도록 요청하려면 requestPeerMute()를 사용하세요.
  • 그룹 통화에서 모든 피어에게 음 소거하거나 음 소거 해제하도록 요청하려면 requestPeersMute()를 사용하세요.

음 소거 요청은 onMuteMyAudioRequestedByPeer를 통해 피어에게 통보됩니다.

Note

피어가 요청을 받았을 때 오디오를 음 소거하거나 음 소거 해제해야 하는지 여부는 구현에 따라 다릅니다.

다음 예시에서는 피어가 요청에 따라 음 소거하거나 음 소거 해제한다고 가정합니다.

1대1 통화​

1대1 통화에서는 원격 오디오의 음 소거 상태 변경이 onPeerMicMuted 또는 onPeerMicUnmuted를 통해 로컬 사용자에게 전송됩니다.

1대1 통화 원격 오디오 음 소거 시퀀스 다이어그램

그룹 통화​

그룹 통화에서는 원격 오디오의 음 소거 상태 변경이 onPeersMicMuted 또는 onPeersMicUnmuted를 통해 로컬 사용자에게 전송됩니다.

그룹 통화 원격 오디오 음 소거 시퀀스 다이어그램

관련 API​

음 소거 제어 및 상태 공유와 관련된 API는 다음과 같습니다.

1대1 통화​

메서드​

이벤트​

그룹 통화​

메서드​

이벤트​