
like-webrtc 发布:内置信令与节点发现的点对点 WebRTC 连接方案
来源标题:Peer-to-peer WebRTC connections with built-in signaling and discovery
like-webrtc 提供内置信令和节点发现的点对点 WebRTC 连接,可在浏览器、Node.js 和 React Native 中运行。它支持自动 SDP/ICE 交换、用可分享的加密地址替代 IP、按共享主题发现节点,并默认配置 STUN 与 TURN。开发者可借此直接使用数据通道及音视频轨道。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Peer-to-peer WebRTC connections with built-in signaling and peer discovery。可在浏览器、Node.js 和 React Native 中运行。
npm i like-webrtc
P2P 服务器。可在任何地方监听对等连接,甚至是在浏览器里。
直连。跨设备和网络连接对等节点。
内置信令。自动完成 SDP/ICE 交换与协商。
身份标识。使用可分享的加密地址,而非 IP 地址。
对等发现。使用共享主题来广播和查找对等节点。
WebRTC API。使用 data channel、音视频 track 和 transceiver。
开箱即用。默认已配置好信令、STUN 和 TURN。
在线演示:https://web.leet.ar(48 小时内构建的 P2P Discord 克隆)
需要 WebRTC 支持?欢迎在 GitHub 上提 issue :)
直连点对点连接
一个对等节点可以创建一个服务器,以公钥作为地址进行监听。
另一个对等节点可以使用该地址连接到服务器。
import RTC from 'like-webrtc' const rtc = new RTC() const server = rtc.createServer(peer => { const channel = peer.createDataChannel('wire', { negotiated: true, id: 0 }) channel.addEventListener('open', () => channel.send('Hello from the server')) channel.addEventListener('message', e => console.log('Server received:', e.data)) }) const keyPair = RTC.keyPair() await server.listen(keyPair) const rtc2 = new RTC() const peer = rtc2.connect(server.publicKey) const channel = peer.createDataChannel('wire', { negotiated: true, id: 0 }) channel.addEventListener('open', () => channel.send('Hello from the client')) channel.addEventListener('message', e => console.log('Client received:', e.data))
API 风格类似 Node.js 的 http,但它是点对点的,并且直接在浏览器中运行。
点击查看示例
对等节点可以使用随机密钥对创建服务器。
你可以在同一个共享主题下广播或查找任意服务器。
import RTC from 'like-webrtc' const rtc = new RTC() const server = rtc.createServer(peer => { console.log('New peer connection') // ... }) await server.listen() await server.announce('random-group') const rtc2 = new RTC() const results = await rtc2.lookup('random-group') const peer = rtc2.connect(results[0].publicKey) // ...
Swarm 对等节点
点击查看示例
每个对等节点运行相同的代码来加入 swarm。
import RTC from 'like-webrtc' const rtc = new RTC() const server = rtc.createServer(peer => { console.log('New swarm connection') // ... }) await server.listen() await server.join('random-swarm')
SIGNALING
单一信令服务器:
它是一个使用 RPC 协议的 WebSocket 服务器。
rtc = new RTC([options])
创建一个 WebRTC 实例。
signaling, // 默认为 'wss://party.leet.ar:41337'。 keyPair, // 默认为从 seed 或随机字节生成的密钥对。 seed, // 用于生成密钥对的种子。 iceServers, // 默认为本包提供的 STUN 和 TURN 服务器。 iceTransportPolicy, // 默认为 'all'。 trickle, // 默认为 true。 RTCPeerConnection, // 可选的 WebRTC 实现覆盖。 RTCIceCandidate // 可选的 ICE candidate 实现覆盖。
peer = rtc.connect(publicKey[, options])
创建一个 P2P 连接并返回 RTCPeerConnection。
添加 data channel、track 或 transceiver 即可开始 WebRTC 协商。
keyPair // 默认为 rtc.keyPair。
peer.isInitiator
标识客户端(true)还是服务器(false)一侧。
用于此连接的本地公钥,以 buffer 形式表示。
用于此连接的本地公钥,以 Base58 字符串形式表示。
远端对等节点的公钥,以 buffer 形式表示。
创建一个接受 WebRTC 连接的 P2P 服务器。
handler 会接收每一个传入的对等连接。
keyPair, // 默认为 rtc.keyPair。 firewall // 允许的公钥的函数或数组。默认允许所有对等节点。
server.on('connection', peer)
在每个传入的 RTCPeerConnection 上触发,与 handler 相同。
以 buffer 形式返回服务器的公钥。
以 Base58 字符串形式返回服务器的公钥。
开始在服务器公钥下监听连接,以便对等节点可以连接。
在 topic 下广播正在监听的服务器,并在服务器监听期间持续刷新该广播。
服务器关闭时会移除该广播。
移除服务器在 topic 下的广播。
服务器会继续监听直连。
如果服务器已加入 topic,它会继续查找对等节点。
在你调用 server.announce(topic) 或离开后重新加入之前,该 topic 保持未广播状态。
查找广播了 topic 的对等节点并连接它们。
如果服务器正在监听,它也会在该 topic 下广播自己。
服务器会为每个发现的连接触发 connection 事件。
已关闭的连接会在 1 秒、5 秒、15 秒后重试,之后每 10 分钟重试一次。
如果该 topic 仅由 server.join(topic) 广播,则也会移除该广播。
由 server.announce(topic) 发出的广播则保持有效。
取消重试,除非该对等节点还在另一个已加入的 topic 下被发现。
关闭服务器的对等连接,移除其 topic 广播,并关闭其信令连接。
使用 keyPair 签名并发送广播。
keyPair // 默认为 rtc.keyPair。
除非你刷新或移除,否则该广播会过期。
使用 keyPair 签名并发送移除广播的请求。
keyPair // 默认为 rtc.keyPair。
peers = await rtc.lookup(topic)
返回在 topic 下广播的对等节点:
{ publicKey }
即使对等节点突然断开(除非正常关闭),广播仍可能保留。
在信令短暂中断或页面刷新后重连期间,对等节点仍可保持可被发现。
此间隙期间的 lookup 可能返回一个仍处于离线状态的对等节点。
关闭 RTC 实例、其服务器、其对等节点及其信令。
如果你直接调用了 rtc.announce(),请调用 rtc.unannounce() 来移除这些广播。
如果你不移除这些手动广播,它们会一直可用直到过期。
创建一个密钥对。传入 seed 可每次创建相同的密钥对。
将 WebRTC data channel 或 WebSocket 包装为双工流。
便于与常见的 Node.js 流进行交互。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。