SDK 주요 메서드

init()

Android 버전의 Kakao i Connect Live SDK 2.0을 초기화합니다. 모든 메서드를 호출하기 전 반드시 init() 메서드를 호출해야 합니다.

코드예제init() Syntax

init(final Context context)

signIn()_커넥트 라이브 내부 인증

카카오 i 커넥트 라이브 2.0 SDK의 자체 인증 방식으로 인증(Provisioning)을 수행합니다. 인증 처리 후 결과는 Callback 형태로 전달하며, 인증 과정에서 발생한 에러는 ErrorHandler에서 확인할 수 있습니다. 인증 및 키(Key) 처리에 대한 자세한 설명은 인증 및 키 처리 문서를 참고하시기 바랍니다.

코드예제signIn()_커넥트 라이브 내부 인증 Syntax

ConnectLive.signIn {
    endpoint = "https://icl2-provisioning-ap2.k9ertc.io/api/rpc"
    serviceId = "ICLEXMPLPUBL"
    serviceSecret = "YOUR0SRVC0SECRET"

    errorHandler = ErrorHandler { code, message, isFatal ->
        // 에러 처리
    }
}

Throws

signIn()_서비스 자체 인증

커넥트 라이브 내부 인증 인증 방식이 아닌 서비스 자체의 인증 방식을 사용할 수 있습니다. 인증 과정에서 발생한 에러는 ErrorHandler에서 확인할 수 있습니다. 인증 및 키(Key) 처리에 대한 자세한 설명은 인증 및 키 처리 문서를 참고하시기 바랍니다.

코드예제signIn()_서비스 자체 인증 Syntax

ConnectLive.signIn {
    endpoint = "https://icl2-provisioning-ap2.k9ertc.io/api/rpc"
    serviceId = "ICLEXMPLPUBL"
		token = "YOUR_SERVICE_TOKEN"

    errorHandler = ErrorHandler { code, message, isFatal ->
        // 에러 처리
    }
}

Throws

signOut()

SDK의 인증을 해제하고, 인증 관련 리소스를 정리합니다.

코드예제signOut() Syntax

ConnectLive.signOut()

createRoom()

Room 객체를 생성합니다. Room은 서비스에 따라 채팅방, 화상회의실 등 참여자들이 서비스를 이용하기 위해 입장하는 공간입니다.

코드예제createRoom() Syntax

class OnEventListener : EventsCallback {
	override fun onConnecting(progress: Float) {
		...	
	}
	...
}

...

val room = ConnectLive.createRoom(events = OnEventListener())

Throws

Returns

createLocalMedia()

Local Participant(로컬 참여자)가 생성하는 로컬 오디오와 로컬 비디오의 컨테이너인 LocalMedia 객체를 생성합니다.

코드예제createLocalMedia() Syntax

val localMedia = ConnectLive.createLocalMedia(preferFrontCamera, ignoreErrors = true)

Throws

Returns

createLocalScreen()

Android 5(API 수준 21)에 도입된 MediaProjection API를 사용하여 안드로이드 화면 공유를 위한 컨테이너를 생성합니다. LocalScreen의 extraValue는 screen(기본값)으로 설정됩니다.

코드예제createLocalScreen() Syntax

val publishLocalScreen =
    registerForActivityResult(VideoCapturerFactory.CreateScreenCapture) { data ->
        if (data != null) {
            publishLocalScreen(data)
        }
    }

...

fun publishLocalScreen(data: Intent) {
    val localScreen = ConnectLive.createLocalScreen(data, onStop = {
			...
		})

    room.publish(localScreen)
}

Returns

createLocalCamera()

Local Participant(로컬 참여자)가 생성하는 로컬 비디오를 처리하기 위해 LocalCamera 객체를 생성합니다.

코드예제createLocalCamera() Syntax

val camera = ConnectLive.createLocalCamera(preferFrontCamera = true).apply { 
								start() 
						}

Returns

createLocalAudio()

Local Participant(로컬 참여자)가 생성하는 로컬 오디오를 처리하기 위해LocalAudio 객체를 생성합니다.

코드예제createLocalAudio() Syntax

val audio = ConnectLive.createLocalAudio()

Returns