본문으로 건너뛰기
Version: 6.0

초기 오디오 상태

1대1 통화를 시작하거나 그룹 통화에 참여할 때 적용되는 로컬 사용자의 초기 오디오 상태를 설정할 수 있습니다.

지원 통화 유형최소 SDK 버전
1대1 통화, 그룹 통화(컨퍼런스)WebPlanetKit 5.2

개요

통화 시작 API의 인자로 불리언 유형의 micOn을 추가해 초기 오디오 상태를 설정할 수 있습니다. micOn의 값에 따라 초기 오디오 상태는 다음과 같이 설정됩니다.

  • true(기본 값): 통화 시작 시 마이크가 활성화돼 켜지고 마이크에서 캡처한 오디오가 상대방에게 전송됩니다.
  • false: 통화 시작 시 마이크가 활성화되지 않고 꺼진 상태로 유지되며 상대방에게 오디오가 전송되지 않습니다.
Note
  • micOnfalse로 설정 후 다시 오디오를 전송하려면 muteMyAudio(false)를 호출해야 합니다.
  • WebPlanetKit 6.0 버전부터는 micOnfalse로 설정하면 통화 시작 시 마이크에 접근하지 않습니다. 따라서 사용자가 처음으로 음 소거를 해제할 때까지 브라우저 마이크 권한 요청 창이 표시되지 않으며, 통화 시작 시 브라우저의 마이크 표시기도 나타나지 않습니다.
    • WebPlanetKit 6.0 이전 버전에서는 micOnfalse이더라도 마이크에 접근합니다.
  • WebPlanetKit 5.2 이전 버전에서는 micOn 기능을 audioEnabled라는 이름으로 제공하고 있습니다.

통화 시작 시 초기 오디오 상태 설정

MakeCallParamsVerifyCallParams 혹은 ConferenceParamsmicOn을 추가해 초기 오디오 상태를 설정할 수 있습니다.

  • 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 통화

그룹 통화

관련 문서

관련 예제 코드