文档中心
解决方案后台文档
秀场直播后台
进入房间

进入房间

更新时间：2023-11-02 17:35

1 描述

进入多人连麦直播房间。

2 接口原型

请求方法：POST
请求地址：/live_show/login_room
传输协议：application/json

3 请求参数

参数	类型	是否必选	示例	描述
room_id	String	是	"12345"	房间 ID。
nick_name	String	是	"user"	用户昵称。
uid	Int64	否	171171717	唯一用户 ID，不传的情况下服务端会自动为该用户生成一个临时唯一 ID。
avatar	String	是	"avatar"	用户头像图片。需使用客户端能识别的标识，例如短链接、自定义 ID等。请勿使用过长的字符串。

4 请求示例

{
    "uid": 9999,
    "room_id": "46466",
    "nick_name":"user",
    "avatar":"avatar"
}

5 响应参数

参数	类型	示例	描述
room_info	Struct	-	房间信息
room_id	String	"2001113279"	房间 ID。
subject	String	"开黑"	房间名称。
create_time	Int64	1608186550647	房间创建时间戳，单位：毫秒。
cover_img	String	"img"	房间封面图片。
host_id	Int64	12	主播用户 ID。
user_info	Struct	-	用户信息
uid	Int64	12	用户唯一 ID。
avatar	String	"avatar"	用户头像图片。
nick_name	String	"user"	用户昵称。
role	Int64	1	用户角色，取值如下： 1：普通成员 3：主播
login_timestamp	Int64	1608186550647	用户登录时间戳，单位：毫秒。
onstage_timestamp	Int64	1608186550647	开始连麦时间戳，单位：毫秒。该字段为非必有字段。
mic	Int64	1	麦克状态，取值如下： 1：关闭 2：开启
camera	Int64	1	摄像头状态，取值如下： 1：关闭 2：开启
onstage_state	Int64	1	连麦状态，取值如下： 1：未连麦 2：连麦 3：受邀请连麦

6 响应示例

{
    "ret": {
        "code": 0,
        "message": "",
    },
    "data": {
        "room_info": {
            "room_id": "12",
            "subject": "sub",
            "cover_img": "cover",
            "host_id": 12,
            "create_time": 1625106706383
        },
        "user_info": {
            "uid": 12,
            "avatar": "avatar",
            "nick_name": "test",
            "role": 3,
            "login_timestamp": 1625106706384,
            "mic": 1,
            "camera": 1,
            "onstage_state": 1 
        }
    }
}