OMXPlayer 技术文档

一、安装指南

1.1 下载 OMXPlayer

首先，需要从 GitHub 仓库克隆 OMXPlayer 项目代码：

git clone git://github.com/huceke/omxplayer.git

1.2 编译 OMXPlayer

OMXPlayer 需要 GCC 版本 4.7 或更高版本。

交叉编译

如果需要进行交叉编译，需要将 SD 卡内容挂载或复制到某个位置，并在 Raspberry Pi 系统上安装开发头文件。

编辑 Makefile.include 文件，根据你的位置更改设置：

make ffmpeg
make
make dist

在 Raspberry Pi 上编译

你也可以直接在 Raspberry Pi 上以原生方式编译 OMXPlayer。运行以下脚本，安装所需的包并更新固件：

./prepare-native-raspbian.sh

然后编译：

make ffmpeg
make

1.3 安装 OMXPlayer

将 omxplayer-dist/* 目录下的文件复制到 Raspberry Pi 的 / 目录下。你可以在 omxplayer 脚本中指定有效的字体路径。

二、项目使用说明

2.1 使用 OMXPlayer

OMXPlayer 是一个命令行工具，可以通过以下方式使用：

omxplayer [选项] [文件]

选项

以下是 OMXPlayer 支持的一些选项：

• -h / --help：打印帮助信息。
• -n / --aidx index：音频流索引。
• -o / --adev device：音频输出设备。
• -i / --info：打印流格式信息并退出。
• -s / --stats：打印 PTS 和缓冲区统计信息。
• -p / --passthrough：音频直通。
• -d / --deinterlace：去交错。
• -w / --hw：硬件音频解码。
• -3 / --3d mode：切换电视到 3D 模式。
• -y / --hdmiclocksync：调整显示刷新率以匹配视频。
• -z / --nohdmiclocksync：不调整显示刷新率以匹配视频。
• -t / --sid index：显示指定索引的字幕。
• -r / --refresh：调整帧率/分辨率以匹配视频。
• -g / --genlog：生成日志文件。
• -l / --pos n：指定开始位置（秒）。
• --boost-on-downmix：在混音时提升音量。
• --vol n：设置初始音量（毫贝，默认 0）。
• --subtitles path：外部 UTF-8 srt 格式字幕。
• --font path：字幕字体路径（默认：/usr/share/fonts/truetype/freefont/FreeSans.ttf）。
• --font-size size：字体大小（屏幕高度的千分之一）。
• --align left/center：字幕对齐方式（默认：左对齐）。
• --lines n：字幕缓冲区中容纳的行数。
• --win "x1 y1 x2 y2"：设置视频窗口位置。
• --audio_fifo n：音频输出 FIFO 大小（秒）。
• --video_fifo n：视频输出 FIFO 大小（MB）。
• --audio_queue n：音频输入队列大小（MB）。
• --video_queue n：视频输入队列大小（MB）。

例如：

./omxplayer -p -o hdmi test.mkv

三、项目 API 使用文档

OMXPlayer 是一个命令行工具，不提供 API 接口。

四、项目安装方式

请参考上述“安装指南”部分，涵盖了从下载、编译到安装的完整步骤。