在嵌入式 Linux 与 AI 视觉设备中，视频播放是非常常见的需求。

例如：

• 广告播放

• 商品宣传视频

• 摄像头调试

• AI 视频识别验证

• 大屏展示

• 远程运维测试

而在 INBOX700 设备中，系统默认已经集成了 mpv 播放器，并支持 Rockchip 平台硬件解码，非常适合用于高性能视频播放场景。

本文将详细介绍：

• INBOX700 自带 mpv 信息

• mpv 基础播放命令

• 硬解码使用

• SSH 远程播放

• xv 输出模式

• 循环播放

• 常见问题排查

适用于 Debian 系统环境。

---

一、INBOX700 默认 MPV 环境

INBOX700 出厂默认已经安装 mpv，无需额外安装，如发现版本中不包含MPV请联系映翰通技术支持。

可通过以下命令查看版本：

mpv --version

设备输出：

librga:RGA_GET_VERSION:3.02,3.020000
ctx=0x5591f3fa30,ctx->rgaFd=3
Rga built version:version:+2017-09-28 10:12:42

mpv 379ba7eeda-dirty
Copyright © 2000-2018 mpv/MPlayer/mplayer2 projects

ffmpeg library versions:
libavutil       56.22.100
libavcodec      58.35.100
libavformat     58.20.100
libswscale      5.3.100
libavfilter     7.40.101
libswresample   3.3.100

ffmpeg version: 4.1.4-1

可以看到：

• 已集成 librga

• 支持 Rockchip 图像加速

• 支持硬件解码

• 已集成 ffmpeg

• 可直接播放 H264 / H265 / 4K 视频

---

二、MPV 基础播放

1、播放本地视频

mpv test.mp4

或者：

mpv /home/root/video/1.mkv

---

2、全屏播放

mpv --fullscreen test.mp4

也可以播放后按：

f

切换全屏。

---

3、循环播放

广告机、大屏场景非常常用。

mpv --loop=inf test.mp4

参数说明：

参数	说明
--loop	循环一次
--loop=inf	无限循环

---

三、INBOX700 硬件解码（重点）

INBOX700 已支持 Rockchip 硬解。

建议播放视频时开启：

mpv --hwdec=auto test.mp4

---

四、Rockchip 平台硬解说明

INBOX700 的 mpv 已集成：

• RGA

• MPP

• ffmpeg

播放时日志中出现：

librga:RGA_GET_VERSION

说明系统正在调用 Rockchip 图像加速。

---

指定 Rockchip 硬解

部分场景可手动指定：

mpv --hwdec=rkmpp test.mp4

适用于：

• 4K 视频

• H265

• 高码率视频

• ARM CPU 降低占用

---

五、查看视频输出模式

查看系统支持的输出：

mpv --vo=help

常见输出：

输出模式	说明
gpu	GPU 输出
xv	X11 视频输出
drm	DRM 直出
sdl	SDL 输出

---

六、推荐使用 xv 输出

在 Debian + X11 环境下，推荐：

mpv --vo=xv test.mp4

优点：

• 兼容性好

• CPU 占用低

• SSH 场景更稳定

• 工控设备常用

---

七、SSH 远程播放视频

很多客户会通过 SSH 远程控制设备播放视频。

例如：

• 广告更新

• 视频测试

• 远程演示

• AI 设备调试

---

1、SSH 登录设备

先查看inbox710的IP ，在用电脑ssh ，输入密码

ssh linaro@192.168.1.100

---

2、播放视频

SSH 环境没有 DISPLAY，需要手动指定

DISPLAY=:0 XAUTHORITY=/home/linaro/.Xauthority mpv --vo=xv 1.mkv

---

八、后台自动播放

很多广告机项目会后台自动循环播放。

---

使用 nohup

nohup mpv --fullscreen --loop=inf test.mp4 &

---

开机自动播放脚本

创建：

vim play.sh

内容：

#!/bin/bash

export DISPLAY=:0

while true
do
    mpv --vo=xv --fullscreen --loop=inf /home/root/video/demo.mp4
    sleep 1
done

---

添加权限

chmod +x play.sh

---

运行

./play.sh

---

九、MPV 常用快捷键

按键	功能
Space	暂停
← →	快进/快退
f	全屏
q	退出
m	静音
9 / 0	音量调节
s	截图

---

---

十、INBOX700 典型应用场景

1、AI 自动售货机

用于：

• 商品宣传

• 广告轮播

• 开门动画

---

2、工业大屏

用于：

• 信息展示

• 视频轮播

• 数据可视化

---

3、视觉识别设备

用于：

• RTSP 调试

• 摄像头测试

• AI 视频验证

---

4、边缘 AI 设备

用于：

• H264/H265 视频播放

• 本地媒体渲染

• ARM 平台硬解

---

十一、推荐命令汇总

# 播放视频
mpv test.mp4

# 全屏播放
mpv --fullscreen test.mp4

# 无限循环
mpv --loop=inf test.mp4

# 开启硬解
mpv --hwdec=auto test.mp4

# Rockchip硬解
mpv --hwdec=rkmpp test.mp4

# 使用xv输出
mpv --vo=xv test.mp4

# SSH环境播放
export DISPLAY=:0

# 后台播放
nohup mpv --vo=xv --fullscreen --loop=inf test.mp4 &

---

总结

INBOX700 已默认集成 mpv，并支持 Rockchip 平台硬件解码。

相比传统播放器，mpv 更适合：

• Debian 系统

• ARM 平台

• AI 边缘设备

• 工控场景

• SSH 远程控制

• 自动循环播放

在广告机、售货机、视觉识别、大屏展示等项目中，mpv 都是非常稳定且高性能的视频播放方案。

---

官方参考

• mpv 官方网站

• mpv GitHub 项目