播放地址接口

本节包含播放地址相关接口等。使用逻辑为:开通直播工单—获取直播地址—不使用时关闭直播功能。未开通直播功能的设备无法获取直播地址。

接口列表如下:

序号 接口功能 描述
1 获取播放地址 批量获取设备的直播地址信息

获取播放地址

  • 接口功能:

    该接口用于通过设备序列号、通道号获取单台设备的播放地址信息,无法获取永久有效期播放地址。

  • 请求地址

    https://open.ys7.com/api/lapp/v2/live/address/get

  • 请求方式

    POST

  • 请求参数

参数名 类型 描述 是否必选
accessToken String 授权过程获取的access_token Y
deviceSerial String 直播源,例如427734222,均采用英文符号,限制50个 Y
channelNo Integer 通道号,,非必选,默认为1 N
code String ezopen协议地址的设备的视频加密密码 N
expireTime Integer 过期时长,单位秒;针对hls/rtmp设置有效期,相对时间;30秒-720天 N
protocol Integer 流播放协议,1-ezopen、2-hls、3-rtmp、4-flv,默认为1 N
quality Integer 视频清晰度,1-高清(主码流)、2-流畅(子码流) N
startTime String ezopen协议地址的本地录像/云存储录像回放开始时间,示例:2019-12-01 00:00:00 N
stopTime String ezopen协议地址的本地录像/云存储录像回放开始时间,示例:2019-12-01 00:00:00 N
type String ezopen协议地址的类型,1-预览,2-本地录像回放,3-云存储录像回放,非必选,默认为1 N
supportH265 Integer 是否要求播放视频为H265编码格式 N
gbchannel String 国标设备的通道编号 N
  • HTTP请求报文
POST /api/lapp/live/address/get HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.dunwhxt2azk02hcn7phqygsybbw0wv6p&deviceSerial=C78957921&channelNo=1
  • 返回数据
{
    "msg": "Operation succeeded",
    "code": "200",
    "data": {
        "id": "254708522214232064",
        "url": "https://open.ys7.com/v3/openlive/C78957921_1_1.m3u8?expire=1606999273&id=254708522214232064&t=093e5c6668d981e0f0b8d2593d69bdc98060407d1b2f42eaaa17a62b15ee4f99&ev=100",
        "expireTime": "2020-12-03 20:41:13"
    }
}
  • 返回字段:
字段名 类型 描述
code String 状态码,参考下方返回码。优先判断该错误码,返回200即表示成功
msg String 状态描述
id String 状态描述
url String 直播地址
expireTime long 直播地址有效期。expireTime参数为空时该字段无效

注意:该接口请求时先解析code属性,如果返回200即表示成功,可继续解析data属性的内容,每一个地址对象中先解析ret属性,如果返回200表示成功,再根据status属性和exception属性判断是否存在异常。

  • 返回码
返回码 返回消息 备注
200 操作成功,获取指定有效期的直播地址 请求成功
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
403 用户不存在

results matching ""

    No results matching ""