LocalAudio

LocalAudio 클래스는 LocalMedia의 audio 속성에 해당되는 객체입니다. LocalAudio클래스는 Property와 Method로 구성됩니다.

Property

LocalAudio 클래스의 프로퍼티는 다음과 같습니다.

Method

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

getMediaStreamTrack()

Local Audio의 미디어 스트림 트랙을 반환합니다. 미디어 스트림 트랙은 스트림 내의 단일 미디어 트랙으로, 오디오 트랙을 의미합니다.

코드예제getMediaStreamTrack() Syntax

const track = localAudio.getMediaStreamTrack();

getMediaStream()

미디어 스트림(오디오)을 반환합니다.

코드예제getMediaStream() Syntax

const stream = localAudio.getMediaStream();

getStreamId()

미디어의 고유 아이디인 streamId를 반환합니다.

코드예제getStreamId() Syntax

const streamId = localAudio.getStreamId();

setExtraValue()

서비스에서 필요한 값을 extraValue로 설정합니다. 설정된 extraValue는 다른 참여자들과 공유됩니다.

코드예제setExtraValue() Syntax

localAudio.setExtraValue('{extraValue}');

getExtraValue()

서비스에서 설정한 extraValue를 반환합니다.

코드예제getExtraValue() Syntax

const extraValue = localAudio.getExtraValue();

setEnabled()

미디어 트랙의 상태를 활성화 또는 비활성화합니다. 미디어 트랙 상태를 true로 설정하여 미디어 스트림 트랙을 활성화하면, 미디어 출처 스트림의 렌더링을 허용합니다. 반대로, false로 설정 시 미디어 스트림 트랙이 비활성화되어 음소거로 처리됩니다.

코드예제setEnabled() Syntax

await localAudio.setEnabled({enabled});

stop()

미디어 트랙(오디오)을 중지합니다.

코드예제stop() Syntax

localAudio.stop();

setAlwaysOn()

필요 시, alwaysOn 기능을 설정하여 로컬 참여자의 오디오를 항상 재생하도록 설정할 수 있습니다.

• SDK에서는 기본적으로 오디오 송출 시, Room에서 오디오 레벨이 가장 큰 4명의 오디오를 내보냅니다. alwaysOn은 만약 4명의 오디오가 있을 경우 오디오 레벨에 상관 없이 로컬 참여자의 오디오를 항상 내보내고 싶을 때 설정하는 기능입니다.

코드예제setAlwaysOn() Syntax

await localVideo.setAlwaysOn({enabled});