主播单格式说明

格式版本：1　·　最后更新：2026 年 10 月 5 日

主播单由整理者自己制作，在用户之间自行流转。汇流直播只负责导入和使用，不托管、不索引、不审核第三方主播单。主播单里的作者、简介和来源链接都由整理者自己填写，App 原样展示。

从模板开始

模板是一份最小的主播单，只有几位主播和一个分区示例。下载后用任意纯文本编辑器打开，把名称、作者和主播换成你自己的，保存为 .json 文件就能导入。修改时保留英文引号、冒号和逗号。

下载模板

完整示例

下面是一份用到全部字段的主播单，也可以下载这个示例文件。

{
  "schemaVersion": 1,
  "name": "周末一起看",
  "description": "我常看的几个直播间，按内容分了组。",
  "author": {
    "name": "示例作者",
    "url": "https://example.com/about-me"
  },
  "updatedAt": "2026-10-05",
  "cover": "https://example.com/streamer-list/cover.jpg",
  "sections": [
    { "id": "dance", "name": "热舞" },
    { "id": "lol", "name": "英雄联盟" },
    { "id": "chat", "name": "聊天" }
  ],
  "entries": [
    {
      "platform": "douyin",
      "roomId": "335354047186",
      "name": "示例主播 A",
      "avatar": "https://example.com/streamer-list/a.jpg",
      "avatarColor": "#6A5ACD",
      "sections": ["dance"],
      "note": "晚上八点后常在"
    },
    {
      "platform": "bilibili",
      "roomId": "21452505",
      "name": "示例主播 B",
      "sections": ["lol", "chat"]
    },
    {
      "platform": "douyu",
      "roomId": "9999",
      "name": "示例主播 C",
      "sections": ["lol"]
    },
    {
      "platform": "huya",
      "roomId": "kpl",
      "name": "示例主播 D"
    },
    {
      "platform": "tiktok",
      "roomId": "example.user.",
      "name": "示例主播 E",
      "note": "房间号末尾的句点也要照抄",
      "sections": ["chat"]
    }
  ]
}

顶层字段

条目字段

怎么查房间号

每位主播用「平台标识 + 房间号」确定，分别写进条目的 platform 和 roomId。房间号就在直播间或主播主页的链接里：

1. 在电脑浏览器里打开主播的直播间或主页。也可以在手机上的直播 App 里打开，点「分享」，选「复制链接」。
2. 复制链接。在浏览器里，直接复制地址栏里的完整链接。
3. 在下表找到这个平台，对照链接示例里加粗的那一段，在你的链接里找到同一个位置。把这一段原样写进 roomId，platform 写表里的小写英文标识。

手机 App 复制出来的常常是短链接，例如 v.douyin.com/…、b23.tv/…、xhslink.com/…、v.kuaishou.com/…、vm.tiktok.com/…、slink.bigovideo.tv/…，里面看不到房间号。遇到这种链接，请在电脑浏览器里打开直播间，从地址栏复制完整链接。

如果某个 platform 当前版本的汇流直播还不支持，这一条会保留并显示为灰色，不影响其他条目。

导入时的处理规则

• 缺少必填的顶层字段，或者文件不是 JSON，整份主播单无法导入。
• schemaVersion 比 App 支持的版本高时，App 会提示更新到新版本。
• 某一条缺少 platform、roomId 或 name，只跳过这一条，其他条目照常导入。导入时会告诉你是第几条、哪个字段。
• 同一份主播单里，platform 和 roomId 都相同的条目只保留第一条。
• 条目的 sections 里写了不存在的分区 id，只忽略那个 id。
• 选填字段格式不对时只忽略那个字段。
• 本页没有列出的字段会被忽略，所以你可以加自己的备注字段，不会影响导入。
• 分区只在这份主播单里有意义。两份主播单里同名的分区不会合并。

如何导入

在汇流直播里，用下面两种方式之一导入主播单：

• 订阅网址：把主播单文件放到任何能直接下载的网址上，在 App 里粘贴这个网址。网址需要以 https:// 开头，http:// 地址和家里 NAS 上的局域网地址都不能订阅，可以把文件下载下来再导入。你更新文件后，订阅的人会看到新内容。
• 导入文件：把 .json 文件通过微信、隔空投送或「文件」App 发给对方，对方在「文件」里选择它，或用「用汇流直播打开」导入。

单个主播单文件请不要超过 20MB。