LocalMedia

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

Property

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

Method

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

getDevices()

로컬 참여자가 사용 중인 로컬 디바이스 목록을 반환합니다. 디바이스는 오디오 및 비디오 장치를 모두 포함합니다.

코드예제getDevices() Syntax

const devices = await localMedia.getDevices();

getMicDevices()

로컬 참여자가 사용 중인 로컬 디바이스 중 오디오 장치 목록을 반환합니다.

코드예제getMicDevices() Syntax

const devices = await localMedia.getMicDevices();

getSpeakerDevices()

로컬 참여자가 사용 중인 로컬 디바이스 중 스피커 장치 목록을 반환합니다.

코드예제getSpeakerDevices() Syntax

const devices = await localMedia.getSpeakerDevices();

getCameraDevices()

로컬 참여자가 사용 중인 로컬 디바이스 중 비디오 장치 목록을 반환합니다.

코드예제getCameraDevices() Syntax

const devices = await localMedia.getCameraDevices();

switchMic()

로컬 참여자가 사용 중인 오디오(마이크) 장치를 변경합니다.

코드예제switchMic() Syntax

await localMedia.switchMic('{deviceId}');

switchCamera()

로컬 참여자가 사용 중인 비디오(카메라) 장치를 변경합니다.

코드예제switchCamera() Syntax

await localMedia.switchCamera('{deviceId}');

stop()

LocalMedia에 속해 있는 오디오 객체와 비디오 객체를 중지합니다. disconnect() 메서드 호출 시 로컬 미디어(오디오/비디오)를 더 이상 사용하지 않을 경우, stop() 메서드를 호출하여 오디오 객체와 비디오 객체를 중지해야 합니다.

코드예제stop() Syntax

localMedia.stop();

setMediaStream()

외부에서 선언된 미디어스트림(mediaStream) 객체를 LocalMedia 클래스의 LocalAudio와 LocalVideo 속성으로 지정할 수 있습니다. 예를 들어, 동영상을 재생 중인 비디오 태그 또는 캔버스로부터 얻어낸 미디어 스트림을 LocalMedia에 지정하고 이를 다시 리모트 참여자들과 공유할 수 있습니다.

코드예제setMediaStream() Syntax

const videoTag = document.getElementById('video');
const mediaStream = videoTag.captureStream();

//동영상의 미디어스트림을 LocalMedia에 지정
localMedia.setMediaStream(mediaStream);

//동영상을 Room에 공유
room.publish([localMedia]);