Kakao i Connect Live::Kakao i Connect Live 2.0::API 레퍼런스::iOS::LocalMedia

페이지 이동경로

LocalMedia

LocalMedia 클래스는 Local Participant(로컬 참여자)가 생성한 오디오와 비디오를 제어합니다. LocalMedia 클래스는 Property와 Method로 구성됩니다.

LocalMedia 전체 목록
클래스 대분류 항목 설명
LocalMedia Property video 로컬 비디오의 스트림
audio 로컬 오디오의 스트림
position 현재 선택된 디바이스의 카메라 위치
isMirror 카메라 좌우 반전 여부
audioLevel 디바이스의 마이크로 입력되는 로컬 오디오 레벨(범위: 0~100)
Method start() 로컬 미디어의 게시(송출) 시작
stop() 로컬 미디어의 게시(송출) 중단
switchCamera() 디바이스의 카메라 위치 변경

Property

video

로컬 비디오의 스트림입니다. 읽기 전용이며 수정은 불가능합니다. video는 Room 클래스의 publish() 메서드 호출 시, 비디오 송출을 시작하면 생성됩니다.

video Property
프로퍼티 타입 설명
video Localvideo 로컬 비디오의 스트림
- 읽기 전용, 자세한 정보는 LocalVideo 참고

audio

로컬 오디오의 스트림입니다. 읽기 전용이며 수정은 불가능합니다. audio는 Room 클래스의 publish() 메서드를 호출 시, 오디오 송출을 시작하면 생성됩니다.

audio Property
프로퍼티 타입 설명
audio LocalAudio 로컬 오디오의 스트림
- 읽기 전용, 자세한 정보는 LocalAudio 참고

position

현재 선택된 디바이스의 카메라 위치입니다.

position Property
프로퍼티 타입 설명
position AVCaptureDevice.Position 현재 선택된 디바이스의 카메라 위치

isMirror

카메라 좌우 반전 여부를 나타냅니다. 읽기 전용이며 수정은 불가능합니다.

isMirror Property
프로퍼티 타입 설명
isMirror Boolean 카메라 좌우 반전 여부
- 읽기 전용
true: 영상 좌우 반전
false: 영상 좌우 반전하지 않음

audioLevel

디바이스의 마이크로 입력되는 로컬 오디오 레벨입니다. 읽기 전용이며 수정은 불가능합니다.

audioLevel Property
프로퍼티 타입 설명
audioLevel Int 디바이스의 마이크로 입력되는 로컬 오디오 레벨(범위: 0~100)
- 읽기 전용

Method

start()

Room에 로컬 미디어의 송출을 시작합니다. 이 메서드는 명시적으로 호출하지 않아도 미디어 송출이 시작되면 자동으로 호출됩니다.

코드예제start() Syntax

localMedia.start { error in
	if error == nil {
		// 성공
	} else {
		// 실패
	}
}

start() Parameters
파라미터 타입 필수 여부 설명
completion (Error?) -> Void 필수 로컬 미디어 송출 결과

stop()

Room에 로컬 미디어의 송출을 중단합니다.

코드예제stop() Syntax

localMedia.stop()

switchCamera()

디바이스의 카메라 위치를 변경합니다.

코드예제switchCamera() Syntax

localMedia.start { error in
	if error == nil {
		// 성공
	} else {
		// 실패
	}
}

switchCamera() Parameters
파라미터 타입 필수 여부 설명
position AVCaptureDevice.Position 필수 변경할 카메라 위치
isMirror Boolean 필수 카메라 위치 변경 시 카메라 영상 좌우 반전 여부
true: 영상의 좌우를 반전
false: 영상의 좌우를 반전시키지 않음
completion (Error?) -> Void 필수 카메라 위치 변경 결과 Callback
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 documentation@kakaoenterprise.com 으로 제보해주세요.