Misc

AudioHelper

AudioHelper 클래스는 오디오 포커스 및 장치 우선권을 제어하는 유틸리티 모듈입니다. AudioHelper 클래스는 Property와 Method로 구성됩니다.

Property

Method

AudioHelper 클래스의 메서드는 다음과 같습니다.

acquireFocus()

SDK에서 오디오를 관리하기 위해 AudioHelper 클래스에 오디오 포커스를 요청합니다. 파라미터인 streamType, audioMode의 경우 기본값 사용을 권장하며, onCallModeChange의 경우 acquireFocus 이후 통화 상태에 따라 이벤트가 발생합니다.

코드예제acquireFocus() Syntax

// 기본 사용법
AudioHelper.acquireFocus(context = this)

// or...

// streamType, audioMode 는 기본값 사용 권장.
AudioHelper.acquireFocus(
            context = this,
            streamType = AudioManager.STREAM_VOICE_CALL,
            audioMode = AudioManager.MODE_IN_COMMUNICATION,
            onCallModeChange = Consumer { inCall ->
                //...
            }
        )

releaseFocus()

앱에서 ConnectLive Android SDK의 사용 시나리오 종료 시, releaseFocus() 메서드를 통해 오디오 포커스 요청을 취소해야 합니다.

코드예제releaseFocus() Syntax

AudioHelper.releaseFocus()

prefer()

해당 오디오 디바이스에 가장 높은 우선권을 부여합니다. AudioHelper 클래스에 디바이스의 기본 우선순위가 정의되어 있습니다. 따라서 강제로 오디오 디바이스의 우선순위를 변경하는 경우가 아니라면, 해당 메서드의 호출을 지양합니다.

코드예제prefer() Syntax

AudioHelper.prefer(device = AudioHelper.Device.BLUETOOTH)

avoid()

해당 오디오 디바이스에 가장 낮은 우선권을 부여합니다. AudioHelper 클래스에 디바이스의 기본 우선순위가 정의되어 있습니다. 따라서 강제로 오디오 디바이스의 우선순위를 변경하는 경우가 아니라면, 해당 메서드의 호출을 지양합니다.

코드예제avoid() Syntax

AudioHelper.avoid(device = AudioHelper.Device.EARPIECE)

resetPreferences()

prefer() 또는 avoid() 메서드를 통해 오디오 장치 우선권을 변경한 경우, SDK 기본 설정대로 설정을 초기화합니다.

코드예제resetPreferences() Syntax

AudioHelper.resetPreferences()

VideoCapturerFactory.CreateScreenCapture

화면 공유 요청을 Activity Result API로 처리하기 용이하도록 제공된 ActivityResultContract입니다. 앱 구성에 맞춰서 Intent, localScreen을 관리하는 것을 권장합니다.

코드예제VideoCapturerFactory.CreateScreenCapture Syntax

registerForActivityResult(VideoCapturerFactory.CreateScreenCapture) { data : Intent? ->
		if (data != null) {
				localScreen = ConnectLive.createLocalScreen(data)
				room.publish(localScreen)
		}
}.launch(Unit)

VideoCapturerConfig

로컬 비디오 캡처에 활용되는 설정으로 해상도와 화면 캡처의 최대 사이즈를 설정합니다. 기본값 사용을 권장합니다.

Property

VideoRenderer

SurfaceView를 상속받고 있으며, VideoContent의 bind를 제공하는 클래스입니다. VideoRenderer가 화면에서 차지하는 비율에 따라 최적화를 위해 자동으로 화질변경을 수행합니다. 또한 VideoRenderer의 화면 노출 여부에 따라 attach, detach를 함으로써 편리함과 최적화를 제공합니다

Property

Method

bind()

영상 프레임을 받아볼 VideoContent를 VideoRenderer 클래스에 바인드합니다.

코드예제bind() Syntax

videoRenderer.bind(content = LocalVideo,RemoteVideo)

unbind()

해당 VideoRenderer 클래스에서 수신 중인 영상 프레임의 바인드를 해제하여 수신 취소합니다.

코드예제unbind() Syntax

videoRenderer.unbind()

setRenderingChecker()

영상 프레임이 렌더링되는 상태를 조회합니다. interval 동안 그려지는 프레임이 있을 경우 active가 호출되며, 그려지는 프레임이 없는 경우 inactive가 호출됩니다.

코드예제setRenderingChecker() Syntax

videoRenderer.setRenderingChecker(5000L,
			active = {
					...
			},
			inActive = {
					...
			}
)