이 페이지는 Cloud Translation API를 통해 번역되었습니다.

WebTransport 사용

WebTransport는 지연 시간이 짧은 양방향 클라이언트-서버 메시지를 제공하는 API입니다. 사용 사례와 향후 구현에 관한 의견을 제공하는 방법을 자세히 알아보세요.

Jeff Posnick

배경

WebTransport란 무엇인가요?

WebTransport는 HTTP/3 프로토콜을 양방향 전송으로 사용하는 웹 API입니다. 웹 클라이언트와 HTTP/3 서버 간의 양방향 통신을 위해 설계되었습니다. 데이터그램 API를 통해 비신뢰성 있게 데이터를 전송하고 스트림 API를 통해 안정적으로 데이터를 전송합니다.

데이터그램은 강력한 전송 보장이 필요하지 않은 데이터를 주고받는 데 적합합니다. 개별 데이터 패킷은 기본 연결의 최대 전송 단위 (MTU)에 따라 크기가 제한되며, 전송이 성공적으로 이루어질 수도 있고 그렇지 않을 수도 있으며, 전송된 경우 임의의 순서로 도착할 수 있습니다. 이러한 특성으로 인해 데이터그램 API는 지연 시간이 짧은 최선의 데이터 전송에 적합합니다. 데이터그램은 사용자 데이터그램 프로토콜 (UDP) 메시지로 생각할 수 있지만 암호화되고 혼잡이 제어됩니다.

반면 스트림 API는 순서가 지정된 안정적인 데이터 전송을 제공합니다. 정렬된 데이터 스트림을 하나 이상 전송하거나 수신해야 하는 시나리오에 적합합니다. 여러 WebTransport 스트림을 사용하는 것은 여러 개의 TCP 연결을 설정하는 것과 비슷하지만 HTTP/3은 내부적으로 더 가벼운 QUIC 프로토콜을 사용하므로 오버헤드 없이 열고 닫을 수 있습니다.

사용 사례

다음은 개발자가 WebTransport를 사용할 수 있는 몇 가지 방법입니다.

작고 신뢰할 수 없으며 순서가 잘못된 메시지를 통해 최소 지연 시간으로 서버에 게임 상태를 정기적으로 전송합니다.
다른 데이터 스트림과 관계없이 최소 지연 시간으로 서버에서 푸시된 미디어 스트림을 수신합니다.
웹페이지가 열려 있는 동안 서버에서 푸시하는 알림을 수신합니다.

WebTransport를 어떻게 사용할 계획인지 자세히 알아보고 싶습니다.

브라우저 지원

Browser Support

Source

범용 브라우저 지원이 없는 모든 기능과 마찬가지로 기능 감지를 통해 방어적으로 코딩하는 것이 좋습니다.

현재 상태

단계	상태
1. 설명 동영상 만들기	완전함
2. 사양의 초안 작성	완전함
3. 의견 수집 및 디자인 반복	완료
4. 오리진 트라이얼	완료
5. 출시	Chromium 97

WebTransport와 다른 기술의 관계

WebTransport가 WebSockets를 대체하나요?

그럴 수도 있습니다. WebSockets 또는 WebTransport가 유효한 통신 프로토콜일 수 있는 사용 사례가 있습니다.

WebSockets 통신은 안정적이고 순서가 지정된 단일 메시지 스트림을 중심으로 모델링되며, 이는 일부 유형의 통신 요구사항에는 적합합니다. 이러한 특성이 필요한 경우 WebTransport의 스트림 API에서도 제공할 수 있습니다. 반면 WebTransport의 데이터그램 API는 안정성이나 순서에 대한 보장 없이 지연 시간이 짧은 전송을 제공하므로 WebSockets를 직접 대체하지는 않습니다.

데이터그램 API 또는 여러 동시 실행 Streams API 인스턴스를 통해 WebTransport를 사용하면 WebSockets에서 문제가 될 수 있는 head-of-line blocking에 대해 걱정할 필요가 없습니다. 또한 기본 QUIC 핸드셰이크가 TLS를 통해 TCP를 시작하는 것보다 빠르므로 새 연결을 설정할 때 성능 이점이 있습니다.

WebTransport는 새로운 초안 사양의 일부이므로 현재 클라이언트 및 서버 라이브러리를 둘러싼 WebSocket 생태계는 훨씬 더 강력합니다. 일반적인 서버 설정에서 '즉시' 작동하고 광범위한 웹 클라이언트 지원이 필요한 경우 WebSocket이 더 나은 선택입니다.

WebTransport는 UDP 소켓 API와 동일한가요?

아니요. WebTransport는 UDP Socket API가 아닙니다. WebTransport는 HTTP/3을 사용하며 HTTP/3은 '내부적으로' UDP를 사용하지만, WebTransport에는 암호화 및 정체 제어와 관련된 요구사항이 있어 기본 UDP 소켓 API 이상이 됩니다.

WebTransport는 WebRTC 데이터 채널의 대안인가요?

예, 클라이언트-서버 연결의 경우 WebTransport는 기본 프로토콜이 다르지만 WebRTC 데이터 채널과 많은 속성을 공유합니다.

일반적으로 HTTP/3 호환 서버를 실행하는 데는 작동하는 전송을 얻기 위해 여러 프로토콜 (ICE, DTLS, SCTP)을 이해해야 하는 WebRTC 서버를 유지하는 것보다 설정과 구성이 덜 필요합니다. WebRTC는 클라이언트/서버 협상 실패로 이어질 수 있는 더 많은 동작을 수반합니다.

WebTransport API는 웹 개발자 사용 사례를 염두에 두고 설계되었으며 WebRTC의 데이터 채널 인터페이스를 사용하는 것보다 최신 웹 플랫폼 코드를 작성하는 것과 더 유사합니다. WebRTC와 달리 WebTransport는 웹 워커 내에서 지원되므로 지정된 HTML 페이지와 관계없이 클라이언트-서버 통신을 실행할 수 있습니다. WebTransport는 스트림 준수 인터페이스를 노출하므로 백프레셔 관련 최적화를 지원합니다.

하지만 이미 만족스러운 작동하는 WebRTC 클라이언트/서버 설정이 있는 경우 WebTransport로 전환해도 많은 이점을 얻지 못할 수 있습니다.

사용해 보기

WebTransport를 실험하는 가장 좋은 방법은 호환되는 HTTP/3 서버를 시작하는 것입니다. 그런 다음 이 페이지를 기본 JavaScript 클라이언트와 함께 사용하여 클라이언트/서버 통신을 시도해 볼 수 있습니다.

또한 webtransport.day에서 커뮤니티에서 유지관리하는 에코 서버를 사용할 수 있습니다.

API 사용

WebTransport는 Streams API와 같은 최신 웹 플랫폼 프리미티브를 기반으로 설계되었습니다. 프라미스에 크게 의존하며 async 및 await와 잘 작동합니다.

Chromium의 현재 WebTransport 구현은 데이터그램과 단방향 및 양방향 스트림이라는 세 가지 고유한 유형의 트래픽을 지원합니다.

서버에 연결

WebTransport 인스턴스를 만들어 HTTP/3 서버에 연결할 수 있습니다. URL의 스키마는 https여야 합니다. 포트 번호를 명시적으로 지정해야 합니다.

ready 프로미스를 사용하여 연결이 설정될 때까지 기다려야 합니다. 이 약속은 설정이 완료될 때까지 처리되지 않으며 QUIC/TLS 단계에서 연결에 실패하면 거부됩니다.

closed 약속은 연결이 정상적으로 닫힐 때 실행되고 예상치 못한 종료인 경우 거부됩니다.

서버가 클라이언트 표시 오류 (예: URL 경로가 잘못됨)로 인해 연결을 거부하면 closed가 거부되고 ready는 계속 해결되지 않은 상태로 유지됩니다.

const url = 'https://example.com:4999/foo/bar';
const transport = new WebTransport(url);

// Optionally, set up functions to respond to
// the connection closing:
transport.closed.then(() => {
  console.log(`The HTTP/3 connection to ${url} closed gracefully.`);
}).catch((error) => {
  console.error(`The HTTP/3 connection to ${url} closed due to ${error}.`);
});

// Once .ready fulfills, the connection can be used.
await transport.ready;

Datagram API

서버에 연결된 WebTransport 인스턴스가 있으면 이를 사용하여 데이터그램이라고 하는 개별 데이터 비트를 전송하고 수신할 수 있습니다.

writeable getter는 웹 클라이언트가 서버에 데이터를 전송하는 데 사용할 수 있는 WritableStream를 반환합니다. readable getter는 ReadableStream를 반환하므로 서버의 데이터를 수신 대기할 수 있습니다. 두 스트림 모두 본질적으로 신뢰할 수 없으므로 작성한 데이터가 서버에 수신되지 않을 수 있으며 그 반대의 경우도 가능합니다.

두 유형의 스트림 모두 데이터 전송에 Uint8Array 인스턴스를 사용합니다.

// Send two datagrams to the server.
const writer = transport.datagrams.writable.getWriter();
const data1 = new Uint8Array([65, 66, 67]);
const data2 = new Uint8Array([68, 69, 70]);
writer.write(data1);
writer.write(data2);

// Read datagrams from the server.
const reader = transport.datagrams.readable.getReader();
while (true) {
  const {value, done} = await reader.read();
  if (done) {
    break;
  }
  // value is a Uint8Array.
  console.log(value);
}

참고: Chrome은 현재 ReadableStream의 비동기 반복자를 노출하지 않습니다. 당분간은 getReader() 메서드와 while() 루프를 함께 사용하는 것이 스트림에서 읽는 가장 좋은 방법입니다.

Streams API

서버에 연결한 후 WebTransport를 사용하여 Streams API를 통해 데이터를 전송하고 수신할 수도 있습니다.

모든 스트림의 각 청크는 Uint8Array입니다. Datagram API와 달리 이러한 스트림은 안정적입니다. 하지만 각 스트림은 독립적이므로 스트림 간의 데이터 순서는 보장되지 않습니다.

WebTransportSendStream

WebTransportSendStream는 WebTransportSendStream의 약속을 반환하는 WebTransport 인스턴스의 createUnidirectionalStream() 메서드를 사용하여 웹 클라이언트에서 생성됩니다.

WritableStreamDefaultWriter의 close() 메서드를 사용하여 연결된 HTTP/3 스트림을 닫습니다. 브라우저는 연결된 스트림을 실제로 닫기 전에 대기 중인 모든 데이터를 전송하려고 시도합니다.

// Send two Uint8Arrays to the server.
const stream = await transport.createUnidirectionalStream();
const writer = stream.writable.getWriter();
const data1 = new Uint8Array([65, 66, 67]);
const data2 = new Uint8Array([68, 69, 70]);
writer.write(data1);
writer.write(data2);
try {
  await writer.close();
  console.log('All data has been sent.');
} catch (error) {
  console.error(`An error occurred: ${error}`);
}

마찬가지로 WritableStreamDefaultWriter의 abort() 메서드를 사용하여 RESET_STREAM를 서버로 전송합니다. abort()를 사용하면 브라우저에서 아직 전송되지 않은 대기 중인 데이터를 삭제할 수 있습니다.

const ws = await transport.createUnidirectionalStream();
const writer = ws.getWriter();
writer.write(...);
writer.write(...);
await writer.abort();
// Not all the data may have been written.

WebTransportReceiveStream

WebTransportReceiveStream가 서버에서 시작됩니다. WebTransportReceiveStream를 가져오는 것은 웹 클라이언트의 두 단계 프로세스입니다. 먼저 WebTransport 인스턴스의 incomingUnidirectionalStreams 속성을 호출하여 ReadableStream를 반환합니다. 이 ReadableStream의 각 청크는 서버에서 전송한 Uint8Array 인스턴스를 읽는 데 사용할 수 있는 WebTransportReceiveStream입니다.

async function readFrom(receiveStream) {
  const reader = receiveStream.readable.getReader();
  while (true) {
    const {done, value} = await reader.read();
    if (done) {
      break;
    }
    // value is a Uint8Array
    console.log(value);
  }
}

const rs = transport.incomingUnidirectionalStreams;
const reader = rs.getReader();
while (true) {
  const {done, value} = await reader.read();
  if (done) {
    break;
  }
  // value is an instance of WebTransportReceiveStream
  await readFrom(value);
}

ReadableStreamDefaultReader의 closed 약속을 사용하여 스트림 닫기를 감지할 수 있습니다. 기본 HTTP/3 스트림이 FIN 비트로 닫히면 모든 데이터가 읽힌 후에 closed 약속이 충족됩니다. HTTP/3 스트림이 갑자기 닫히면 (예: RESET_STREAM에 의해) closed 프로미스가 거부됩니다.

// Assume an active receiveStream
const reader = receiveStream.readable.getReader();
reader.closed.then(() => {
  console.log('The receiveStream closed gracefully.');
}).catch(() => {
  console.error('The receiveStream closed abruptly.');
});

WebTransportBidirectionalStream

WebTransportBidirectionalStream는 서버 또는 클라이언트에서 생성될 수 있습니다.

웹 클라이언트는 WebTransportBidirectionalStream의 약속을 반환하는 WebTransport 인스턴스의 createBidirectionalStream() 메서드를 사용하여 이를 만들 수 있습니다.

const stream = await transport.createBidirectionalStream();
// stream is a WebTransportBidirectionalStream
// stream.readable is a ReadableStream
// stream.writable is a WritableStream

WebTransport 인스턴스의 incomingBidirectionalStreams 속성을 사용하여 서버에서 만든 WebTransportBidirectionalStream를 리슨하면 ReadableStream가 반환됩니다. 이 ReadableStream의 각 청크는 WebTransportBidirectionalStream입니다.

const rs = transport.incomingBidirectionalStreams;
const reader = rs.getReader();
while (true) {
  const {done, value} = await reader.read();
  if (done) {
    break;
  }
  // value is a WebTransportBidirectionalStream
  // value.readable is a ReadableStream
  // value.writable is a WritableStream
}

WebTransportBidirectionalStream은 WebTransportSendStream와 WebTransportReceiveStream의 조합일 뿐입니다. 이전 두 섹션의 예에서는 각 방법을 사용하는 방법을 설명합니다.

예시 더보기

WebTransport 초안 사양에는 모든 메서드와 속성에 대한 전체 문서와 함께 여러 인라인 예시가 추가로 포함되어 있습니다.

Chrome DevTools의 WebTransport

안타깝게도 Chrome의 DevTools는 현재 WebTransport를 지원하지 않습니다. 이 Chrome 문제에 '별표표시'를 하면 DevTools 인터페이스의 업데이트에 대한 알림을 받을 수 있습니다.

폴리필

WebTransport의 일부 기능을 구현하는 폴리필 (또는 사용할 수 있는 독립형 모듈로 기능을 제공하는 포니필)인 webtransport-ponyfill-websocket를 사용할 수 있습니다. 프로젝트의 README에 있는 제약조건을 주의 깊게 읽고 이 솔루션이 사용 사례에 적합한지 확인합니다.

개인 정보 보호 및 보안 고려사항

공식적인 안내는 초안 사양의 해당 섹션을 참고하세요.

의견

Chrome팀은 이 API를 사용한 경험과 의견을 듣고자 합니다.

API 디자인에 대한 의견

API에 불편하거나 예상대로 작동하지 않는 문제가 있나요? 아니면 아이디어를 구현하는 데 필요한 부분이 누락되어 있나요?

Web Transport GitHub 저장소에서 문제를 제출하거나 기존 문제에 의견을 추가하세요.

구현에 문제가 있나요?

Chrome 구현에서 버그를 발견했나요?

https://new.crbug.com에서 버그를 신고합니다. 재현을 위한 간단한 안내와 함께 최대한 자세하게 작성합니다.

API를 사용하려면 어떻게 해야 하나요?

공개적으로 지원하면 Chrome에서 기능의 우선순위를 정하는 데 도움이 되며 다른 브라우저 공급업체에 기능을 지원하는 것이 얼마나 중요한지 보여줍니다.

#WebTransport 해시태그와 사용 위치 및 사용 방법에 관한 세부정보를 사용하여 @ChromiumDev에 트윗을 보냅니다.

자유 게시판

다른 카테고리 중 하나에 해당하지 않는 일반적인 질문이나 문제는 web-transport-dev Google 그룹을 사용하세요.

감사의 말씀

이 도움말에는 WebTransport 설명, 초안 사양, 관련 설계 문서의 정보가 통합되어 있습니다. 이러한 기반을 제공해 주신 각 저자분들께 감사드립니다.

이 게시물의 히어로 이미지는 Unsplash의 로빈 피에르님이 제공해 주셨습니다.