虎牙开放平台文档
虎牙 • 开放平台
小程序

hyExt.context.onBarrageChange

  • 监听弹幕事件
  • 只保留最新的一次监听
  • 最大触发频率为每50毫秒一条
  • 引入版本 1.1.0
  • 适用终端
    • 虎牙直播主站
    • 虎牙直播APP-iOS：7.11.2
    • 虎牙直播APP-安卓：7.11.0
    • 虎牙直播助手-iOS：3.14.0
    • 虎牙直播助手-安卓：3.14.0
    • 虎牙直播PC客户端-主播侧：4.9.0.3
    • 虎牙直播PC客户端-观众侧：4.12.2.0

接口签名

declare namespace hyExt { module context { /** * 监听弹幕事件 * @param options 弹幕筛选条件 * @param callback 弹幕信息回调 */ function onBarrageChange( options: OnBarrageChangeOptions, callback: BarrageCallback ): Promise<void> } /** * 弹幕信息回调 */ type OnBarrageChangeOptions = { /** * 用户昵称关键字 */ sendNick?: string /** * 贵族等级 */ nobleLevel?: number /** * 粉丝等级 */ fansLevel?: number /** * 弹幕内容关键字 */ content?: string } /** * 弹幕信息回调 * @param barrageInfo 弹幕消息 */ type BarrageCallback = (barrageInfo: BarragerInfo) => void /** * 弹幕消息 */ type BarragerInfo = { /** * 发言人的昵称 */ sendNick: string /** * 发言人的头像地址 */ senderAvatarUrl: string /** * 发言人的性别；取值说明: 0 女; 1 男; */ senderGender: number /** * 发言人的贵族等级 */ nobleLevel: number /** * 发言人的粉丝等级 */ fansLevel: number /** * 弹幕内容 */ content: string /** * 用户unionId */ unionId: string /** * 粉丝徽章名 */ badgeName: string } }

示例代码

hyExt.context .onBarrageChange( { sendNick: "", nobleLevel: 0, fansLevel: 0, content: "", }, (barrageinfo) => { const { sendNick, senderAvatarUrl, senderGender, nobleLevel, fansLevel, content, unionId, badgeName, } = barrageinfo console.log("回调触发", barrageinfo) } ) .then(() => { console.log("调用hyExt.context.onBarrageChange成功") }) .catch((err) => { console.log("调用hyExt.context.onBarrageChange失败", err) })

相关链接

修改于 2026年04月24日 15:46