/plugin-hls

HLS协议的实现，提供HLS协议拉流，和HLS的写磁盘功能

Primary LanguageGoMIT LicenseMIT

介绍

该插件依赖github.com/Monibuca/plugin-ts

功能

  1. 该插件可用来拉取网络上的m3u8文件并解析后转换成其他协议
  2. 该插件可以在服务器写HLS文件，并且可以播放
  3. 配合gateway插件可以直接访问http://localhost:8080/hls/live/user1.m3u8 进行播放，其中8080端口是gateway插件配置的，live/user1是streamPath，需要根据实际情况修改
  4. 支持回放功能，即每次发布流后均会产生一个m3u8文件，可以通过该文件进行回放 http://localhost:8080/hls/live/user1/xxxxxxxxxx.m3u8 其中xxxxxxxx代表发布的时间戳（Unix时间戳）

API

参数是可变的，下面的参数live/hls是作为例子，不是固定的

  • /api/hls/list 列出所有HLS流，是一个SSE，可以持续接受到列表数据
  • /api/hls/save?streamPath=live/hls 保存指定的流（例如live/hls）为HLS文件（m3u8和ts）当这个请求关闭时就结束保存（该API仅作用于远程拉流）
  • /api/hls/pull?streamPath=live/hls&target=http://localhost/abc.m3u8 将目标HLS流拉过来作为媒体源在monibuca内以live/hls流的形式存在

配置

[HLS]
EnableWrite = false
EnableMemory = false
Fragment = 5
Window = 2
Path = "hls"
Filter = "^live"
[[AutoPullList]]
"live/hls" = "http://localhost/abc.m3u8"

EnableWrite 用来控制是否启用HLS文件写入功能 EnableMemory 用来启用内存播放模式，开启后ts数据会保存在内存中 AutoPullList 自动拉流配置，可以指定多个流，每个流的key是streamPath，value是目标地址 Filter 用来过滤发布的流，只有匹配到的流才会写入

  • 如果同时开启写入和内存模式的话，从gateway读取的ts会优先使用内存。

使用方法

  1. 创建HLS结构体实例
  2. 设置该对象的Video.Req和Audio.Req属性（用于请求m3u8文件）没有audio单独的m3u8可不设置Audio.Req属性
  3. 调用对象的Publish方法，传入流名称和上级publisher，如果没有就传本对象
  4. 使用UI界面，点击拉流转发，可以将一个远程的hls流拉入服务器中，配置StreamPath用于从服务器中播放这个流。

如果拉取远程ts文件需要cookie或者http的验证，可以将验证头设置到HLS对象的TsHead属性中。

func demo(){
    p:=new(HLS)
    p.Video.Req = http.NewRequest("GET","http://xxxx.com/demo.m3u8", nil)
    p.Publish("live/hls")
}