使用vidgear的StreamGear实现单源模式视频流处理-优快云博客

使用vidgear的StreamGear实现单源模式视频流处理

vidgear A High-performance cross-platform Video Processing Python framework powerpacked with unique trailblazing features :fire: 项目地址: https://gitcode.com/gh_mirrors/vi/vidgear

前言

在当今多媒体应用开发中，视频流处理是一个常见且重要的需求。vidgear项目中的StreamGear模块为开发者提供了一个强大的工具，可以轻松实现视频流的转码和分发。本文将重点介绍StreamGear的单源模式(Single-Source Mode)使用方法，帮助开发者快速上手这一功能。

准备工作

在开始使用StreamGear之前，需要确保系统已安装FFmpeg。StreamGear依赖FFmpeg进行核心操作，如果系统未检测到有效的FFmpeg可执行文件，API将抛出RuntimeError。

单源模式基础概念

单源模式是StreamGear的一种工作模式，具有以下特点：

自动生成与输入视频相同分辨率和帧率的主流(索引为0)
如果输入视频源包含音频流，将自动映射到所有生成的流
使用完毕后必须调用close()函数释放资源

基础用法示例

DASH格式输出

from vidgear.gears import StreamGear

# 激活单源模式并指定视频输入
stream_params = {"-video_source": "foo.mp4"}
# 指定输出manifest文件位置和参数
streamer = StreamGear(output="dash_out.mpd", **stream_params)
# 执行转码
streamer.transcode_source()
# 关闭资源
streamer.close()

HLS格式输出

from vidgear.gears import StreamGear

# 激活单源模式并指定视频输入
stream_params = {"-video_source": "foo.mp4"}
# 指定输出master playlist文件位置和参数
streamer = StreamGear(output="hls_out.m3u8", format="hls", **stream_params)
# 执行转码
streamer.transcode_source()
# 关闭资源
streamer.close()

执行上述代码后，StreamGear将生成包含主流信息的DASH或HLS格式文件，主流的分辨率和帧率与输入视频相同。

添加额外流配置

除了主流外，开发者还可以生成任意数量的次流，每个次流可以有不同的比特率或空间分辨率。

from vidgear.gears import StreamGear

stream_params = {
    "-video_source": "foo.mp4",
    "-streams": [
        {"-resolution": "1920x1080", "-video_bitrate": "4000k"},  # 1080p, 4000kbps
        {"-resolution": "1280x720", "-framerate": 30.0},  # 720p, 30fps
        {"-resolution": "640x360", "-framerate": 60.0},  # 360p, 60fps
        {"-resolution": "320x240", "-video_bitrate": "500k"},  # 240p, 500kbps
    ],
}

注意事项：

必须为每个流定义-resolution值
只需定义-video_bitrate或-framerate中的一个
系统资源有限，谨慎配置多个流

自定义音频输入

默认情况下，如果输入视频源包含音频，将自动映射到所有流。如需使用自定义音频源：

stream_params = {
    "-video_source": "foo.mp4",
    "-streams": [
        {"-resolution": "1280x720", "-video_bitrate": "4000k"},
        {"-resolution": "640x360", "-framerate": 60.0},
    ],
    "-audio": "/path/to/audio.aac",  # 自定义音频源
    "-acodec": "copy",  # 音频编码器
}

高级FFmpeg参数配置

StreamGear提供了对FFmpeg参数的细粒度控制，以下示例使用H.265/HEVC视频编码器和AAC音频编码器：

stream_params = {
    "-video_source": "foo.mp4",
    "-vcodec": "libx265",  # H.265/HEVC编码器
    "-x265-params": "lossless=1",  # 启用无损编码
    "-bpp": 0.15,  # 每像素比特数，保证高质量
    "-streams": [
        {"-resolution": "640x360", "-video_bitrate": "4000k"},
        {"-resolution": "320x240", "-framerate": 60.0},
    ],
    "-acodec": "aac",  # AAC音频编码器
}