Streamio FFMPEG 项目技术文档

1. 安装指南

1.1 安装依赖

在使用 Streamio FFMPEG 之前，确保系统中已经安装了 ffmpeg。可以通过以下命令在 macOS 上安装 ffmpeg：

brew install ffmpeg

1.2 安装 Streamio FFMPEG

使用 RubyGems 安装 Streamio FFMPEG：

gem install streamio-ffmpeg

2. 项目的使用说明

2.1 引入 Gem

在 Ruby 脚本中引入 Streamio FFMPEG：

require 'streamio-ffmpeg'

2.2 读取视频元数据

通过 FFMPEG::Movie 类读取视频文件的元数据：

movie = FFMPEG::Movie.new("path/to/movie.mov")

movie.duration # 视频时长（秒）
movie.bitrate # 比特率（kb/s）
movie.size # 文件大小（字节）

movie.video_stream # 视频流信息
movie.video_codec # 视频编码格式
movie.colorspace # 色彩空间
movie.resolution # 分辨率
movie.width # 视频宽度（像素）
movie.height # 视频高度（像素）
movie.frame_rate # 帧率（fps）

movie.audio_stream # 音频流信息
movie.audio_codec # 音频编码格式
movie.audio_sample_rate # 音频采样率
movie.audio_channels # 音频通道数

movie.valid? # 视频是否有效

2.3 视频转码

使用 transcode 方法进行视频转码：

movie.transcode("tmp/movie.mp4") # 默认的 ffmpeg 设置，输出为 mp4 格式

可以通过块来跟踪转码进度：

movie.transcode("movie.mp4") { |progress| puts progress } # 输出进度：0.2 ... 0.5 ... 1.0

使用自定义命令行选项进行转码：

movie.transcode("movie.mp4", %w(-ac aac -vc libx264 -ac 2 ...))

2.4 截图

使用 screenshot 方法生成视频截图：

movie.screenshot("screenshot.jpg")

可以指定截图的时间点和分辨率：

movie.screenshot("screenshot.bmp", seek_time: 5, resolution: '320x240')

3. 项目API使用文档

3.1 FFMPEG::Movie 类

• new(path)：初始化一个 Movie 对象，传入视频文件路径。
• duration：返回视频时长（秒）。
• bitrate：返回视频比特率（kb/s）。
• size：返回文件大小（字节）。
• video_stream：返回视频流信息。
• video_codec：返回视频编码格式。
• colorspace：返回色彩空间。
• resolution：返回分辨率。
• width：返回视频宽度（像素）。
• height：返回视频高度（像素）。
• frame_rate：返回帧率（fps）。
• audio_stream：返回音频流信息。
• audio_codec：返回音频编码格式。
• audio_sample_rate：返回音频采样率。
• audio_channels：返回音频通道数。
• valid?：判断视频是否有效。

3.2 transcode 方法

• transcode(output_path, options = {}, transcoder_options = {})：将视频转码为指定格式，并输出到指定路径。
  • output_path：输出文件路径。
  • options：转码选项，支持自定义 ffmpeg 命令行参数。
  • transcoder_options：转码器选项，如 preserve_aspect_ratio 等。

3.3 screenshot 方法

• screenshot(output_path, options = {}, transcoder_options = {})：生成视频截图并保存到指定路径。
  • output_path：输出文件路径。
  • options：截图选项，如 seek_time、resolution 等。
  • transcoder_options：转码器选项，如 preserve_aspect_ratio 等。

4. 项目安装方式

4.1 通过 RubyGems 安装

使用以下命令安装 Streamio FFMPEG：

gem install streamio-ffmpeg

4.2 手动安装

如果需要手动安装，可以从 GitHub 下载源码并进行安装：

git clone https://github.com/bikeath1337/streamio-ffmpeg.git
cd streamio-ffmpeg
gem build streamio-ffmpeg.gemspec
gem install streamio-ffmpeg-*.gem

通过以上步骤，您可以成功安装并使用 Streamio FFMPEG 进行视频处理。