HDL 插件

HDL 插件主要功能是提供 HTTP-FLV 协议的访问

HTTP-FLV 协议（HDL：Http Dynamic Live）是一种动态流媒体直播协议，它是在普通的 HTTP 协议上实现了对 FLV 格式视频进行直播的功能。其名字含义主要可以拆分为三个部分：

• HTTP（HyperText Transfer Protocol）：超文本传输协议，是一种用于在万维网上进行信息传输的协议。在 HTTP-FLV 协议中，HTTP 作为基本协议，提供数据传输的基础结构。
• FLV（Flash Video）：一种流媒体视频格式，起初由 Adobe 公司设计，主要用于在线播放短视频或直播。
• HDL：Http Dynamic Live，是 HTTP-FLV 协议别称的缩写，可以理解为“基于 HTTP 的动态直播协议”，强调的是它在原有 HTTP 协议基础上，通过动态技术实现视频直播的功能。

插件地址

https://github.com/Monibuca/plugin-hdl

插件引入

import _ "m7s.live/plugin/hdl/v4"

插件配置

hdl:
  http:
    listenaddr: :8080 # 网关地址，用于访问API
    listenaddrtls: :8443 # 用于HTTPS方式访问API的端口配置
    certfile: ""
    keyfile: ""
    cors: true # 是否自动添加cors头
    username: "" # 用户名和密码，用于API访问时的基本身份认证
    password: ""
    readtimeout: 0 # 读超时时间
    writetimeout: 0 # 写超时时间
    idletimeout: 0 # 空闲超时时间
  publish:
    pubaudio: true # 是否发布音频流
    pubvideo: true # 是否发布视频流
    kickexist: false # 剔出已经存在的发布者，用于顶替原有发布者
    insertsei: false # 是否启用插入SEI功能
    publishtimeout: 10s # 发布流默认过期时间，超过该时间发布者没有恢复流将被删除
    idletimeout: 0 # 发布者空闲超时时间，超过该时间发布者没有任何操作将被删除，0为关闭该功能
    delayclosetimeout: 0 # 自动关闭触发后延迟的时间(期间内如果有新的订阅则取消触发关闭)，0为关闭该功能，保持连接。
    waitclosetimeout: 0 # 发布者断开后等待时间，超过该时间发布者没有恢复流将被删除，0为关闭该功能，由订阅者决定是否删除
    buffertime: 0 # 缓存时间，用于时光回溯，0为关闭缓存
    key: "" # 订阅者鉴权秘钥
    secretargname: secret # 订阅者鉴权参数名
    expireargname: expire # 订阅者鉴权过期时间参数名
    speedlimit: 500ms # 限速超时时间0为不限速，对于读取文件这类流需要限速，否则读取过快
  subscribe:
    subaudio: true # 是否订阅音频流
    subvideo: true # 是否订阅视频流
    subaudioargname: ats # 订阅音频轨道参数名
    subvideoargname: vts # 订阅视频轨道参数名
    subdataargname: dts # 订阅数据轨道参数名
    subaudiotracks: [] # 订阅音频轨道名称列表
    subvideotracks: [] # 订阅视频轨道名称列表
    submode: 0 # 订阅模式，0为跳帧追赶模式，1为不追赶（多用于录制），2为时光回溯模式
    syncmode: 0 # 音视频同步模式，0 为按照时间戳同步，1 为按照写入时间同步
    iframeonly: false # 只订阅关键帧
    waittimeout: 10s # 等待发布者的超时时间，用于订阅尚未发布的流
    writebuffersize: 0 # 订阅者写缓存大小，用于减少io次数，但可能影响实时性
    key: "" # 订阅者鉴权秘钥
    secretargname: secret # 订阅者鉴权参数名
    expireargname: expire # 订阅者鉴权过期时间参数名
    internal: false # 是否内部订阅，内部订阅不会触发发布者自动断开功能
  pull:
    # 代表重试的次数，如果设置为`-1`则为无限重试，`0`则是不重试
    repull: 10
    # 代表代理地址，如果需要代理拉流，可以配置该项
    proxy: [Proxy URL]
    # 代表随着`m7s`启动，则立即进行拉流
    pullonstart:
      # 是一个键值对映射（map）`key`代表拉流进入`m7s`后的`streamPath`，`value`就是远程流地址
      live/test: [URL1]
      live/test2: [URL2]
    # 代表的是按需拉流，即`m7s`收到指定流的订阅时才开始拉流
    pullonsub:
      # 格式同上
      live/test3: [URL3]
      live/test4: [URL4]

接口 API

获取所有 HDL 流

• URL: /hdl/api/list
• 请求方式: GET
• 描述: 获取所有 HDL 流的列表
• 返回: 所有 HDL 流的列表

从 m7s 拉取 http-flv 协议流

• 描述: 如果 m7s 中已经存在 live/test 流的话就可以用 http-flv 协议进行播放 如果监听端口不配置则公用全局的 HTTP 端口(默认 8080)
• 示例:
  • ffplay http://localhost:8080/hdl/live/test.flv

m7s 从远程拉取 http-flv 协议流

• URL: /hdl/api/pull
• 请求方式: GET
• 描述: 从远程拉取 http-flv 协议流
• 参数:

参数名	必填	类型	描述
target	是	string	HTTP-FLV 地址，需要进行 urlencode 以防止特殊字符影响解析
streamPath	是	string	流标识，用于标识特定的流
save	是	int	保存选项：0、不保存；1、保存到 pullonstart；2、保存到 pullonsub

• 示例:
  • /hdl/api/pull?target=[HTTP-FLV地址]&streamPath=[流标识]&save=[0|1|2]