接口规范 11. 串流相关接口

简介: 11 串流相关接口11.1.查询串流任务用途查询服务器上的串流任务。请求streamingMgr/?request=get_streaming&id=id 串流任务在服务器上的唯一编号,省略时会返回所有任务的列表。

11 串流相关接口

11.1.查询串流任务

  • 用途
    查询服务器上的串流任务。

  • 请求
    streamingMgr/?request=get_streaming&id=
    id 串流任务在服务器上的唯一编号,省略时会返回所有任务的列表。

  • 响应
    {
    "code":0,
    "data":{
        "count":2,
        "items":[
                    {
                "name":"监控视频",
                "id":"BAF9B8E5BA819259",
                "protocol":"rtsp",
                "source_url":"rtsp://192.168.2.246:8555/H264SubStream",
                "video_only":"on",
                "use_transcode":"on",
                "video_size":"1280x720",
                "width":"1280",
                "height":"720",
                "bitrate":"500",
                "use_audio_transcode":"on",
                "bitrate_audio":"56",
                "to_host":"localhost",
                "application":"show",
                "stream":"cameral1",
                "status":0
            },
            {
                "name":"本地文件串流",
                "id":"D16E78096B55C850",
                "protocol":"file",
                "source_url":"file:///var/media/jgdy.mp4",
                "to_host":"localhost",
                "application":"liveshow",
                "stream":"jgdy",
                "status":0
            }
        ]
    }
    }

    items元素包含0个或多个串流任务。
    name 串流的名称,在添加任务时输入
    id 串流的唯一编号,在添加任务时系统自动分配,后续管理串流任务需要该id
    protocol 输入协议
    source_url 视频源地址
    video_only 输入源是否只有视频,on表示只有视频
    audio_only 输入源是否只有音频,on表示只有音频
    use_transcode 是否启动视频转码,on表示启动,off或者省略表示没有转码
    width 转码的输出视频画面宽度,0表示保持输入源画幅大小
    height 转码的输出视频画面高度,0表示保持输入源画幅大小
    bitrate 视频转码的比特率,单位 kbps
    use_audio_transcode 是否启动音频转码,on表示启动,off或者省略表示没有转码
    bitrate_audio 音频转码比特率 单位 kbps
    to_host 串流的目标服务器IP或域名,localhost 表示串流到本机
    application 串流的目标应用名
    stream 串流的目标直播流名称
    status 串流任务状态 0没有运行 1正在运行 其他表示异常

11.2.添加串流任务

  • 用途
    添加一个串流任务。
    添加串流任务时,要调用接口的客户端提供一个唯一的任务id,该id可由字母和数字组成,用于在调用后续接口时识别该任务。
    如果提供的id和已经存在任务的id相同,则服务器会将该请求当作修改串流任务处理。

  • 请求
    streamingMgr/?request=add_streaming&name=监控视频&id=BAF9B8E5BA819259&protocol=rtsp&source_url=rtsp%3a%2f%2f192.168.2.246%3a8555%2fH264SubStream&video_only=on&use_transcode=on&video_size=1280x720&width=1280&height=720&bitrate=500&use_audio_transcode=on&bitrate_audio=56&to_host=localhost&application=show&stream=cameral1
    参数:
    id 任务唯一编号,应由字母或数字组成,长度建议在6个字符以上,要避免重复
    protocol 串流输入源的协议,支持rtsp、rtmp、udp、http、mms等协议
    source_url 串流输入的源地址,该参数需要进行【url编码】
    video_only 是否只有视频,on 表示只有视频,在只有视频时,所有音频相关参数会被忽略
    use_transcode 是否进行视频转码,on表示进行转码,off或者省略表示不转码。如果不进行视频转码,所有视频转码参数会被忽略
    width 视频转码输出的画面宽度,单位像素
    height 视频转码输出的画面高度,单位像素
    bitrate 视频转码输出的比特率,单位kpbs
    use_audio_transcode 是否进行音频转码,on表示进行转码,off或者省略表示不转码。如果不进行音频转码,所有音频转码参数会被忽略。
    bitrate_audio 音频转码比特率,单位kbps
    to_host 串流输出的目标服务器IP或域名,localhost表示向本机串流。
    application 串流输出的应用名,定义向服务器的哪个应用输出直播流
    stream 串流输出的直播流名称

  • 响应
    {
    "code":0
    }

11.3.启动串流任务

  • 用途
    启动一个串流任务。
    添加完串流任务后,可以调用该接口运行任务。

  • 请求
    streamingMgr/?request=start_streaming&id=BAF9B8E5BA819259
    id 串流任务的唯一编号,可以通过查询串流任务接口获得。

  • 响应
    {
    "code":0
    }

11.4.停止串流任务

  • 用途
    停止一个串流任务。

  • 请求
    streamingMgr/?request=stop_streaming&id=8A9B587159245ED5
    id 串流任务的唯一编号,可以通过查询串流任务接口获得。

  • 响应
    {
    "code":0
    }

11.5.删除串流任务

  • 用途
    删除一个串流任务。

  • 请求
    streamingMgr/?request=remove_streaming&id=8A9B587159245ED5
    id 串流任务的唯一编号,可以通过查询串流任务接口获得。

  • 响应
    {
    "code":0
    }
相关文章
|
2月前
|
网络协议 Java 数据格式
接口的使用
接口的使用
84 0
|
安全 API 开发者
PSCI接口规范(下)
PSCI接口规范(下)
|
监控 安全 Linux
|
Java Maven
一文了解ConfigurationConditon 接口
在了解ConfigurationCondition 接口之前,先通过一个示例来了解一下@Conditional 和 Condition。
64 0
|
C# 索引
C#-接口
接口是一种用来定义程序的协议,它描述可属于任何类或结构的一组相关行为。接口可有方法、属性、事件和索引器或这四种成员的任何组合类型,但不能包含字段。接口只包含了成员的声明,在继承的类中进行实现。
112 0
|
JavaScript 前端开发 容器
56、GlobalEventHandlers 接口
某个对象的abort事件(停止加载)发生时,就会调用onabort属性指定的回调函数。 各种元素的停止加载事件,到底如何触发,目前并没有统一的规定。因此实际上,这个属性现在一般只用在<img>元素上面。
148 0
|
JSON 数据格式 安全
接口规范 1. 概述
1.概述 1.1.用途 远程管理API提供一组接口,其他系统(如企业的业务管理系统、媒资管理系统、用户管理系统等)可以通过调用接口来查询流媒体服务器的数据和更改流媒体服务器的配置,实现与流媒体服务器的集成。
1773 0
|
编解码 索引
接口规范 13. 文件上传及管理相关接口
13 文件上传及管理相关接口 这组接口实现视频资源的上传及管理,为视频转码和发布提供支持。上传的服务器上的视频文件,经过转码发布后形成可以对外播出的在线视频资源。本小节描述文件上传和管理的接口,转码接口在下一章节说明。
2001 0