查询房间直播流名称

更新时间: 2025/04/02 14:01:07

查询房间的直播流名称(streamName)。

使用场景:直播、点播结束后,如果您需要查询对应的直播、点播用量数据,您可以通过该方法查询直播流名称,再通过数据统计查询数据信息。

注意事项

直播流没开始情况下,直播流名也不存在,创建房间不会初始化直播流,这时无法查询流名,只有当第一个成员进入房间后,会进行初始化操作,这时可以查询流名。

接口请求地址

  • 请求方法:GET
  • URL:https://roomkit.yunxinapi.com/neroom/v3/rooms/:room_archive_id/live_stream_name

URL 中参数说明

请求 Header 的设置请参见 请求结构

参数名称 类型 是否必选 示例 描述
room_archive_id String 4***251 创建房间时,NERoom 服务端自动生成的一个用于标识房间的 ID,全局唯一,最大长度36个字符。
获取方法请参见创建房间 中的返回参数。

返回参数

参数名称 类型 示例 描述
code int 0 状态码,0表示成功,具体请参见错误码
msg String Success 业务结果描述,Success表示成功。
ts Long 1648021056815 NERoom 服务器处理该请求的完成时间。该时间为 Unix 时间戳,即从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。
request_id String 7c4b6d9c3e9d42*****cc6e3a4d995 请求的唯一标识。
cost String 48ms 处理该请求所消耗的时间。
- data JsonObject - 房间的直播流名称。
stream_name String 13412341324_1664258351668 直播流名称。

示例

请求示例

javahttps://roomkit.yunxinapi.com/neroom/v3/rooms/123/live_stream_name

返回示例

java{
    "code":0,
    "msg":"Success",
    "ts":1619068087795,
    "request_id":"6e507107d1f4447ea731f651dc6d2432",
    "cost":"66ms",
    "data":{
        "stream_name":"13412341324_1664258351668"
    }
}
此文档是否对你有帮助?
有帮助
去反馈
  • 注意事项
  • 接口请求地址
  • URL 中参数说明
  • 返回参数
  • 示例
  • 请求示例
  • 返回示例