WebRTC 的常用方法和其简短注释

整理了一些WebRTC常用方法，以备查询：

WebRTC（Web Real-Time Communication）是一种用于在浏览器之间实时传输音频、视频和数据的开放标准和技术集合。它提供了一套用于建立点对点通信的API，使开发人员能够在浏览器中实现实时通信应用程序，如音视频通话、实时聊天、文件共享等。

WebRTC 的主要特点和功能包括：

1. 实时音视频通信：WebRTC 可以在浏览器之间建立实时的音频和视频通信，支持高质量的音视频编解码、传输和同步。

2. 网络传输和 NAT 穿越：WebRTC 使用标准的网络协议和技术，包括ICE（Interactive Connectivity Establishment）和STUN（Session Traversal Utilities for NAT）等，以实现对不同网络环境和防火墙的穿越，使通信能够在各种网络条件下稳定运行。

3. 数据通道：除了音视频通信，WebRTC 还提供了数据通道，可以在浏览器之间传输任意类型的实时数据，支持点对点的低延迟、高带宽的数据传输。

4. 简化的开发：WebRTC 提供了一套易于使用的 JavaScript API，使开发人员能够轻松地构建实时通信应用程序，无需安装额外的插件或软件。

应用场景包括实时视频会议、在线教育、远程协作、在线游戏、实时监控和直播等，WebRTC 已经被广泛应用于各种实时通信和协作领域。

getUserMedia(): 通过摄像头和麦克风获取本地的媒体流（视频流和音频流）。
RTCPeerConnection(): 创建一个用于实现点对点连接的对象，可以通过它发送和接收媒体流。
addTrack(): 将媒体轨道（音频或视频）添加到 RTCPeerConnection 对象中。
removeTrack(): 从 RTCPeerConnection 对象中移除媒体轨道。
createOffer(): 创建一个 SDP（Session Description Protocol） offer，用于发起连接请求。
createAnswer(): 创建一个 SDP answer，用于应答连接请求。
setLocalDescription(): 设置本地的 SDP 描述。
setRemoteDescription(): 设置远程的 SDP 描述。
addIceCandidate(): 添加 ICE（Interactive Connectivity Establishment）候选者，用于进行 ICE 连接。
onicecandidate: 当 ICE 候选者可用时触发的事件。
ontrack: 当接收到新的媒体轨道时触发的事件。
onaddstream: 当接收到新的媒体流时触发的事件。
onremovestream: 当媒体流被移除时触发的事件。
createDataChannel(): 创建一个用于在对等连接之间传输数据的数据通道。
send(): 在数据通道上发送数据。
ondatachannel: 当有新的数据通道连接建立时触发的事件。

实例：利用WebRTC实现web页面的截图（当然也能把当前页面推流直播）

// 获取屏幕截图
function captureScreen() {
  navigator.mediaDevices.getDisplayMedia({ video: true })
    .then(function(stream) {
      const videoTrack = stream.getVideoTracks()[0];
      const imageCapture = new ImageCapture(videoTrack);
      return imageCapture.grabFrame();
    })
    .then(function(imageBitmap) {
      // 将图像展示在页面上
      const canvas = document.createElement('canvas');
      canvas.width = imageBitmap.width;
      canvas.height = imageBitmap.height;
      const context = canvas.getContext('2d');
      context.drawImage(imageBitmap, 0, 0);
      document.body.appendChild(canvas);
    })
    .catch(function(error) {
      console.error('截图失败:', error);
    });
}

// 调用截图函数
captureScreen();