直播 Feed 接口文档
服务：lobby (:27711) |
nginx 前缀：/lobby/ |
示例：http://121.40.55.207/lobby/live_stream/feed
本组接口用于直播间滑动 Feed 和关播页推荐，当前实现依赖直播热度列表 cm-hot-livestream 与房间缓存状态。
公共说明
所有接口均为 POST，默认使用 protobuf 二进制请求/响应。调试时可使用 JSON 格式（开启 debug 模式）。
公共请求头 OyeBaseReq
| 字段 | 类型 | 必填 | 说明 |
|---|
key | string | 是 | 客户端与服务端约定的 key |
timestamp | int64 | 是 | 当前时间戳（秒） |
nonce | int64 | 是 | 随机数 |
token | string | 是 | 登录后拿到的用户 token |
language | string | 否 | 语言标识 |
公共响应头 OyeBaseRsp
| 字段 | 类型 | 说明 |
|---|
err_code | int32 | 0 = 成功，其余为错误码 |
err_msg | string | 错误描述 |
1. 直播间滑动流
POST/lobby/live_stream/feed
获取直播间 Feed，支持基于 current_id 和 exclude_ids 的去重与续滑。
当前实现会过滤：非在播、隐藏房间、已看过房间、黑名单关系。首次进入直播间且 exclude_ids 为空时，会兼容性返回当前房间，避免首屏缺失。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|
base | OyeBaseReq | 是 | 公共请求头 |
current_id | int64 | 否 | 当前直播间 id，首次可为 0 |
exclude_ids | repeated int64 | 否 | 已看过的房间 id 列表 |
page_size | int32 | 否 | 每次请求数量，默认 10 |
响应字段
| 字段 | 类型 | 说明 |
|---|
base | OyeBaseRsp | 公共响应头 |
list | repeated LiveStreamItem | 直播间列表 |
has_more | bool | 是否还有更多 |
LiveStreamItem 字段
| 字段 | 类型 | 说明 |
|---|
uid | int64 | 主播 uid |
nick | string | 主播昵称 |
head | string | 主播头像 |
room_id | int64 | 直播房间 id |
title | string | 直播间标题 |
cover | string | 直播间封面 |
viewers | int32 | 当前观看人数 |
hot_rank | int64 | 热度值（展示用） |
anchor_lv | int32 | 主播等级 |
intro | string | 房间简介 |
2. 关播页推荐 Top3
POST/lobby/live_stream/recommend_top3
返回最多 3 个推荐直播间，用于关播页推荐。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|
base | OyeBaseReq | 是 | 公共请求头 |
响应字段
| 字段 | 类型 | 说明 |
|---|
base | OyeBaseRsp | 公共响应头 |
list | repeated LiveStreamRecommendItem | 推荐直播间列表 |
LiveStreamRecommendItem 字段
| 字段 | 类型 | 说明 |
|---|
room_id | int64 | 直播房间 id |
cover | string | 封面 |
name | string | 当前直播间标题 |
viewers | int32 | 当前观看人数 |
当前实现会过滤：非在播、隐藏房间、加密房间、黑名单关系，返回数量最多 3 个。
错误码参考
| 错误码 | 说明 |
|---|
0 | 成功 |
InvalidToken | token 无效 |