초기 비디오 상태 설정

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

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

개요

PlanetKitInitialMyVideoState 열거형에 다음과 같은 초기 비디오 상태 값이 정의되어 있습니다.

• resume: 카메라가 켜지고 카메라에서 캡처한 비디오가 전송됩니다.
• pause: 카메라가 꺼진 상태로 유지되고 비디오가 전송되지 않습니다.

Note

• 이하 설명된 API의 기본값은 resume입니다.
• 초기 비디오 상태를 pause로 설정하면 로컬 사용자의 비디오가 전송되지 않습니다. 로컬 사용자의 비디오를 캡처하고 전송하려면 이후에 resumeMyVideo()를 호출해야 합니다.

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

통화 유형에 따라 초기 비디오 상태를 설정하는 데 사용되는 API는 다음과 같습니다.

1대1 통화

• 발신자 측: 통화를 생성할 때 PlanetKitCallParam의 initialMyVideoState 속성으로 초기 비디오 상태를 설정하세요.
• 착신자 측: 통화에 응답할 때 acceptCall()의 initialMyVideoState 파라미터로 초기 비디오 상태를 설정하세요.

1대1 통화에서 초기 비디오 상태를 설정하는 예제 코드는 1대1 영상 통화를 참조하세요.

그룹 통화

그룹 통화에 참여할 때 PlanetKitConferenceParam의 initialMyVideoState 속성으로 초기 비디오 상태를 설정하세요.

그룹 통화에서 초기 비디오 상태를 설정하는 예제 코드는 그룹 영상 통화를 참조하세요.

영상 통화 전환 시의 초기 비디오 상태 설정

1대1 통화나 그룹 통화에서 영상 통화를 활성화할 때 enableVideo()의 initialMyVideoState 파라미터로 초기 비디오 상태를 설정하세요.

자세한 내용은 음성 통화 중 영상 통화 활성화를 참조하세요.

관련 API

초기 비디오 상태 설정과 관련된 API는 다음과 같습니다.

1대1 통화

• PlanetKitCallParam의 initialMyVideoState ^{iOS, macOS}
• acceptCall() ^{iOS, macOS}
• PlanetKitCall의 enableVideo() ^{iOS, macOS}

그룹 통화

• PlanetKitConferenceParam의 initialMyVideoState ^{iOS, macOS}
• PlanetKitConference의 enableVideo() ^{iOS, macOS}

관련 문서

• 1대1 통화 흐름
• 그룹 통화 흐름
• 음성 통화 중 영상 통화 활성화

관련 예제 코드

• 1대1 영상 통화
• 그룹 영상 통화