Live777 Core (liveion)

一个为 WebRTC 而生的 SFU 服务器。

默认支持 WHIP / WHEP 协议。启用 rtsp feature 后，liveion 还可以作为 RTSP 服务器运行：通过 ANNOUNCE/RECORD 推流，通过 DESCRIBE/PLAY 拉流。

a core SFU server, If you need a single server, use this

目前支持的编码

protocol	video codecs	audio codecs
WHIP	AV1, VP9, VP8, H265, H264	Opus, G722
WHEP	AV1, VP9, VP8, H265, H264	Opus, G722
RTSP	AV1, VP9, VP8, H265, H264	Opus, G722

目前客户端的支持情况

Application	AV1	VP9	VP8	H265	H264	OPUS	G722
Browser whip	⭐	⭐	⭐	⭐	⭐	⭐	⭐
Browser whep	⭐	⭐	⭐	⭐	⭐	⭐	⭐
Gstreamer whip	⭐	⭐	⭐	⭐	⭐	⭐	⭐
Gstreamer whep	📺 2	⭐	⭐	⭐	⭐	⭐	⭐
Gstreamer whipinto	📺 1	⭐	⭐	⭐	⭐	📺 1	⭐
Gstreamer whepfrom	📺 2	⭐	⭐	⭐	⭐	⭐	⭐
FFmpeg whipinto	💩	⭐	⭐	⭐	⭐	⭐	⭐
FFmpeg whepfrom	💩	⭐	⭐	⭐	⭐	⭐	⭐
VLC whipinto	💩	💩	⭐	⭐	⭐	⭐	💩
VLC whepfrom	💩	💩	⭐	⭐	⭐	⭐	💩
OBS Studio whip	📺 3	💩	💩	⭐	⭐	⭐	💩

• ⭐ 正常运行
• 💩 不支持
• 💡 未知/未测试
• 📺 存在问题（需注意）
  1. 正常运行，但浏览器无法播放此视频，Gstreamer 到 Gstreamer 传输正常
  2. 我不知道为什么 av1 和 whep 会出错
  3. OBS av1 编解码器无法播放

认证

关闭认证

注意

默认是关闭认证的

如果没有设置任何关于 [auth] 块的内容，会关闭认证

Bearer token

静态的 HTTP bearer token 只能是超级管理员权限。 一般用于开发，测试和集群管理

# WHIP/WHEP auth token
# Headers["Authorization"] = "Bearer {token}"
[auth]
# static JWT token, superadmin, debuggger can use this token
tokens = ["live777"]

JWT(JSON Web Token)

JWT 里面包含了权限信息，可以对单个流的推拉流和管理进行授权

# WHIP/WHEP auth token
# Headers["Authorization"] = "Bearer {token}"
[auth]
# JSON WEB TOKEN secret
secret = "<jwt_secret>"

Cascade

什么是 cascade?

庞大的集群

live777 Cascade 有两种模式：

• cascade-pull
• cascade-push

DataChannel 转发

NOTE: 关于 createDataChannel()

1. Live777 不支持 label, createDataChannel(label) 不使用 label
2. Live777 不支持 negotiated, 不支持 { id: 42, negotiated: true }

RTSP 服务器

使用 rtsp feature 编译，即可在 WHIP/WHEP 之外暴露 RTSP 服务：

cargo build --release --bin live777 --features rtsp

在 live777.toml 中配置监听 URL。当 URL 中包含凭据时，自动启用 Digest 认证：

[rtsp]
# 无认证：
listen = "0.0.0.0:8554"
# 启用 Digest 认证：
# listen = "rtsp://admin:secret@0.0.0.0:8554"

同一个端口同时处理推流和拉流：

• 推流地址：rtsp://host:8554/{stream_id}（ANNOUNCE + RECORD）
• 拉流地址：rtsp://host:8554/{stream_id}（DESCRIBE + PLAY）

同时支持 UDP 和 TCP（RTP/AVP/TCP）传输。URL 的第一段路径作为 liveion 的流标识符。