文档首页 > > API参考> API> 视频流管理> 获取视频流地址

获取视频流地址

分享
更新时间: 2019/09/03 16:30

功能介绍

此接口用于获取指定视频流的地址。该地址用于进行视频流推流或者拉流。

  • 实时视频流,可以通过该接口返回的pull_flow_address参数值获取视频流地址。
  • 如果是编码格式是H265,可以通过该接口返回的hls_pull_flow_address参数值获取H265格式视频流地址。
  • 对于RTMP类型的视频流,该接口可以获取到推流地址(对应push_flow_address参数值),通过该地址,可以将视频流推到VIS中。
说明:
  • 当因网络或其它原因,导致视频流中断后自动恢复时,推流地址或拉流地址可能发生变化。请重新调用该接口,并尝试使用新的推流地址再次进行推流。
  • 在灾备场景下,拉流地址可能会发生变化,导致已获取的相应地址无效,请重新调用该接口获取新的地址。

URI

  • URI格式
    GET /v1/{project_id}/streams/{stream_name}/endpoint
  • 参数说明

    参数

    是否必选

    类型

    说明

    project_id

    String

    项目ID,获取方法请参见获取项目ID

    stream_name

    String

    视频流名称。

请求

请求样例

GET /v1/3266392d188c47d09948b1859f0a5e07/streams/estRTMP1013/endpoint

响应

  • 响应样例1(H264编码格式视频流)
    {
        "pull_flow_address": "http://cecb3f14149xxxxxxx437e92f26ca72c.apigw.com/live/work001?app=vis&stream=estRTMP1013",
        "push_flow_protocol": "RTMP",
        "push_flow_address": "rtmp://10.104.11.66:64/vis/estRTMP1013"
    }
  • 响应样例2(H265编码格式视频流,当前仅支持GB28181设备的视频流)
    {
        "push_flow_protocol": "GB28181",
        "push_flow_address": "10.154.113.164",
        "hls_pull_flow_address": "https://c5648d9ee6b14xxxxxxxe6fc594e55df.apigw.com/hls/work001/channel_98123990461320078446.m3u8"
    }
  • 参数说明

    参数

    类型

    说明

    pull_flow_address

    String

    拉流地址,视频流编码格式为H264时才会返回该字段。

    如果视频流的共享类型为PRIVATE(非共享),拉流时必须在请求头中添加X-Auth-Token,值为创建视频流的用户的token。

    push_flow_protocol

    String

    只有RTMP类型的流,该字段才有实际参考意义,代表推流协议。

    push_flow_address

    String

    只有RTMP类型的流,该字段才有实际参考意义,代表推流地址。

    hls_pull_flow_address

    String

    HLS(HTTP Live Streaming)拉流地址,视频编码格式为H265(当前仅GB28281设备的视频流支持H265编码格式),才会返回HLS拉流地址。

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。具体返回错误码请参考错误码说明

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源或没有开通服务。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区