Version: 5.4

초기 비디오 상태 설정

영상 통화를 시작하거나 음성 통화에서 영상 통화로 전환할 때 적용되는 로컬 사용자의 초기 비디오 상태를 설정할 수 있습니다.

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

개요

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

Note

통화 시작 API와 영상 통화 전환 API의 cameraOn의 기본값은 true입니다.
cameraOn을 false로 설정하면 로컬 사용자의 비디오가 전송되지 않습니다. 이후 로컬 사용자의 비디오를 캡처하고 전송하려면 resumeMyVideo()를 호출해야 합니다.
WebPlanetKit 5.2 이전 버전에서는 cameraOn 기능을 videoEnabled라는 이름으로 제공하고 있습니다.

MakeCallParams나 VerifyCallParams 혹은 ConferenceParams에 cameraOn을 추가해 초기 비디오 상태를 설정할 수 있습니다.

1대1 통화

// Caller side
const makeCallParams = {
    ...,
    cameraOn: false
};

planetKit.makeCall(makeCallParams);

// Callee side
const verifyCallParams = {
    ...,
    cameraOn: false
};

planetKit.verifyCall(verifyCallParams);

그룹 통화

const conferenceParams = {
    ...,
    cameraOn: false
};

planetKit.joinConference(conferenceParams);

1대1 통화나 그룹 통화에서 영상 통화를 활성화할 때 enableVideo()의 EnableVideoOptions에 cameraOn을 추가해 초기 비디오 상태를 설정할 수 있습니다. 자세한 내용은 음성 통화 중 영상 통화 활성화를 참조하세요.