Skip to content

直播间详情

请求路径

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://gateway.nuoyunapi.com/Api/Room/roomInfo/2.0.0
  • 频率限制:10秒100次

请求参数

参数必选类型描述
room_idnumber直播间id

请求示例

{
    "room_id": 103891
}

响应参数

参数必选类型描述
codestring状态码:200-成功,400-失败
msgstring提示信息
dataobject消息内容

data 参数结构

参数必选类型描述
room_idnumber直播间id
live_statusstring直播状态:预告、未直播、直播中、已结束、回放
live_statestring直播状态:not_lived--未直播,living--直播中,up_coming--预告,not_start--未开始,playback--回放,ended--已结束
live_urlobject直播流地址/回放流地址
is_liveboolean是否在推流
uidnumber账户uid
push_app_nickstring直播间名称
app_coverstringweb端直播间封面图
app_cover_mobilestring手机端直播间封面图
descstring微信分享描述文字
descriptionstring直播间简介
start_timenumber直播开始时间
end_timenumber直播结束时间
visit_numberstring浏览量,即观看人次pv
uvnumber观看人数UV
room_urlstring直播间观看地址
room_webview_urlstring直播间H5观看链接(小程序webview场景)
live_typenumber直播间类型:0-视频直播,4-图片直播,5-互动直播,6-全景直播
screen_typenumber横竖屏:1-横屏,2-竖屏
live_in_timenumber直播时长
avg_live_timestring平均观看时长
g_idnumber直播间分类id
g_namestring直播间分类名

live_url 参数结构

参数必选类型描述
webrtc_urlstringwebrtc拉流地址
rtmp_urlstringrtmp拉流地址
hls_urlstringm3u8拉流地址
flv_urlstringflv拉流地址
typestring类型
titlestring标题
vod_urlstring回放地址

响应示例

未开始

json
{
  "code": 200,
  "data": {
    "room_id": 644868499,
    "live_status": "未开始",
    "live_state": "not_start",
    "live_url": {
      "webrtc_url": "",
      "rtmp_url": "",
      "hls_url": "",
      "flv_url": "",
      "type": "",
      "title": "",
      "vod_url": "",
    },
    "is_live": false,
    "uid": 2035,
    "push_app_nick": "1111",
    "app_cover": "https://console.nuoyun.tv/Public/Home/Images/cover_1.jpg",
    "app_cover_mobile": "https://console.nuoyun.tv/Public/Home/Images/cover-mobile.jpg",
    "desc": "",
    "description": "",
    "start_time": 1755045000,
    "end_time": 1755061200,
    "visit_number": "0",
    "uv": 0,
    "room_url": "https://zbiagz2f4lctm.wx.inuoyun.com/Watch/644868499",
    "room_webview_url": "https://wx1ddde5f70895e7dd.wx.inuoyun.com/Watch/644868499",
    "live_type": 0,
    "screen_type": 1,
    "live_in_time": 0,
    "avg_live_time": "0.00",
    "g_id": 0,
    "g_name": "无分类"
  },
  "msg": "Success"
}

直播中

json
{
  "code": 200,
  "data": {
    "room_id": 1805938378,
    "live_status": "直播中",
    "live_state": "living",
    "live_url": {
      "webrtc_url": "",
      "rtmp_url": "rtmp://wsu-play.nuoyun.tv/wx/iz43sogi_xhd?keeptime=259200&wsSecret=a25b2e8339a9a82e1c50562027a89c8c&wsTime=1754965698",
      "hls_url": "https://wsu-play.nuoyun.tv/wx/iz43sogi_xhd.m3u8?keeptime=259200&wsSecret=917161140a2577aa30496fcf8cd83831&wsTime=1754965698",
      "flv_url": "https://wsu-play.nuoyun.tv/wx/iz43sogi_xhd.flv?keeptime=259200&wsSecret=20644fca3fd846005703c828cee6b0da&wsTime=1754965698",
      "type": "",
      "title": "",
      "vod_url": ""
    },
    "is_live": true,
    "uid": 2035,
    "push_app_nick": "123",
    "app_cover": "https://console.nuoyun.tv/Public/Home/Images/cover_1.jpg",
    "app_cover_mobile": "https://console.nuoyun.tv/Public/Home/Images/cover-mobile.jpg",
    "desc": "",
    "description": "",
    "start_time": 1755045000,
    "end_time": 1755061200,
    "visit_number": "0",
    "uv": 0,
    "room_url": "https://zbiagz2f4lctm.wx.inuoyun.com/Watch/1805938378",
    "room_webview_url": "https://wx1ddde5f70895e7dd.wx.inuoyun.com/Watch/1805938378",
    "live_type": 0,
    "screen_type": 1,
    "live_in_time": 0,
    "avg_live_time": "0.00",
    "g_id": 0,
    "g_name": "无分类"
  },
  "msg": "Success"
}

直播间不存在

json
{
    "code": 400,
    "msg": "您无权限访问此直播间或直播间不存在",
    "data": []
}