语音房间基础设施

在浏览器里,开一间实时语音房间

tytalk 提供语音房间所需的服务端能力:创建房间、分配麦位、签发加入凭证。听众和发言者直接在浏览器中收听与发言,不需要安装客户端。

注册账号阅读快速开始

只做语音,不含视频与录音。已有账号请登录控制台。

核心能力

以下能力均已在仓库中实现。尚未做的事情不写在这里。

浏览器里收听与发言

基于 WebRTC,在 Chrome 等浏览器中点一下按钮就能收听或发言。房间页同时显示连接状态和收发统计。

麦位管理

每个房间有 20 个麦位(0–19)。给某个 uid 分配麦位后,它的声音才进入房间;同一 uid 换到新麦位时,旧麦位自动腾出。

多租户隔离

每个租户使用自己的命名空间(ns)。账号只能看到并操作被授权的 ns;无权限和不存在的 ns,接口返回相同的错误。

短期通行证与登录保护

加入房间用一次性短期通行证,绑定当次连接,浏览器里不保存长期密钥。控制台登录需要口令加 6 位动态码。

三步开始

注册

填邮箱收验证码,同意协议,设置口令,绑定身份验证器。完成后记下账号 ID,登录用它。

去注册 →

登录控制台,建房间

用账号 ID、口令和动态码登录,选择命名空间,输入房间号,点「建房」。

登录控制台 →

打开收听与发言

在房间列表点「进入」。先给发言的 uid 分配麦位,再点「开始发言」;另开一个标签页「开始收听」。

看详细步骤 →

开发者入口

快速开始页按顺序写了注册、登录、建房、通行证和麦位的操作,并说明租户、命名空间、房间、通行证、麦位这几个概念,以及控制台接口和错误码。

快速开始与接口概述

接口目前由控制台网页使用,以会话 cookie 和 CSRF 令牌鉴权。面向服务端集成的公开调用入口尚未开放。

POST /api/v1/login
POST /api/v1/ns/{ns}/rooms
     {"room_id": "lobby"}
POST /api/v1/ns/{ns}/rooms/{room}/pass
     {"role": "listen", "uid": "<账号ID>.web1", "fp": "<64位hex>"}
POST /api/v1/ns/{ns}/rooms/{room}/slots/3/assign
     {"uid": "<账号ID>.web1"}