본문으로 건너뛰기
Version: 7.1

초기 오디오 상태

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

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

개요​

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

  • unmuted: 마이크가 활성화되고 마이크에서 캡처한 오디오가 전송됩니다.
  • muted: 마이크가 활성화되지 않고 오디오가 전송되지 않습니다.
Note
  • 이하 설명된 API의 기본값은 unmuted입니다.
  • 초기 오디오 상태를 muted로 설정하면 통화 시작 시 로컬 사용자의 마이크가 활성화되지 않고 오디오가 상대방에게 전송되지 않습니다. 오디오를 전송하려면 이후에 muteMyAudio()를 false로 호출해야 합니다.
  • muted로 시작하면 마이크 장치가 음 소거 해제 전까지 활성화되지 않으므로 통화 시작 시 마이크 표시기가 나타나지 않습니다.
Note

CallKit이 통합된 경우(PlanetKitCallKitType이 user 또는 planetkit으로 설정된 경우) 마이크 표시기는 CallKit이 제어합니다. 시작 시 .muted로 설정하면 연결 후 음 소거 상태가 CallKit과 동기화되어 표시기가 숨겨집니다. 이때 동기화가 완료되기 전에는 표시기가 잠깐 켜질 수 있지만, 동기화가 완료되면 음 소거 상태를 올바르게 반영합니다.

초기 오디오 상태 설정​

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

1대1 통화​

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

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

그룹 통화​

그룹 통화에 참여할 때 PlanetKitJoinConferenceSettingBuilder의 withInitialMyAudioStateKey()로 초기 오디오 상태를 설정하세요.

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

관련 API​

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

공통​

1대1 통화​

그룹 통화​

관련 문서​

관련 예제 코드​