HoloCubic_AIO视频播放指南mjpeg格式转换与20fps流畅播放完整攻略【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIOHoloCubic_AIO 是一款基于 ESP32 的超多功能 AIO 固件内置天气时钟、相册、视频播放、桌面投屏、Web 服务等丰富应用。本文带你快速掌握其中视频播放Media应用的使用方法用配套上位机把 mp4 视频一键转换成 mjpeg 格式再放到内存卡的movie/目录里就能在小电视上实现 20fps 的流畅播放。一、视频播放 APP 的运行条件 在 README.md 的 APP 介绍中视频播放的运行条件非常明确条件说明内存卡必须插入 TF 卡FAT32 格式目录要求TF 卡根目录下必须存在movie/目录文件格式视频需转换为mjpeg或rgb格式文件命名英文字符或数字但不能以数字开头 不插内存卡不影响开机但视频播放、相册等应用会依赖 TF 卡这是所有 AIO 功能中唯一的硬性要求。二、用 AIO 上位机一键转换 mjpeg 格式 转换视频不需要自己记 ffmpeg 命令项目自带了图形化上位机CubicAIO_Tool源码见 AIO_Tool/CubicAIO_Tool.py其中的视频转换页由 AIO_Tool/page/videotool.py 实现。操作步骤只有 4 步选择视频点击选择视频支持 mp4、avi、mov、gif 等常用格式选择输出路径建议指向放置到内存卡目录方便整体拷贝确认参数默认值即为推荐值分辨率240 × 240与小电视屏幕 1:1帧率20 fps质量51~9 可选越大越清晰、文件越大格式MJPEG点击开始转换等待生成xxx_240x240.mjpeg文件工具内部实际执行的是两步 ffmpeg 处理先缩放到目标分辨率再按帧率抽取帧并压缩为 MJPEG 序列整个流程自动完成无需任何手动配置。⚠️ 视频原始长宽比最好接近1:1否则转换时会被居中裁剪画面两侧可能丢失内容。三、MJPEG 还是 RGB565BE如何选型 转换工具提供两种输出格式对应固件中两套解码器源码位于 AIO_Firmware_PIO/src/app/media_player/格式优点缺点适用场景MJPEG文件小、占卡空间少固件按 JPEG 流逐帧解码解码占 CPU帧率受主频影响推荐首选片源多RGB565BE免解码、直接写屏播放最稳定文件极大每帧 240×240×2 字节短片段、卡空间充足固件在 media_player.cpp 中会根据文件后缀自动选择MjpegPlayDecoder或RgbPlayDecoder所以你只需要选对格式转换播放器会自动识别。仓库的示例视频中就有现成的参考样例可直接放入内存卡试播放置到内存卡/movie/butterfly_240x240_20fps.mjpeg放置到内存卡/movie/dragon_240x240_20fps.mjpeg四、20fps 流畅播放的 3 个关键技巧 ⚡1. 帧率不要贪高20fps 是平衡点小电视屏幕只有 240×240 像素20fps 已经足够流畅帧率再高文件体积线性增大解码压力也随之上升。2. 注意固件的自动降频机制为保证长时间播放不烫手固件内置了低功耗策略见 media_player.cpp 中的定义无操作90 秒→ CPU 从 240MHz 降至 160MHz无操作120 秒→ 进一步降至 80MHz表现为播放画面帧数下降重新倾斜/摇晃小电视触发一下操作即可恢复 240MHz 满帧。也可以在 Web 设置页把功耗控制改为性能优先。3. 保持充足的供电视频播放是 TF 卡读写 JPEG 解码 SPI 刷屏的三重负载如果 USB 供电不足可能导致重启。建议使用 5V/2A 以上的充电器避免劣质线。五、把视频放进 movie 目录开始播放 将 放置到内存卡 目录中的全部内容尤其movie/目录拷贝到 TF 卡根目录你的.mjpeg或.rgb文件同样放入 TF 卡根目录的movie/下通电后注意前 3 秒保持小电视自然放置等 MPU6050 陀螺仪初始化完成RGB 灯完全亮起左右摇晃 0.5 秒切换应用找到视频播放图标向前倾斜 1 秒进入应用开始播放后仰 1 秒退出播放过程中还可以左右摇晃切换movie/目录下的其他视频播放到结尾会按设置自动循环或切下一部。六、常见问题速查FAQ❓Q1进入视频应用后直接跳出去了Amovie/目录不存在、或目录里没有.mjpeg/.rgb文件。检查 TF 卡目录结构和文件后缀。Q2文件名为中文或数字开头识别不到AAIO 固件要求文件名必须为英文字符或数字且不能以数字开头例如用butterfly.mjpeg而不是1butterfly.mjpeg。Q3播放卡顿、掉帧A确认文件帧率与实际解码能力匹配推荐 20fpsWeb 设置中切换性能优先检查供电是否充足。Q4mjpeg 文件太大TF 卡装不下A降低转换质量档位工具中质量参数调到 2~3或降低分辨率如 180×180体积会明显缩小。Q5RGB 文件太大怎么办ARGB565 是无压缩原始像素240×240 每帧约 112KB20fps 一秒即 2.2MB。片源超过 10 秒建议改用 MJPEG。写在最后至此从 mp4 到 20fps 流畅播放的完整链路就打通了上位机转换 mjpeg → 拷贝到 TF 卡movie/目录 → 摇一摇进入视频应用。整个过程不需要写任何代码普通用户 10 分钟内就能让小电视跑起来自己的第一部视频。更多 APP相册、天气、投屏等的配置方式可继续阅读 README.md 中的 APP 介绍章节或查看 HoloCubic小电视小白避坑指南 获取更多硬件与刷机经验。【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考