接口规范11.串流相关接口-创新互联

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
  }

创新互联www.cdcxhl.cn，专业提供香港、美国云服务器，动态BGP最优骨干路由自动选择，持续稳定高效的网络助力业务部署。公司持有工信部办法的idc、isp许可证， 机房独有T级流量清洗系统配攻击溯源，准确进行流量调度，确保服务器高可用性。佳节活动现已开启，新人活动云服务器买多久送多久。