WebRTC-RTCDataChannel API

WebRTC는 오디오 및 비디오 스트림을 전송하는 데 능숙 할뿐만 아니라 우리가 가지고있을 수있는 임의의 데이터를 전송합니다. 여기서 RTCDataChannel 객체가 작동합니다.

RTCDataChannel API

속성

RTCDataChannel.label (read only) − 데이터 채널 이름이 포함 된 문자열을 반환합니다.
RTCDataChannel.ordered (read only) − 메시지 전달 순서가 보장되면 true를, 보장되지 않으면 false를 반환합니다.
RTCDataChannel.protocol (read only) −이 채널에 사용되는 하위 프로토콜 이름이 포함 된 문자열을 반환합니다.
RTCDataChannel.id (read only) − RTCDataChannel 객체 생성시 설정된 채널의 고유 ID를 반환합니다.
RTCDataChannel.readyState (read only)− 연결 상태를 나타내는 RTCDataChannelState 열거 형을 반환합니다. 가능한 값-
- connecting− 연결이 아직 활성화되지 않았 음을 나타냅니다. 이것이 초기 상태입니다.
- open − 연결이 실행 중임을 나타냅니다.
- closing− 연결이 종료되고 있음을 나타냅니다. 캐시 된 메시지를 보내거나받는 중이지만 새로 생성 된 작업이 수락되지 않습니다.
- closed − 연결을 설정할 수 없거나 종료되었음을 나타냅니다.
RTCDataChannel.bufferedAmount (read only)− 전송 대기중인 바이트 수를 반환합니다. RTCDataChannel.send ()를 통해 아직 전송되지 않은 데이터의 양입니다.
RTCDataChannel.bufferedAmountLowThreshold− RTCDataChannel.bufferedAmount가 낮게 차지되는 바이트 수를 반환합니다. RTCDataChannel.bufferedAmount가이 임계 값 아래로 감소하면 bufferedamountlow 이벤트가 발생합니다.
RTCDataChannel.binaryType− 연결에 의해 전송 된 이진 데이터의 유형을 반환합니다. "blob"또는 "arraybuffer"일 수 있습니다.
RTCDataChannel.maxPacketLifeType (read only) − 메시징이 신뢰할 수없는 모드로 전환 될 때 창의 길이 (밀리 초)를 나타내는 unsigned short를 반환합니다.
RTCDataChannel.maxRetransmits (read only) − 전송되지 않은 경우 채널이 데이터를 재전송하는 최대 횟수를 나타내는 부호없는 단락을 반환합니다.
RTCDataChannel.negotiated (read only) − 채널이 사용자 에이전트 또는 애플리케이션에 의해 협상되었는지를 나타내는 부울을 반환합니다.
RTCDataChannel.reliable (read only) − 연결이 신뢰할 수없는 모드에서 메시지를 보낼 수 있음을 나타내는 부울을 반환합니다.
RTCDataChannel.stream (read only) − RTCDataChannel.id의 동의어

이벤트 핸들러

RTCDataChannel.onopen−이 이벤트 핸들러는 open 이벤트가 발생했을 때 호출됩니다. 이 이벤트는 데이터 연결이 설정되었을 때 전송됩니다.
RTCDataChannel.onmessage−이 이벤트 핸들러는 메시지 이벤트가 발생했을 때 호출됩니다. 데이터 채널에서 메시지를 사용할 수있을 때 이벤트가 전송됩니다.
RTCDataChannel.onbufferedamountlow−이 이벤트 핸들러는 bufferedamoutlow 이벤트가 발생하면 호출됩니다. 이 이벤트는 RTCDataChannel.bufferedAmount가 RTCDataChannel.bufferedAmountLowThreshold 속성 아래로 감소 할 때 전송됩니다.
RTCDataChannel.onclose−이 이벤트 핸들러는 close 이벤트가 발생했을 때 호출됩니다. 이 이벤트는 데이터 연결이 종료되었을 때 전송됩니다.
RTCDataChannel.onerror−이 이벤트 핸들러는 오류 이벤트가 발생하면 호출됩니다. 이 이벤트는 오류가 발생했을 때 전송됩니다.

행동 양식

RTCDataChannel.close() − 데이터 채널을 닫습니다.
RTCDataChannel.send()− 채널을 통해 매개 변수의 데이터를 전송합니다. 데이터는 blob, 문자열, ArrayBuffer 또는 ArrayBufferView 일 수 있습니다.