258 lines
8.5 KiB
Markdown
258 lines
8.5 KiB
Markdown
|
<!-- package=live.xroom.v1 -->
|
|||
|
|
- [/live.xroom.v1.Room/getMultiple](#live.xroom.v1.RoomgetMultiple) 批量根据room_ids获取房间信息
|
|||
|
|
- [/live.xroom.v1.Room/getMultipleByUids](#live.xroom.v1.RoomgetMultipleByUids) 批量根据uids获取房间信息
|
|||
|
|
- [/live.xroom.v1.Room/isAnchor](#live.xroom.v1.RoomisAnchor) 批量根据uids判断是否是主播，如果是返回主播的room_id，否则返回0
|
|||
|
|
|
|||
|
|
## /live.xroom.v1.Room/getMultiple
|
|||
|
|
### 批量根据room_ids获取房间信息
|
|||
|
|
|
|||
|
|
#### 方法：GET
|
|||
|
|
|
|||
|
|
#### 请求参数
|
|||
|
|
|
|||
|
|
|参数名|必选|类型|描述|
|
|||
|
|
|:---|:---|:---|:---|
|
|||
|
|
|room_ids|是|多个integer| room_ids数组，长号|
|
|||
|
|
|attrs|是|多个string| 要获取的房间信息维度 status:状态相关 show:展示相关 area:分区相关 anchor:主播相关|
|
|||
|
|
|
|||
|
|
#### 响应
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"message": "ok",
|
|||
|
|
"data": {
|
|||
|
|
// 主播room_id => 房间维度信息
|
|||
|
|
"list": {
|
|||
|
|
"1": {
|
|||
|
|
// room_id 房间长号
|
|||
|
|
"room_id": 0,
|
|||
|
|
// uid 主播uid
|
|||
|
|
"uid": 0,
|
|||
|
|
// Model1：房间信息（状态相关）
|
|||
|
|
"status": {
|
|||
|
|
// 直播间状态 0未开播，1直播中；2轮播中；
|
|||
|
|
"live_status": 0,
|
|||
|
|
// 横竖屏方向 0横屏，1竖屏
|
|||
|
|
"live_screen_type": 0,
|
|||
|
|
// 是否开播过标识
|
|||
|
|
"live_mark": 0,
|
|||
|
|
// 封禁状态：0未封禁；1审核封禁; 2全网封禁
|
|||
|
|
"lock_status": 0,
|
|||
|
|
// 封禁时间戳
|
|||
|
|
"lock_time": 0,
|
|||
|
|
// 隐藏状态 0不隐藏，1隐藏
|
|||
|
|
"hidden_status": 0,
|
|||
|
|
// 隐藏时间戳
|
|||
|
|
"hidden_time": 0,
|
|||
|
|
// 直播类型 0默认 1摄像头直播 2录屏直播 3语音直播
|
|||
|
|
"live_type": 0
|
|||
|
|
},
|
|||
|
|
// Model2：房间信息（展示相关）
|
|||
|
|
"show": {
|
|||
|
|
// short_id 短号
|
|||
|
|
"short_id": 0,
|
|||
|
|
// 直播间标题
|
|||
|
|
"title": "",
|
|||
|
|
// 直播间封面
|
|||
|
|
"cover": "",
|
|||
|
|
// 直播间标签
|
|||
|
|
"tags": "",
|
|||
|
|
// 直播间背景图
|
|||
|
|
"background": "",
|
|||
|
|
// 直播间简介
|
|||
|
|
"description": "",
|
|||
|
|
// 关键帧
|
|||
|
|
"keyframe": "",
|
|||
|
|
// 人气值
|
|||
|
|
"popularity_count": 0,
|
|||
|
|
// 房间tag（角标）
|
|||
|
|
"tag_list": [
|
|||
|
|
{
|
|||
|
|
"tag_id": 0,
|
|||
|
|
"tag_sub_id": 0,
|
|||
|
|
"tag_value": 0,
|
|||
|
|
"tag_ext": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
// 最近一次开播时间戳
|
|||
|
|
"live_start_time": 0
|
|||
|
|
},
|
|||
|
|
// Model3：房间信息（分区相关）
|
|||
|
|
"area": {
|
|||
|
|
// 直播间分区id
|
|||
|
|
"area_id": 0,
|
|||
|
|
// 直播间分区名称
|
|||
|
|
"area_name": "",
|
|||
|
|
// 直播间父分区id
|
|||
|
|
"parent_area_id": 0,
|
|||
|
|
// 直播间父分区名称
|
|||
|
|
"parent_area_name": ""
|
|||
|
|
},
|
|||
|
|
// Model4：房间信息（主播相关）
|
|||
|
|
"anchor": {
|
|||
|
|
// 主播类型
|
|||
|
|
"anchor_profile_type": 0,
|
|||
|
|
// 主播等级
|
|||
|
|
"anchor_level": {
|
|||
|
|
// 等级
|
|||
|
|
"level": 0,
|
|||
|
|
// 当前等级颜色
|
|||
|
|
"color": 0,
|
|||
|
|
// 当前积分
|
|||
|
|
"score": 0,
|
|||
|
|
// 当前等级最小积分
|
|||
|
|
"left": 0,
|
|||
|
|
// 下一等级起始积分
|
|||
|
|
"right": 0,
|
|||
|
|
// 下一个经验值
|
|||
|
|
"max_level": 0
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## /live.xroom.v1.Room/getMultipleByUids
|
|||
|
|
### 批量根据uids获取房间信息
|
|||
|
|
|
|||
|
|
#### 方法：GET
|
|||
|
|
|
|||
|
|
#### 请求参数
|
|||
|
|
|
|||
|
|
|参数名|必选|类型|描述|
|
|||
|
|
|:---|:---|:---|:---|
|
|||
|
|
|uids|是|多个integer| 主播uids|
|
|||
|
|
|attrs|是|多个string| 要获取的房间信息维度 status:状态相关 show:展示相关 area:分区相关 anchor:主播相关|
|
|||
|
|
|
|||
|
|
#### 响应
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"message": "ok",
|
|||
|
|
"data": {
|
|||
|
|
// 主播UID => 房间维度信息
|
|||
|
|
"list": {
|
|||
|
|
"1": {
|
|||
|
|
// room_id 房间长号
|
|||
|
|
"room_id": 0,
|
|||
|
|
// uid 主播uid
|
|||
|
|
"uid": 0,
|
|||
|
|
// Model1：房间信息（状态相关）
|
|||
|
|
"status": {
|
|||
|
|
// 直播间状态 0未开播，1直播中；2轮播中；
|
|||
|
|
"live_status": 0,
|
|||
|
|
// 横竖屏方向 0横屏，1竖屏
|
|||
|
|
"live_screen_type": 0,
|
|||
|
|
// 是否开播过标识
|
|||
|
|
"live_mark": 0,
|
|||
|
|
// 封禁状态：0未封禁；1审核封禁; 2全网封禁
|
|||
|
|
"lock_status": 0,
|
|||
|
|
// 封禁时间戳
|
|||
|
|
"lock_time": 0,
|
|||
|
|
// 隐藏状态 0不隐藏，1隐藏
|
|||
|
|
"hidden_status": 0,
|
|||
|
|
// 隐藏时间戳
|
|||
|
|
"hidden_time": 0,
|
|||
|
|
// 直播类型 0默认 1摄像头直播 2录屏直播 3语音直播
|
|||
|
|
"live_type": 0
|
|||
|
|
},
|
|||
|
|
// Model2：房间信息（展示相关）
|
|||
|
|
"show": {
|
|||
|
|
// short_id 短号
|
|||
|
|
"short_id": 0,
|
|||
|
|
// 直播间标题
|
|||
|
|
"title": "",
|
|||
|
|
// 直播间封面
|
|||
|
|
"cover": "",
|
|||
|
|
// 直播间标签
|
|||
|
|
"tags": "",
|
|||
|
|
// 直播间背景图
|
|||
|
|
"background": "",
|
|||
|
|
// 直播间简介
|
|||
|
|
"description": "",
|
|||
|
|
// 关键帧
|
|||
|
|
"keyframe": "",
|
|||
|
|
// 人气值
|
|||
|
|
"popularity_count": 0,
|
|||
|
|
// 房间tag（角标）
|
|||
|
|
"tag_list": [
|
|||
|
|
{
|
|||
|
|
"tag_id": 0,
|
|||
|
|
"tag_sub_id": 0,
|
|||
|
|
"tag_value": 0,
|
|||
|
|
"tag_ext": ""
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
// 最近一次开播时间戳
|
|||
|
|
"live_start_time": 0
|
|||
|
|
},
|
|||
|
|
// Model3：房间信息（分区相关）
|
|||
|
|
"area": {
|
|||
|
|
// 直播间分区id
|
|||
|
|
"area_id": 0,
|
|||
|
|
// 直播间分区名称
|
|||
|
|
"area_name": "",
|
|||
|
|
// 直播间父分区id
|
|||
|
|
"parent_area_id": 0,
|
|||
|
|
// 直播间父分区名称
|
|||
|
|
"parent_area_name": ""
|
|||
|
|
},
|
|||
|
|
// Model4：房间信息（主播相关）
|
|||
|
|
"anchor": {
|
|||
|
|
// 主播类型
|
|||
|
|
"anchor_profile_type": 0,
|
|||
|
|
// 主播等级
|
|||
|
|
"anchor_level": {
|
|||
|
|
// 等级
|
|||
|
|
"level": 0,
|
|||
|
|
// 当前等级颜色
|
|||
|
|
"color": 0,
|
|||
|
|
// 当前积分
|
|||
|
|
"score": 0,
|
|||
|
|
// 当前等级最小积分
|
|||
|
|
"left": 0,
|
|||
|
|
// 下一等级起始积分
|
|||
|
|
"right": 0,
|
|||
|
|
// 下一个经验值
|
|||
|
|
"max_level": 0
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## /live.xroom.v1.Room/isAnchor
|
|||
|
|
### 批量根据uids判断是否是主播，如果是返回主播的room_id，否则返回0
|
|||
|
|
|
|||
|
|
#### 方法：GET
|
|||
|
|
|
|||
|
|
#### 请求参数
|
|||
|
|
|
|||
|
|
|参数名|必选|类型|描述|
|
|||
|
|
|:---|:---|:---|:---|
|
|||
|
|
|uids|是|多个integer| 主播uids|
|
|||
|
|
|
|||
|
|
#### 响应
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"message": "ok",
|
|||
|
|
"data": {
|
|||
|
|
// uid => room_id(长号)，room_id=0表示没有创建房间
|
|||
|
|
"list": {
|
|||
|
|
"1": 0
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|