哔哩哔哩 API
  1. 直播间长连和消息
哔哩哔哩 API
  • 新手指引
    • 平台简介
    • 开发者入驻
    • 应用管理
  • 接入指引
    • 网页应用接入
    • ios应用接入
    • andriod应用接入
    • SDK信息收集告知表
  • 开放能力
    • 账号授权
    • 接口签名实现标准和状态码
    • 权限白名单说明
    • 用户管理
      • 查询用户已授权权限列表
      • 获取用户公开信息
      • 获取用户的 union_id
    • 视频稿件管理
      • 服务端视频稿件投递
        • 接口概览
        • 文件上传预处理
        • 文件分片上传
        • 文件分片合片
        • 封面上传
        • 视频稿件提交
        • 分区查询
        • 单个小视频文件上传
      • 用户端唤起粉段投稿
        • 业务说明
        • 唤起粉端投稿接口说明
      • 视频稿件查询
        • 查询单一视频稿件详情
        • 查询用户视频稿件列表
      • 视频稿件编辑
      • 视频稿件删除
    • 专栏稿件管理
      • 文章管理
        • 查看文章
          • 查询文章详情
          • 查询文章列表
          • 获取文章的分类列表
          • 获取视频、文章卡片信息
        • 文章提交
        • 文章编辑
        • 文章删除
      • 文集管理
        • 文集编辑
          • 文集信息编辑
          • 文集下文章列表修改
        • 查看文集
          • 查询文集列表
          • 查询文集详情
        • 文集提交
        • 文集删除
      • 图片上传
        • 专栏稿件图片上传
    • 账号管理
      • 通过授权码获取access_token
      • 通过刷新令牌续期access_token
    • 数据开放服务
      • 用户数据
        • 获取用户数据
      • 视频数据
        • 获取单个稿件数据
        • 获取整体稿件增量数据
      • 专栏数据
        • 获取单一专栏数据
        • 获取单一专栏数据
    • 直播能力
      • 接入指南
      • 直播间长连和消息
        • 直播间消息websocket协议
        • 长连CMD说明
        • 直播房间长链信息及心跳ID
          POST
        • 直播房间长链心跳
          POST
        • 直播房间批量长链心跳
          POST
      • 开播能力嵌入(一键开播)
        • 一键开播说明
        • 业务流程说明
        • 开播接口列表
          • 开播授权
          • 开始直播
          • 结束直播
      • 获取直播间基础信息
        GET
      • 获取直播间详细信息
        POST
  • WebHooks
    • 概述
    • 事件列表
  • 常见工具
    • 示例代码
    • 沙盒环境
  • 运营指南
    • 运营规范
    • 处罚规则
    • 处罚公告
  • 其他
    • 状态码
    • 联系我们
  1. 直播间长连和消息

直播间消息websocket协议

长连说明#

1. 发送AUTH包#

弹幕服务器连接成功后,客户端首先发送一个Proto包,Operation字段置为OP_AUTH,Body字段为连接字符串,格式为json。

2. 发送心跳#

频率30s。
body为空即可。
协议格式:(基于websocket之上的应用层协议,所有字段 大端 对齐)。
协议
Packet Length:整个Packet的长度,包含Header。
Header Length:Header的长度,固定为16。
Version:
如果Version=0,Body中就是实际发送的数据。
如果Version=2,Body中是经过压缩后的数据,请使用zlib解压,然后按照Proto协议去解析。
Operation:消息的类型:
名称值解释说明
OP_HEARTBEAT2客户端发送的心跳包(30秒发送一次)
OP_HEARTBEAT_REPLY3服务器收到心跳包的回复
OP_SEND_SMS_REPLY5服务器推送的弹幕消息包
OP_AUTH7客户端发送的鉴权包(客户端发送的第一个包)
OP_AUTH_REPLY8服务器收到鉴权包后的回复
Sequence ID:保留字段,可以忽略。
Body:消息体,客户端解析Body之前请先解析Version字段。
body的内容一般是json格式,里面一条广播消息称为cmd:
Version=2时,zlib压缩后的body格式可能包含多个完整的proto包(可以理解为递归)。
proto

【哔哩哔哩】API开发者 微信交流群

用微信扫右侧二维码,加入【哔哩哔哩】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2025-10-13 06:38:55
上一页
接入指南
下一页
长连CMD说明
Built with