流媒体与实时通信 / 系统课时

把音频轨道接入 PeerConnection

把音频轨道接入 PeerConnection

拿到麦克风后,真正进入 WebRTC 发送链路的是 MediaStreamTrack,不是整个 MediaStream。本节调用 addTrack() 接入音轨,并验证返回的 RTCRtpSender 与发送路径的关系。

学习目标

  • 说清 MediaStreamTrack、RTCRtpSender 与 RTCPeerConnection 的职责边界。
  • 使用 addTrack() 把麦克风音轨加入发送端,并从 getSenders() 验证结果。
  • 理解静音、替换轨道和移除发送轨道时,应该操作哪个对象。

一条音轨是怎样进入发送链路的

getUserMedia() 返回 MediaStream,它更像一组轨道的容器;真正承载声音数据的是 MediaStreamTrack。调用 pc.addTrack(track, stream) 后,RTCPeerConnection 会为这条轨道创建并返回一个 RTCRtpSender,后续编码、RTP 发送和轨道替换都沿着这个 sender 管理。

音频轨道接入 PeerConnection 的关系图

这里的关键关系是:track 是媒体源,sender 是发送控制句柄,PeerConnection 是协商与传输容器。同一个 MediaStream 可以包含多条轨道,而 getSenders() 返回的是已经挂到该连接上的所有发送器。

用 addTrack 接入麦克风音轨

下面页面在点击按钮后请求麦克风权限,只取第一条音频轨道并调用 addTrack()。它不会建立远端连接,但足以验证本地发送路径已经组装完成;请通过 https:// 或 http://localhost 打开页面。

html
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>WebRTC addTrack demo</title>
<button id="start">采集并接入音轨</button>
<pre id="log"></pre>
<script>
const pc = new RTCPeerConnection();
const button = document.querySelector("#start");
const log = document.querySelector("#log");

button.addEventListener("click", async () => {
  button.disabled = true;

  // MediaStream 是容器,真正加入 PeerConnection 的是 audio track。
  const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
  const track = stream.getAudioTracks()[0];
  const sender = pc.addTrack(track, stream);

  const lines = [
    `track.kind = ${track.kind}`,
    `track.readyState = ${track.readyState}`,
    `sender.track === track = ${sender.track === track}`,
    `pc.getSenders().includes(sender) = ${pc.getSenders().includes(sender)}`
  ];

  log.textContent = lines.join("\n");
});
</script>
</html>

预期输出

text
track.kind = audio
track.readyState = live
sender.track === track = true
pc.getSenders().includes(sender) = true

浏览器会先弹出麦克风授权。若用户拒绝授权,getUserMedia() 会失败,代码自然不会执行到 addTrack();这与 PeerConnection 本身无关,应先解决权限或安全上下文问题。

后续控制为什么要抓住 sender

addTrack() 的返回值不要随手丢掉。需要在通话中切换麦克风设备时,可以先获取新的音频轨道,再调用 sender.replaceTrack(newTrack),通常不必重新创建 RTCPeerConnection。如果只是临时静音,可设置 track.enabled = false,连接仍保留,只是该轨道输出静音帧。

若要把发送器从连接中移除,应使用 pc.removeTrack(sender)。这会停止该 sender 继续发送,但不会自动调用 track.stop() 关闭麦克风设备;是否释放设备由应用自己决定。

判断是否真的接入成功

本节只验证“轨道已经挂到发送端”,还没有证明远端能听到声音。可以用三个信号做本地检查:音轨状态是 live、sender.track 指向原轨道、pc.getSenders() 能找到该 sender。真正端到端可用还需要 SDP Offer/Answer、ICE 连通性和远端 track 事件共同成立。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把音频轨道接入 PeerConnection

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通