树莓派（Raspbian）中使用Kivy播放视频卡顿的解决办法咨询

我之前在树莓派上用Kivy做视频播放项目时，也遇到过一模一样的加载正常但播放极慢的问题，折腾了好几种方法才搞定，分享给你试试：

1. 优先启用硬件加速的视频后端 #

树莓派的GPU本来就自带视频解码能力，但Kivy默认可能没用到最优的后端，推荐用gstreamer的硬件加速版本：

• 先更新系统并安装依赖：

  sudo apt update && sudo apt upgrade -y
  sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-omx
  

  其中gstreamer1.0-omx是关键的树莓派硬件加速模块，专门用来调用GPU解码视频。

• 配置Kivy使用gstreamer后端：
  可以在代码开头添加以下配置，或者修改~/.kivy/config.ini的[video]部分：

  from kivy.config import Config
  # 关闭抗锯齿，节省GPU资源
  Config.set('graphics', 'multisamples', '0')
  # 禁用ffmpeg后端，启用gstreamer
  Config.set('video', 'ffmpeg', '0')
  Config.set('video', 'gstreamer', '1')
  

2. 优化视频文件编码与参数 #

树莓派的解码能力有限，高分辨率、高码率的视频很容易卡顿，建议把视频转成适合树莓派的格式：

• 推荐用H.264编码，分辨率控制在720p以内，帧率25/30fps。用ffmpeg转码时可以用硬件加速：

  ffmpeg -i input.mp4 -c:v h264_omx -b:v 1M -r 25 -s 1280x720 output.mp4
  

  h264_omx会调用树莓派的GPU来转码，生成的视频解码压力小很多。

3. 调整Kivy图形设置减少开销 #

• 把窗口大小设置成和视频分辨率一致，避免实时缩放带来的性能消耗：

  from kivy.core.window import Window
  Window.size = (1280, 720)  # 替换成你的视频实际分辨率
  

• 关闭不必要的图形特效，比如如果你的项目用了Canvas绘制复杂图形，尽量简化或者异步更新。

4. 避免主线程阻塞 #

如果你的代码在播放视频的同时还有其他耗时操作（比如网络请求、数据计算），会阻塞Kivy的主线程，导致视频卡顿。

• 把这些耗时任务放到单独的线程中执行，比如用threading模块：

  import threading
  
  def heavy_task():
      # 这里写耗时的代码
      pass
  
  # 在需要的地方启动线程
  threading.Thread(target=heavy_task, daemon=True).start()
  

• 涉及到UI更新的操作，要回到主线程用Clock.schedule_once执行。

5. 升级Kivy到最新版本 #

老版本的Kivy可能存在树莓派平台的性能bug，用pip升级到最新稳定版：

pip install --upgrade kivy

一般按这个顺序排查，卡顿问题基本都能解决。我当时就是先换了gstreamer后端，再转了视频格式，播放就流畅了。

内容的提问来源于stack exchange，提问作者mohammadmansoor