工具插件合集

本页补齐此前未单独成页的工具类插件文档。

插件清单

插件	Feature	是否有 HTTP API	说明
LogRotate	logrotate	否	日志轮转与保留策略
Debug	debug	视构建而定	开发调试辅助
SEI	sei	否	H.264/H.265 SEI 注入
Crontab	crontab	否（主要配置驱动）	定时任务调度
Mix	mix	否（以能力接入为主）	多流混流
Crypto	crypto	否	内容加密能力
Report	report	是	媒体质量指标上报
Test	test	是	集成测试与压测接口

详细文档入口

• Test 测试插件
• Report 上报插件
• LogRotate 日志轮转插件
• Debug 调试插件
• SEI 注入插件
• Crontab 定时任务插件
• Mix 混流插件
• Crypto 加密插件

LogRotate

启用

features = ["logrotate"]

关键配置

logrotate:
  path: "./logs"
  max_size: 10485760
  max_files: 7
  level: "info"

Crontab

启用

features = ["crontab"]

典型配置

crontab:
  jobs:
    - name: "daily-record"
      cron: "0 8 * * *"
      action: "record_start"
      stream: "live/camera01"
      duration: 3600

Report（HTTP API）

前缀：/report/

上报指标

POST /report/metrics
Content-Type: application/json

请求体核心字段：

字段	类型	必填	说明
user_id	string	是	用户 ID
room_id	string	是	房间 ID
sdk_version	string	是	SDK 版本
report_time	int64	是	上报时间戳
metrics	array	是	指标集合

查询房间列表

GET /report/rooms

查询房间指标

GET /report/metrics/{room_id}
GET /report/metrics/{room_id}/{user_id}

查询历史

GET /report/history/{room_id}

Test（HTTP API）

前缀：/test/

用例与任务查询

GET /test/
GET /test/integration
GET /test/stress
GET /test/cases
GET /test/api/cases
GET /test/api/stress/count

执行与压测

POST /test/api/cases/execute
POST /test/api/stress/push/{protocol}/{count}
POST /test/api/stress/pull/{protocol}/{count}
POST /test/api/stress/stop/push
POST /test/api/stress/stop/pull
POST /test/stop

关键请求体示例

执行用例：

{ "names": ["basic_rtmp_to_flv", "webrtc_publish"] }

推流压测：

{
  "remoteURL": "rtmp://localhost/live/stress/%d",
  "streamPath": "live/source"
}

拉流压测：

{
  "remoteURL": "rtmp://localhost/live/source",
  "testMode": 0
}