초기 오디오 상태
1대1 통화를 시작하거나 그룹 통화에 참여할 때 적용되는 로컬 사용자의 초기 오디오 상태를 설정할 수 있습니다.
| 지원 통화 유형 | 최소 SDK 버전 |
|---|---|
| 1대1 통화, 그룹 통화(컨퍼런스) | WebPlanetKit 5.2 |
개요
통화 시작 API의 인자로 불리언 유형의 micOn을 추가해 초기 오디오 상태를 설정할 수 있습니다. micOn의 값에 따라 초기 오디오 상태는 다음과 같이 설정됩니다.
true(기본 값): 통화 시작 시 마이크가 활성화돼 켜지고 마이크에서 캡처한 오디오가 상대방에게 전송됩니다.false: 통화 시작 시 마이크가 활성화되지 않고 꺼진 상태로 유지되며 상대방에게 오디오가 전송되지 않습니다.
Note
micOn을false로 설정 후 다시 오디오를 전송하려면muteMyAudio(false)를 호출해야 합니다.- WebPlanetKit 6.0 버전부터는
micOn을false로 설정하면 통화 시작 시 마이크에 접근하지 않습니다. 따라서 사용자가 처음으로 음 소거를 해제할 때까지 브라우저 마이크 권한 요청 창이 표시되지 않으며, 통화 시작 시 브라우저의 마이크 표시기도 나타나지 않습니다.- WebPlanetKit 6.0 이전 버전에서는
micOn이false이더라도 마이크에 접근합니다.
- WebPlanetKit 6.0 이전 버전에서는
- WebPlanetKit 5.2 이전 버전에서는
micOn기능을audioEnabled라는 이름으로 제공하고 있습니다.
통화 시작 시 초기 오디오 상태 설정
MakeCallParams나 VerifyCallParams 혹은 ConferenceParams에 micOn을 추가해 초기 오디오 상태를 설정할 수 있습니다.
-
1대1 통화
// Caller side
const makeCallParams = {
...,
micOn: false
};
planetKit.makeCall(makeCallParams);// Callee side
const verifyCallParams = {
...,
micOn: false
};
planetKit.verifyCall(verifyCallParams); -
그룹 통화
const conferenceParams = {
...,
micOn: false
};
planetKit.joinConference(conferenceParams);
관련 API
초기 오디오 상태 설정과 관련된 API는 다음과 같습니다.
1대1 통화
MakeCallParams의micOnVerifyCallParams의micOn-
makeCall() -
verifyCall() -
Call의muteMyAudio()