1. 指令概述
该 RPA 指令用于向目标网页注入弹幕监听逻辑，可实时捕获网页中的弹幕内容，并通过配置自定义规则提取所需数据，是直播、视频类网页弹幕数据采集的核心前置指令。
2. 配置参数
| 参数名 | 必填 | 说明 |
|---|---|---|
| 网页 | 是 | 选择需要监听弹幕的目标网页对象，需为当前流程中已打开的网页。 |
| 监听元素类型 | 是 | 选择弹幕对应的 HTML 元素类型（如 div、span），需与目标网页的弹幕 DOM 结构匹配。 |
| 元素 | 是 | 通过「捕获新元素」按钮定位弹幕的父容器或具体节点，用于精准锁定弹幕渲染区域。 |
| 监听 ID | 是 | 定义一个变量名作为监听实例的唯一标识，后续可通过该 ID 关联获取弹幕数据。 |
| 弹幕 JS 筛选函数 | 否 | 输入自定义 JavaScript 函数，用于处理每条弹幕元素，提取所需字段（如用户名、弹幕内容）。示例：ele=>{return ele.getAttribute('data-danm')} |
3. 使用示例
场景：采集某直播平台弹幕内容与发送者
- 常规配置 在「网页」下拉框选择当前打开的直播页面。 「监听元素类型」选择 div（假设弹幕以 div 标签渲染）。 点击「捕获新元素」，在网页中框选弹幕显示区域，自动填充「元素」参数。 「监听 ID」填写变量名 直播弹幕监听ID。
- 高级配置 在「弹幕 JS 筛选函数」中输入：ele=>{ return ele.getAttribute('data-danm') }，后续通过 「获取一条弹幕」 能获取返回的内容
- 执行效果指令会持续监听目标区域，新弹幕出现时，会通过自定义 JS 函数提取用户名、内容和时间
- 执行成功后，会将监听ID写入到直播弹幕监听ID 变量中，供后续流程（获取一条弹幕、结束弹幕监听）使用。
4. 注意事项
- 确保目标网页的弹幕 DOM 结构稳定，若网页更新元素属性，需重新捕获元素并调整 JS 筛选函数。
- 长时间监听会占用内存，建议在流程结束后添加「结束弹幕监听」指令释放资源。
- 部分网页通过动态渲染生成弹幕，需配合「等待元素加载」指令，确保监听逻辑在弹幕元素加载后生效。
- JS 筛选函数需遵循浏览器端 JS 语法，避免使用 Node.js 专属 API。