WebRTC (Web Real-Time Communications、ウェブリアルタイムコミュニケーション) は、ウェブアプリケーションやウェブサイトにて、仲介を必要とせずにブラウザー間で直接、任意のデータの交換や、キャプチャしたオーディオ／ビデオストリームの送受信を可能にする技術です。 WebRTC に関する一連の標準規格は、ユーザーがプラグインやサードパーティ製ソフトウェアをインストールすることなく、ピア・ツー・ピアにて、データ共有や遠隔会議を実現することを可能にします。
WebRTC はこれらを実現するために、いくつかの相互に関係する API 群とプロトコル群から構成されます。ここにあるドキュメント類は、あなたが WebRTC の基礎や、データコネクション／メディアコネクションの設定、利用方法などを理解するための手助けをしてくれます。
WebRTC の概念と使い方
WebRTC サーバーは複数の目的を果たし、多くの点で Media Capture と Streams API と重複します。音声会議やファイル交換、アイデンティティ管理、DTMF シグナルを送信することによるレガシー電話システムとのインターフェースのサポートを含む、パワフルなマルチメディア機能をウェブに提供します。ピア間の接続は何らかの特別なドライバやプラグインなしに実現でき、通常は中間サーバーも不要です。
P2P 接続は、RTCPeerConnection インターフェースを使用して行います。ひとたび接続が確立しオープンすると、メディアストリーム (MediaStreams) と/か データチャネル (RTCDataChannels) が接続に追加されます。
メディアストリームは複数のメディア情報トラックを構成できます; MediaStreamTrack インターフェースを基にしたオブジェクトで表現されるトラックは、オーディオ、ビデオ、(字幕やチャプター名のような) テキストのいずれかを含みます。ほとんどのストリームは、少なくとも 1 つのオーディオトラックとビデオトラックで構成され、ライブメディアまたはストリーミングされたムービーなどの保存されたメディア情報の送受信に使用できます。
RTCDataChannel インターフェースを使用して、P2P 接続を任意のバイナリデータの交換に使用することもできます。. これはバックチャネルインフォメーションやメタデータ交換、ゲームステータスパケット、ファイル転送、データ交換の主チャネルとして使用できます。
詳細や関連するガイドやチュートリアルへのリンクが必要
WebRTC インターフェイス
WebRTC は、さまざまなタスクを達成するために連携するインターフェイスを提供しているため、以下のリストにカテゴリごとに分類しました。アルファベット順のリストはサイドバーを見てください。
接続のセットアップと管理
以下のインターフェイスは、WebRTC 接続のセットアップ、オープン、管理に使用します。
RTCPeerConnection- Represents a WebRTC connection between the local computer and a remote peer. It is used to handle efficient streaming of data between the two peers.
RTCDataChannel- Represents a bi-directional data channel between two peers of a connection.
RTCDataChannelEvent- Represents events that occur while attaching a
RTCDataChannelto aRTCPeerConnection. The only event sent with this interface isdatachannel. RTCSessionDescription- Represents the parameters of a session. Each
RTCSessionDescriptionconsists of a descriptiontypeindicating which part of the offer/answer negotiation process it describes and of the SDP descriptor of the session. RTCSessionDescriptionCallback- The RTCSessionDescriptionCallback is passed into the
RTCPeerConnectionobject when requesting it to create offers or answers. RTCStatsReport- Provides information detailing statistics for a connection or for an individual track on the connection; the report can be obtained by calling
RTCPeerConnection.getStats(). RTCIceCandidate- Represents a candidate internet connectivity establishment (ICE) server for establishing an
RTCPeerConnection. RTCIceTransport- Represents information about an internet connectivity establishment (ICE) transport.
RTCIceServer- Defines how to connect to a single ICE server (such as a STUN or TURN server).
RTCPeerConnectionIceEvent- Represents events that occurs in relation to ICE candidates with the target, usually an
RTCPeerConnection. Only one event is of this type:icecandidate. RTCRtpSender- Manages the encoding and transmission of data for a
MediaStreamTrackon anRTCPeerConnection. RTCRtpReceiver- Manages the reception and decoding of data for a
MediaStreamTrackon anRTCPeerConnection. RTCRtpContributingSource- Contains information about a given contributing source (CSRC) including the most recent time a packet that the source contributed was played out.
RTCTrackEvent- Indicates that a new incoming
MediaStreamTrackwas created and an associatedRTCRtpReceiverobject was added to theRTCPeerConnectionobject. RTCConfiguration- Used to provide configuration options for an
RTCPeerConnection.
RTCSctpTransport- Provides information which describes a Stream Control Transmission Protocol (SCTP) transport and also provides a way to access the underlying Datagram Transport Layer Security (DTLS) transport over which SCTP packets for all of an
RTCPeerConnection's data channels are sent and received.
アイデンティティとセキュリティ
WebRTC API には、セキュリティとアイデンティティを管理する多数のインターフェイスがあります。
RTCIdentityProvider- Enables a user agent is able to request that an identity assertion be generated or validated.
RTCIdentityAssertion- Represents the identity of the a remote peer of the current connection. If no peer has yet been set and verified this interface returns
null. Once set it can't be changed. RTCIdentityProviderRegistrar- Registers an identity provider (idP).
RTCIdentityEvent- Represents an identity assertion generated by an identity provider (idP). This is usually for an
RTCPeerConnection. The only event sent with this type isidentityresult. RTCIdentityErrorEvent- Represents an error associated with the identity provider (idP). This is usually for an
RTCPeerConnection. Two events are sent with this type:idpassertionerrorandidpvalidationerror. RTCCertificate- Represents a certificate that an
RTCPeerConnectionuses to authenticate.
電話通信
以下のインターフェイスは、公衆電話網 (public-switched telephone networks、PTSNs) と通信するために利用します。
RTCDTMFSender- Manages the encoding and transmission of dual-tone multi-frequency (DTMF) signaling for an
RTCPeerConnection. RTCDTMFToneChangeEvent- Indicates an occurrence of a of dual-tone multi-frequency (DTMF). This event does not bubble (except where otherwise stated) and is not cancelable (except where otherwise stated).
ガイド
- WebRTC プロトコル入門
- この記事では、WebRTC API の基礎となっているプロトコルについて説明しています。
- WebRTC connectivity
- A guide to how WebRTC connections work and how the various protocols and interfaces can be used together to build powerful communication apps.
- Lifetime of a WebRTC session
- WebRTC lets you build peer-to-peer communication of arbitrary data, audio, or video—or any combination thereof—into a browser application. In this article, we'll look at the lifetime of a WebRTC session, from establishing the connection all the way through closing the connection when it's no longer needed.
- Signaling and two-way video calling
- A tutorial and example which turns a WebSocket-based chat system created for a previous example and adds support for opening video calls among participants. The chat server's WebSocket connection is used for WebRTC signaling.
- Using WebRTC data channels
- This guide covers how you can use a peer connection and an associated
RTCDataChannelto exchange arbitrary data between two peers. - Using DTMF with WebRTC
- WebRTC's support for interacting with gateways that link to old-school telephone systems includes support for sending DTMF tones using the
RTCDTMFSenderinterface. This guide shows how to do so.
チュートリアル
- Improving compatibility using WebRTC adapter.js
- The WebRTC organization provides on GitHub the WebRTC adapter to work around compatibility issues in different browsers' WebRTC implementations. The adapter is a JavaScript shim which lets your code to be written to the specification so that it will "just work" in all browsers with WebRTC support.
- Taking still photos with WebRTC
- This article shows how to use WebRTC to access the camera on a computer or mobile phone with WebRTC support and take a photo with it.
- A simple RTCDataChannel sample
- The
RTCDataChannelinterface is a feature which lets you open a channel between two peers over which you may send and receive arbitrary data. The API is intentionally similar to the WebSocket API, so that the same programming model can be used for each.
リソース
プロトコル
WebRTC-proper プロトコル
- Application Layer Protocol Negotiation for Web Real-Time Communications
- WebRTC Audio Codec and Processing Requirements
- RTCWeb Data Channels
- RTCWeb Data Channel Protocol
- Web Real-Time Communication (WebRTC): Media Transport and Use of RTP
- WebRTC Security Architecture
- Transports for RTCWEB
関連する補助プロトコル
- Interactive Connectivity Establishment (ICE): A Protocol for Network Address Translator (NAT) Traversal for Offer/Answer Protocol
- Session Traversal Utilities for NAT (STUN)
- URI Scheme for the Session Traversal Utilities for NAT (STUN) Protocol
- Traversal Using Relays around NAT (TURN) Uniform Resource Identifiers
- An Offer/Answer Model with Session Description Protocol (SDP)
- Session Traversal Utilities for NAT (STUN) Extension for Third Party Authorization
仕様書
| 仕様書 | 状態 | 備考 |
|---|---|---|
| WebRTC 1.0: Real-time Communication Between Browsers | 勧告候補 | WebRTC API の初回定義。 |
| Media Capture and Streams | 勧告候補 | メディアコンテンツのストリームを伝達するオブジェクトの初回定義。 |
| Media Capture from DOM Elements | 草案 | DOM 要素からコンテンツのストリームを取得する方法の初回定義。 |
これらの API 仕様に加えて、Web RTC は リソース に示されているさまざまなプロトコルを用いる必要があります。