点播服务

2026年 5月 20日下午3:36

## 简介
从v3.25.16版开始，支持HLS点播服务：提供视频上传，自动监听，自动切片，数据查询，点播回放等功能。
NMS自身可作为简单的点播流媒体服务器使用，也可以配合Nginx等进行边缘缓存加速播放等架构。

## 功能特性
- 支持WebUI后台上传视频文件进行切片
- 支持.mp4 / .mkv /.avi/.mov/.flv文件格式
- 视频支持H.264/H.265
- 音频支持AAC, 非AAC音频编码自动转为AAC
- 支持WebUI查询任务列表，进度，封面图，分辨率等信息
- 支持WebUI后台直接点播播放，删除任务
- 支持ftp，sftp等方式上传监听目录后自动切片
- 支持切片开始，成功，失败，删除等事件回调
- 所有操作都提供API接口

## 配置说明
开启点播服务，依赖两项配置
### 1. 在[av]段配置ffmpeg和ffprobe的bin文件路径，下载预编译版本：[https://github.com/BtbN/FFmpeg-Builds/releases](https://github.com/BtbN/FFmpeg-Builds/releases) 
```
[av]
# ffmpeg path /usr/local/bin/ffmpeg , realtime video transcoding will be enabled if set
ffmpeg_binpath        = /usr/local/bin/ffmpeg
# ffprobe path /usr/local/bin/ffprobe
ffprobe_binpath       = /usr/local/bin/ffprobe

```

### 2.配置新增vod参数
```
[vod]
# vod_on Whether to enable VOD slicing service, requires http or https service to be enabled
vod_on             = true
# vod_path VOD file storage path, all HLS slices will be stored here
vod_path           = ./vod
# vod_watch_path Folder path to monitor for new video files, files uploaded here will be automatically sliced
vod_watch_path     = ./vod/watch
# vod_segment_time HLS slice duration in seconds, default 10
vod_segment_time   = 10
# vod_allow_cache Whether to allow clients to cache media segments
vod_allow_cache    = true
# vod_max_concurrent Maximum number of concurrent slicing tasks, default 3
vod_max_concurrent = 3
# vod_auto_delete Automatically delete source file after successful slicing
vod_auto_delete    = false
# vod_screenshot_time Screenshot capture time in seconds, default 2
vod_screenshot_time = 2
```

## WebUI 操作说明
### 启动服务后进入点播管理，点击上传视频
![](https://www.nodemedia.cn/doc/server/index.php?s=/api/attachment/visitFile&sign=24e590cc90e264b882bbc84f6daf7936)

### 上传成功后进入队列自动切片
![](https://www.nodemedia.cn/doc/server/index.php?s=/api/attachment/visitFile&sign=33782f99ca649df7e9a79df5d6c6d257)
### 刷新列表可看到切片完成
![](https://www.nodemedia.cn/doc/server/index.php?s=/api/attachment/visitFile&sign=66f2d433a94e773213b449b68adb0d57)
### 点击播放可在后台预览视频
![](https://www.nodemedia.cn/doc/server/index.php?s=/api/attachment/visitFile&sign=8f6e155f7d6d7dc34591801eadc0b013)
### 也可以进行复制url操作
### 删除切片任务会自动删除切片目录和原始文件

## 系统集成
切片任务是异步完成的，因此与现有系统通过事件通知进行集成，通过文件名进行关联
### 开始事件
```
{
  id: &#039;n5m4qa4zeadjy71zkndtv9ibuov873at&#039;,
  name: &#039;bbb_sunflower_1080p.mp4&#039;,
  mid: &#039;d1788983ef918414508a375e2bbef92ddb27ba078f7d92ad6d91f6bc9abc2081&#039;,
  action: &#039;vodSliceStarted&#039;,
  source_path: &#039;vod/watch/bbb_sunflower_1080p.mp4&#039;,
  source_size: 328615777,
  status: &#039;pending&#039;,
  duration: 0,
  width: 0,
  height: 0,
  video_codec: &#039;&#039;,
  audio_codec: &#039;&#039;,
  created_at: 1769587872158,
  completed_at: 0
}
```
### 完成事件
```
{
  id: &#039;n5m4qa4zeadjy71zkndtv9ibuov873at&#039;,
  name: &#039;bbb_sunflower_1080p.mp4&#039;,
  mid: &#039;d1788983ef918414508a375e2bbef92ddb27ba078f7d92ad6d91f6bc9abc2081&#039;,
  action: &#039;vodSliceComplete&#039;,
  source_path: &#039;vod/watch/bbb_sunflower_1080p.mp4&#039;,
  source_size: 328615777,
  status: &#039;completed&#039;,
  duration: 634,
  width: 1920,
  height: 1080,
  video_codec: &#039;h264&#039;,
  audio_codec: &#039;aac&#039;,
  created_at: 1769587872158,
  completed_at: 1769587872804
}

```

### 删除事件
```
{
  id: &#039;n5m4qa4zeadjy71zkndtv9ibuov873at&#039;,
  name: &#039;bbb_sunflower_1080p.mp4&#039;,
  mid: &#039;d1788983ef918414508a375e2bbef92ddb27ba078f7d92ad6d91f6bc9abc2081&#039;,
  action: &#039;vodSliceDeleted&#039;,
  source_path: &#039;vod/watch/bbb_sunflower_1080p.mp4&#039;,
  source_size: 328615777,
  status: &#039;completed&#039;,
  duration: 634,
  width: 1920,
  height: 1080,
  video_codec: &#039;h264&#039;,
  audio_codec: &#039;aac&#039;,
  created_at: 1769587872158,
  completed_at: 1769587872804
}
```

### 失败事件
```
{
  id: &#039;gvr2chuq7yah0tssyreblbcckrg549as&#039;,
  name: &#039;myVideo.mp4&#039;,
  mid: &#039;d1788983ef918414508a375e2bbef92ddb27ba078f7d92ad6d91f6bc9abc2081&#039;,
  action: &#039;vodSliceFailed&#039;,
  source_path: &#039;vod/watch/myVideo.mp4&#039;,
  source_size: 790099,
  status: &#039;failed&#039;,
  duration: 0,
  width: 0,
  height: 0,
  video_codec: &#039;unknown&#039;,
  audio_codec: &#039;unknown&#039;,
  error_msg: &#039;exit status 183&#039;,
  created_at: 1769588055159,
  completed_at: 1769588055544
}
```

## 外部播放地址
根据切片后的id，可以自行拼接URL
### 封面地址
http://server_ip:8000/vod/{id}/cover.jpg
### m3u8地址
http://server_ip:8000/vod/{id}/index.m3u8

文档

点播服务