WebRTC Signaling

WebRTC 시그널링은 통신 조정을 위해 메타데이터를 교환하는 과정입니다. 여기에 핵심이 되는 것은 Session Description Protocol(SDP)로, 피어 간 코덱, 네트워크 경로, 미디어 유형 등 세션 파라미터를 협상할 수 있게 해줍니다. 당사 서비스는 업계 표준 WHIP(WebRTC-HTTP Ingestion Protocol) 및 WHEP(WebRTC-HTTP Egress Protocol)와 맞춤형 HTTP/JSON 기반 프로토콜, 두 가지 시그널링 방식을 지원합니다. 본 가이드에서는 맞춤형 HTTP/JSON 프로토콜의 상세 내용을 설명합니다.

핵심 원리: Offer/Answer 모델

시그널링 프로세스는 표준 WebRTC Offer/Answer 모델에 기반합니다. 클라이언트가 offer SDP를 전송하여 세션을 시작하고, 서버는 answer SDP를 반환함으로써 협상을 최종 완료합니다.

스트림의 발행(푸시)과 재생(풀)을 구분하기 위해, 당사 서비스는 클라이언트의 offer SDP 내 속성들을 검사합니다.

• 스트림을 발행(푸시)할 경우: 클라이언트의 offer SDP에는 a=sendonly 속성이 포함되어야 합니다. 이는 클라이언트가 미디어를 송신만 하고 수신하지 않겠다는 의미입니다. 서버는 a=recvonly가 포함된 answer SDP로 응답합니다.
• 스트림을 재생(풀)할 경우: 클라이언트의 offer SDP에는 a=recvonly 속성이 포함되어야 합니다. 이는 클라이언트가 미디어를 수신만 하고 송신하지 않겠다는 의미입니다. 서버는 a=sendonly가 포함된 answer SDP로 응답합니다.

중요 안내:
a=sendrecv 속성(양방향 스트림)은 지원되지 않습니다. 반드시 클라이언트가 푸시 전용 또는 풀 전용으로 설정되어 있는지 확인해 주세요.

시그널링 엔드포인트

모든 시그널링 통신은 하나의 HTTP 엔드포인트를 통해 이뤄지며, URL로 대상 스트림을 지정합니다.

URL 형식

http://domain/appName/streamName.sdp?params=xxx

이 형식은 RTMP(rtmp://...) 및 HTTP-FLV(... .flv) URL과 의도적으로 유사하지만, 주요 차이점은 .sdp 접미사가 붙는다는 점입니다.

API 명세

요청

• Method: POST
• Content-Type: application/json

요청 본문

응답

응답 본문

SDP 오브젝트 정의

localSdp(요청 내)와 remoteSdp(응답 내) 오브젝트는 동일한 구조를 공유합니다.

상태 코드

예시

{
  "sessionId": "123456789",
  "version": "v1.0",
  "localSdp": {
    "type": "offer",
    "sdp": "v=0\r\no=- 12345 67890 IN IP4 192.0.2.1\r\ns=-\r\nt=0 0\r\na=sendonly\r\nm=video 9 UDP/TLS/RTP/SAVPF 100\r\n..."
  }
}

{
  "code": 200,
  "message": "success",
  "remoteSdp": {
    "type": "answer",
    "sdp": "v=0\r\no=- 98765 43210 IN IP4 198.51.100.1\r\ns=...\r\nt=0 0\r\na=recvonly\r\nm=video 9 UDP/TLS/RTP/SAVPF 100\r\n..."
  }
}