4.0 KiB
4.0 KiB
机器人房间产品文档
背景
语音房冷启动阶段，房间列表和新房首屏容易显得冷清。机器人房间用于在内部可控范围内营造房间活跃氛围：机器人账号创建房间、进入房间、静音上麦，并在房间内相互送礼，触发客户端已有的礼物动效和幸运礼物展示。
机器人房间不面向真人主播发放收益，不参与真实抽奖、真实奖池、榜单和结算。
产品目标
- 后台可创建和控制机器人房间。
- 每个机器人房间自动拉取一批未被占用的机器人账号进房。
- 机器人可静音上麦，让房间麦位呈现活跃状态。
- 机器人之间自动送普通礼物和幸运礼物。
- 幸运礼物展示复用客户端现有飘屏/房间展示协议，但不影响真实幸运礼物奖池和流水。
- 机器人房间积分和麦位热度正常增长，用于房间内氛围展示。
- 机器人礼物不产生真人收益，不污染充值、消费、结算和排行榜数据。
使用入口
后台管理系统路径：
房间管理 / 机器人房间
权限：
room-robot:view：查看机器人房间。room-robot:create：创建机器人房间。room-robot:update：启动/停止机器人房间。
创建机器人房间
点击 增加机器人房间 后配置：
- 房间名称：机器人房间对外展示名称。
- 房主机器人：从未被机器人房间占用的房间机器人账号中选择。
- 候选机器人：从未被机器人房间占用的机器人账号中选择，默认可选择全部可用机器人。
- 进房人数范围：例如
6-10，系统会从候选机器人中随机抽取一个人数。 - 礼物合集：普通礼物池，机器人普通送礼时随机选择。
- 幸运礼物合集：幸运礼物展示池，机器人幸运送礼时随机选择。
- 普通礼物频次：每个机器人每隔固定毫秒数送一次普通礼物。
- 幸运礼物连击范围：每轮幸运礼物随机生成连击次数。
- 幸运礼物间隔范围：一轮幸运礼物结束后，随机等待一段时间再开始下一轮。
送礼规则
普通礼物
- 每个机器人独立执行。
- 到达配置间隔后，从普通礼物合集中随机选择 1 个礼物。
- 随机选择同房间另一个机器人作为收礼人。
- 每次只送 1 个目标机器人。
幸运礼物
- 每个机器人独立执行。
- 从幸运礼物合集中随机选择 1 个礼物。
- 当前机器人向同房间所有其他机器人送礼。
- 按配置范围随机生成连击次数，例如
100-10000。 - 连击完成后，按配置间隔范围随机等待，例如
5-20 秒，再开始下一轮。
状态管理
机器人房间支持：
- 运行中：机器人送礼循环运行。
- 已停止：机器人送礼循环停止，配置和房间占用保留。
后台列表中可使用状态开关快速启动或停止。
数据隔离
机器人房间遵循以下隔离规则：
- 机器人只给同房间机器人送礼。
- 服务端禁止机器人给真人送礼。
- 机器人礼物使用机器人专用金币
ROBOT_COIN。 - 不消耗真人金币
COIN。 - 不产生主播钻石和工资周期钻石。
- 不写真实礼物墙。
- 不参与真实幸运礼物奖池、抽奖、返奖和统计。
- 不参与房间排行榜、活动排行榜和结算。
运营建议
- 单房机器人数量建议从
6-10开始。 - 普通礼物频次建议不要过低，避免房间消息过密。
- 幸运礼物连击范围建议根据活动氛围配置，测试环境可用较小范围验证。
- 礼物合集应选择低价或专门用于展示的礼物，避免用户误解真实返奖。
- 机器人房间应优先用于冷启动、活动预热和列表氛围补足。
风险与限制
- 机器人房间不应和真人主播收益挂钩。
- 不建议使用真人主播账号作为机器人账号。
- 如果候选机器人不足，创建会失败。
- 同一个机器人不能同时被多个 active 机器人房间占用。
- 停止房间只停止送礼循环，不删除房间配置。