
Trystero 发布:让静态网站无需服务器即可实现多人实时互动
来源标题:Trystero – Serverless peer-to-peer multiplayer for the web
Trystero 是一个无需服务器、账号或 API key 的 WebRTC 库,导入后即可让静态站点变成实时多人应用。它支持按房间名自动发现用户,内置用户身份验证、状态同步、RPC、文件传输及音视频功能,可直接从 GitHub Pages 或单个 HTML 文件部署。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Trystero 能把任何静态站点变成一个实时多人应用。引入这个库,按名字加入一个房间,浏览器之间就会立刻互相发现。不需要账号、不需要 API key、不需要任何基础设施。非常适合 coding agent 使用。
一个房间所需的一切 房间自带经过验证的用户身份、按用户同步且可共享的状态、host 权限、RPC、分块文件传输,以及实时音频和视频。你可以从 GitHub Pages、Neocities,甚至单个 HTML 文件发布一个多人游戏或协作工具。
这个页面上移动的光标,属于通过 Trystero 连接的其他访客。用两个浏览器打开这个页面并移动指针即可看到。你也可以跳过打包工具,在 module script 里直接从 https://esm.run/trystero 引入。
import {joinRoom} from 'trystero' const room = joinRoom({appId: 'pixel-party.example.com'}, 'studio-49') const cursor = room.makeUserState('cursor', {x: 0, y: 0}) window.addEventListener('pointermove', e => cursor.set({x: e.clientX, y: e.clientY}) ) cursor.onChange((pos, {userId, self, removed}) => { if (self) { return if (removed) { removeCursor(userId) } else { drawCursor(userId, pos) })
发现机制如何工作 WebRTC 让浏览器直接相连,但在直连建立之前,peer 之间仍然需要 signaling 来交换连接 offer。Peers 通过公共 relay 自动找到彼此,无需部署、配置或维护任何 signaling 服务。Relay 只承载经过哈希的房间 topic 和加密握手。一旦连接建立,状态、消息、文件和媒体都在浏览器之间直接流动。
Nostr 是默认选项。切换到 MQTT、BitTorrent、Supabase、Firebase 或自托管的 WebSocket relay,只需改一行 import。
多人应用通常跟踪两类状态:每个参与者各自拥有的按用户值(名字、光标、准备标记),以及面向整个群组的共享房间值(游戏棋盘、回合计时器或播放队列)。写入会立即在本地生效,在网络上合并快速更新,携带作者的签名,并同步给后加入者——即使原写入者已经离开。
这两个原语都直接匹配 React 的 useSyncExternalStore 契约。
// Per-user state: each user signs and updates their own slot
const profile = room.makeUserState('profile', {
name: 'Anon',
ready: false
})
profile.set({name: 'Oedipa', ready: true})
console.log(profile.getAll()) // {[userId]: {name, ready}}
// Shared room state, synced to late joiners
const track = room.makeState('track', {
url: 'beat.mp3',
paused: true
})
track.onChange((next, {userId}) => {
syncAudioPlayer(next)
console.log(Updated by ${userId})
})
await track.set(prev => ({...prev, paused: false}))
import {useSyncExternalStore} from 'react' function Lobby() { const players = useSyncExternalStore( profile.onChange, profile.getAll ) const nowPlaying = useSyncExternalStore( track.onChange, track.get )
经过验证的身份、密码与房间人数上限 每个参与者都会获得一个持久化的 userId,它由 ECDSA 密钥对派生,并在 WebRTC 握手期间得到验证,全程无需登录流程或认证服务器。刷新页面或打开另一个标签页会保留同一身份,identity 配置还支持每个标签页的临时密钥,或从你的应用导入的密钥。
将 password 和 maxUsers 结合使用,可以创建私有且限制座位的房间,例如双人对局或四座大厅。
const room = joinRoom( appId: 'chess.example.com', password: 'knight-takes-f7-secret', maxUsers: 2 'table-7' ) const {userId} = await room.getSelf() room.onUserJoin(({userId}) => addPlayer(userId)) room.onUserLeave(({userId}) => removePlayer(userId)) room.onError(err => { if ( err.code === 'room-full' && Object.keys(room.getPeers()).length === 0 ) { showBanner('Match already has two players.') })
Host、自定义角色与内容管理 纯粹的 peer-to-peer 房间把所有参与者一视同仁,而一旦任何客户端都能打开 DevTools 覆盖游戏状态,这种平等就会失效。可选的 roles() 插件增加了经过验证的房间管理员、诸如 'dj' 或 'moderator' 的自定义角色、受角色限制的状态与操作,以及 peer 封禁。Peers 会根据作者的签名和角色证书验证每一次写入,在到达时丢弃未经授权的修改。
import {joinRoom, roles} from 'trystero' const room = joinRoom( {appId: 'oedipa/friday-trivia', use: [roles({selfAsAdmin: true})]}, 'quiz-night' ) // Invite guests with roomId ("quiz-night~<adminUserId>") const {roomId} = await room.getSelf() // With roles() loaded, makeState defaults to admin-only writes const game = room.makeState('game', { round: 1, prompt: 'Ready?' }) await game.set({round: 2, prompt: 'Moons of Mars?'}) await room.grantRole(friendId, 'cohost') await room.ban(spammerId, {reason: 'spoiling answers'})
操作、RPC 与文件传输 用 room.makeAction() 创建命名通道,用于临时事件、请求/响应调用和二进制传输。可以发送字符串、JSON、Blob、File 或 typed array;Trystero 负责帧处理、分块、背压、元数据和传输进度。大文件使用与小消息相同的通道 API,并在 peer 之间直接流式传输,无需中间存储。
const drop = room.makeAction('file-drop') drop.onReceive(({byteLength}) => byteLength <= 100 * 1024 ** 2) drop.onReceiveProgress((pct, {metadata}) => showDownloadBar(metadata.name, pct) ) drop.onMessage((bytes, {metadata}) => saveFile(bytes, metadata.name) ) await drop.send(file, { metadata: {name: file.name}, onProgress: pct => showUploadBar(pct) }) // Request/response RPC const roll = room.makeAction('roll', {kind: 'request'}) roll.onRequest(() => Math.ceil(Math.random() * 20)) const d20 = await roll.request(null, { target: friendId, timeoutMs: 2000 })
音频、视频与屏幕共享 将麦克风音频、摄像头视频、屏幕采集、canvas.captureStream() 或 Web Audio 输出发送到整个房间或特定用户。用 metadata 标记流,以区分摄像头画面和屏幕共享,并在通话中通过 replaceTrack 切换轨道。
const stream = await navigator.mediaDevices.getUserMedia({
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。