用通知回调录制小红书直播(官方步骤 + 详细说明)

本文按官方教程步骤整理,并补充匹配规则与排错细节,方便把小红书开播通知接到一号录播上,实现开播即录。

适用版本:一号录播 OneRecord 1.7.5

官方教程:bestlive.cc 原文

产品页:蝌蚪直播录制助手(一号录播)

一、原理

官方教程里的原话:

通过拦截安卓端小红书的直播开播通知,提取关键信息转发到桌面端一号录播,一号录播根据主播名称找到已经开播的数据进行开播检测。

拆开看就是三段:

  1. 手机端:安卓手机收到小红书的开播通知;
  2. 转发:通知转发器把这条通知转成 HTTP 请求,发到电脑上;
  3. 电脑端:一号录播收到后,按通知里的主播名,在监控列表里找到对应条目,立刻检测是否开播;开播就开始录。

关键点:通知只负责「催一下」,真正录制的是你电脑上那条监控项。所以第一步必须先把主播加进软件。

二、准备清单

项目 要求
电脑 一号录播运行中,已添加该主播的监控项
手机 安卓手机(需安装小红书 App 并登录)
转发工具 安卓版「蝌蚪通知转发器」(官方推荐,前往其首页下载即可)
网络 手机与电脑在同一个内网(同一 Wi-Fi)
关注关系 在小红书里关注目标主播,建议设为星标关注

三、执行步骤

步骤 1:在一号录播添加需要监控的主播

点左上角「解析」,粘贴主播的主页链接。官方教程给出的链接格式:

https://www.xiaohongshu.com/user/profile/627c529a000000002102bc21

也就是 https://www.xiaohongshu.com/user/profile/{用户ID}。

添加后软件会解析出主播昵称等信息,界面通常显示「识别网站: 小红书号监控(监控链接无需预解析)」之类。

按官方教程,这一步的目的是先拿到主播名称等信息,不需要开启监控——触发录制交给后面的开播通知。

如果你希望软件自己也轮询兜底(通知万一没送到也能录),可以把该条「自动录制」设为「是(需设置中开启自动录制)」,并在设置 → 开启自动录制打开总开关。

补充:如果只能拿到小红书号,也可以用「网站下拉选『小红书』+ 填小红书号」的方式,软件会拼成 https://www.xiaohongshu.com/red_id/profile/{小红书号},同样能识别。但官方推荐用 user/profile 主页链接,优先照这个来。

步骤 2:安装安卓「蝌蚪通知转发器」

  1. 在安卓手机上下载安装蝌蚪通知转发器(官方说明:直接前往其首页下载即可);
  2. 打开后授予通知读取权限(系统设置 → 通知使用权 / 通知访问),否则读不到小红书推送;
  3. 确保系统没有把它后台杀掉:关闭省电策略、允许后台运行、允许自启动。

步骤 3:获取内网回调地址

打开一号录播 → 设置 → 通知回调(窗口标题为「开播推送」):

  1. 勾选「启用开播推送」(不勾选不会监听端口);
  2. 窗口上方显示一行 Webhook 地址,点「复制地址」,例如:
    http://192.168.0.114:18081/live
    官方教程特意提醒:内网地址会不一样,请确保手机和一号录播处于同一内网,通知才能转发过来。
  3. 正常状态下会显示:「服务已启动。收到推送后会按 appLabel 匹配平台、streamer 匹配主播,并检测对应监控项是否已开播。最多保留 200 条。」若显示「服务未启动」,通常是 18081 端口被占用。

把这个地址填到转发器的推送配置里(POST)。地址约每 2 秒自动刷新,换了 Wi-Fi 后记得重新复制。

步骤 4:转发器监听小红书并推送

在蝌蚪通知转发器里:

  1. 新建 / 配置通知通道,把上一步复制的地址填进去;
  2. 选择监听小红书这一个应用(只放行小红书,避免其他 App 通知刷屏);
  3. 推送方式选推送到一号录播(即 HTTP POST 到该地址)。

步骤 5:在小红书里关注主播(关键)

官方教程最后一步:

去小红书关注监控的主播,最好设置为星标关注,这样每次开播都能推送;非星标要每次开播前都要预约开播通知。

这条很容易被忽略,但决定了整套流程能不能跑通:

  • 星标关注:每次开播都会推通知 → 全自动;
  • 普通关注:需要你每次手动点「预约开播」才会有通知 → 容易漏。

所以添加完监控项后,务必去小红书 App 里把该主播设为星标关注。

四、验证是否接通

在「开播推送」窗口里可以看到最近 200 条接收记录,四列为:接收时间 / 来源 IP / 匹配结果 / Body 预览。点一行可看完整详情(含 Content-Type、Query、User-Agent、原始 Body)。

验证方法:让主播开播一次,或自己发一条测试推送,看列表里是否出现新记录、匹配结果是否显示「已匹配 N 项,正在检测是否开播」。

五、进阶:推送字段与匹配规则

转发器推送的是一段 JSON,一号录播按这些字段识别(了解它有助于排查「为什么没匹配上」):

字段 是否必填 说明
packageName 二选一 小红书包名,含 xingin / xiaohongshu / xhs 任一即可,如 com.xingin.xhs
appLabel 二选一 应用显示名,填「小红书」
title 建议 通知标题
text 建议 通知正文
dump 可选 通知原始文本,识别率最高
streamer 可选 显式指定主播名,优先级最高

平台识别包名优先,包名没匹配上才用 appLabel。

主播名提取顺序:

  1. 正文里的 @昵称 开播了;
  2. dump 里的 android.text / text;
  3. 通知标题(会自动剥掉 [你的关注]、[你预约的]、[特别关注] 等标签,以及「正在直播中」「刚刚开始直播」「开播了」等后缀);
  4. streamer 字段;
  5. dump 里的 host_nickname= 参数。

匹配方式:去掉空格和符号、忽略大小写后比较,再做相似度判断。小红书专门放宽了阈值(长名 0.6、≤3 字短名 0.62,比其他平台宽松),以适应昵称里的括号、表情、空格。

典型通知样例:

样例1:title=你预约的直播开始啦,text=@以茉的温柔日记(冲1000粉) 开播了
样例2:title=赴海(国一橘右京) [你的关注],text=正在直播:房间标题

六、收到推送后会发生什么

  • 找到匹配项 → 立刻对该监控项做一次解析;
  • 该项已在下载中 / 准备中 / 浏览器解析中 → 跳过,不会重复录;
  • 该项已取消或已关闭 → 跳过;
  • 解析失败 → 30 秒后自动重试一次,仍失败会发一条「开播推送解析失败」的站内通知;
  • 一条推送可同时命中多个监控项。

七、排错对照表

现象 / 提示 原因 处理
未匹配到监控项:平台=小红书,主播=xxx 通知里的昵称和监控项名字差太多 把监控项主播名改成和通知一致
未识别平台:xxx 包名 / appLabel 未命中 确认包名为小红书,或补 appLabel: 小红书
缺少 appLabel 或主播标识 平台和主播名都没有 转发器里保留包名和正文
Body 不是 JSON 推送的不是 JSON 转发器里设置 application/json
解析失败:…,30秒后重试 网络或 Cookie 问题 检查网络,补充小红书 Cookie(a1、web_session)
已开播(下载中),跳过 已在录制 正常
列表一直没有新记录 手机电脑不同内网 / 转发器权限没给 / 端口被占 逐项检查;确认防火墙放行 18081
主播开播了但没通知 非星标关注 去小红书设为星标关注,或每次手动预约
换 Wi-Fi 后失效 内网 IP 变了 重新复制 Webhook 地址

八、常见问答

Q:一定要用蝌蚪通知转发器吗?
A:官方教程推荐它。从原理上说,任何能把安卓通知转成 HTTP POST 发到 http://<内网IP>:18081/live 的工具都可以,一号录播只负责接收。

Q:需要电脑一直开着吗?
A:需要。通知是实时的,电脑关机或睡眠期间收不到,也不会补录。

Q:还要不要开监控轮询?
A:官方步骤说首次添加不需要开监控,靠通知触发即可。想更稳可以再打开自动录制作为兜底。

Q:小红书解析需要 Cookie 吗?
A:需要(涉及 a1、web_session)。软件内置小红书 Cookie 槽池会自动轮询可用槽位,你也可以在 Cookie 管理里补充自己的 Cookie,提高稳定性。

Q:自动录制时长有下限吗?
A:有,小红书最少 5 分钟,填小于 5 会被自动纠正为 5(快手同样)。

请遵守平台规则与当地法律法规,仅录制你有权保存的内容。

返回列表 下一篇 不用 Cookie,也能把 BIGO 直播完整录下来