음 소거 상태 공유 및 제어
음 소거란 로컬 마이크 장비로부터 오디오 전송을 비활성화하는 것을 말합니다. 로컬 오디오를 음 소거하거나 음 소거 해제하고 애플리케이션의 음 소거 상태를 피어와 공유할 수 있습니다. 또한 특정 피어 또는 모든 피어에게 음 소거하거나 음 소거 해제하도록 요청할 수도 있습니다.
PlanetKit 6.0 이전에는 음 소거 제어가 마이크의 작동에는 직접적인 영향을 미치지 않았습니다. 하지만 PlanetKit 6.0부터 음 소거 제어가 다음과 같이 마이크를 제어합니다.
- 로컬 오디오를 음 소거하면 PlanetKit이 마이크를 끄고 오디오 전송을 비활성화하여 마이크 표시기(microphone indicator)가 꺼집니다.
- 로컬 오디오의 음 소거를 해제하면 PlanetKit이 마이크를 켜고 오디오 전송을 활성화하여 마이크 표시기가 켜집니다.
로컬 오디오 음 소거 제어 및 공유
로컬 오디오를 음 소거하거나 음 소거 해제하려면 muteMyAudio()를 사용하세요.
1대1 통화
1대1 통화에서는 로컬 오디오의 음 소거 상태 변경이 peerMicDidMute 또는 peerMicDidUnmute를 통해 피어에게 전송됩니다.
그룹 통화
그룹 통화에서는 로컬 오디오의 음 소거 상태 변경이 peersMicDidMute 또는 peersMicDidUnmute를 통해 피어에게 전송됩니다.
원격 오디오 음 소거 요청
특정 피어 또는 모든 피어에게 오디오를 음 소거하거나 음 소거 해제하도록 요청할 수 있습니다.
- 1대1 통화나 그룹 통화에서 특정 피어에게 음 소거 또는 음 소거 해제하도록 요청하려면
requestPeerMute()를 사용하세요. - 그룹 통화에서 모든 피어에게 음 소거하거나 음 소거 해제하도록 요청하려면
requestPeersMute()를 사용하세요.
음 소거 요청은 myMuteRequestedByPeer를 통해 피어에게 통보됩니다.
피어가 요청을 받았을 때 오디오를 음 소거하거나 음 소거 해제해야 하는지 여부는 구현에 따라 다릅니다.
다음 예시에서는 피어가 요청에 따라 음 소거하거나 음 소거 해제한다고 가정합니다.
1대1 통화
1대1 통화에서는 원격 오디오의 음 소거 상태 변경이 peerMicDidMute 또는 peerMicDidUnmute를 통해 로컬 사용자에게 전송됩니다.
그룹 통화
그룹 통화에서는 원격 오디오의 음 소거 상태 변경이 peersMicDidMute 또는 peersMicDidUnmute를 통해 로컬 사용자에게 전송됩니다.
관련 API
음 소거 제어 및 상태 공유와 관련된 API는 다음과 같습니다.
1대1 통화
메서드
이벤트
-
PlanetKitCallDelegate의peerMicDidMute -
PlanetKitCallDelegate의peerMicDidUnmute -
PlanetKitCallDelegate의myMuteRequestedByPeer
그룹 통화
메서드
-
PlanetKitConference의muteMyAudio() -
PlanetKitConference의requestPeerMute() -
PlanetKitConference의requestPeersMute()