使用Kivy通过Buildozer部署至Android 9平板实现视频流的相关问题
可落地的排查与解决步骤
1. 优先修正视频播放后端配置
- Kivy 1.11.1 在Android端默认未绑定ffpyplayer作为
Video组件的播放后端,即便buildozer.spec里写了相关依赖,也可能因为打包顺序错误导致后端加载失效 - 强制指定后端的代码必须放在所有Kivy导入语句的最开头,放在main.py第一部分:
import os # 强制使用ffpyplayer作为视频播放后端,禁止使用默认的空后端 os.environ['KIVY_VIDEO'] = 'ffpyplayer' # 之后再导入Kivy相关模块 from kivy.uix.video import Video from kivy.app import App
- buildozer.spec 依赖项必须精简,避免后端冲突:
- 在
requirements字段明确指定固定版本:kivy==1.11.1, ffpyplayer==4.3.2, python3, numpy - 不要同时引入gstreamer和ffpyplayer依赖,两个播放后端会互相抢占接口导致播放失效,Android端MPJPG流、常见视频文件的兼容性优先选ffpyplayer
- 在
2. 解决Android 9.0明文HTTP流量拦截问题
- Android 9.0 系统默认拦截所有未加密的HTTP网络请求,即便已经申请了INTERNET权限,测试用的公共IP摄像头是HTTP明文地址,系统会直接拦截流量,导致视频拉取失败黑屏
- 配置方式:在buildozer.spec中添加应用级配置,允许明文流量传输:
android.extra_manifest_application_arguments = android:usesCleartextTraffic="true"
- 注意:INTERNET是Android普通权限,不需要动态申请,之前把INTERNET放到动态申请列表的操作完全不影响这个拦截逻辑
3. 修正权限申请与组件加载的时序问题
- 当前的权限申请逻辑存在时序错误:在App的
build()方法里同步调用request_permissions是异步执行逻辑,方法执行返回时,权限根本没有完成授予,此时加载需要存储权限访问的本地视频、需要网络权限的IP流,必然加载失败 - 正确的加载逻辑要放到权限申请的回调里,等权限全部授予完成后再初始化视频组件:
from android.permissions import request_permissions, Permission class CameraApp(App): def build(self): # 只需要申请需要动态授权的权限,INTERNET不需要放进来 request_permissions( [Permission.CAMERA, Permission.WRITE_EXTERNAL_STORAGE, Permission.READ_EXTERNAL_STORAGE], self.on_grant_finish ) # build方法里不要立刻初始化需要权限的视频组件,返回一个空的布局做占位 return self.root_widget def on_grant_finish(self, permissions, grant_results): # 权限全部回调完成后,再初始化视频组件 self.camera = Video( source="http://158.58.130.148:80/mjpg/video.mjpg", state='play' ) self.root_widget.add_widget(self.camera)
- 关于日志里的
WRITE_EXTERNAL_STORAGE重复声明警告:是Buildozer打包时自动给应用添加了存储权限声明,你自己的代码又重复申请一次导致的,不影响功能,可以直接忽略
4. 排除视频编码兼容问题
- 本地AVI视频黑屏大概率是编码不兼容:ffpyplayer对AVI容器内的Xvid/Divx编码支持较差,不要用这类测试文件做验证,换成H.264编码的MP4文件放到本地Movies目录下测试,确认基础播放能力正常后再测网络流
- 不要一开始就测公网IP摄像头源,先把视频组件加载应用自带assets目录下的本地MP4文件,验证组件本身可以正常解码播放后,再测试网络流,逐层缩小问题范围
5. 定向日志排查方法
- 不要全量抓取logcat日志,直接过滤视频相关的日志内容,跳过系统进程的无关报错:
adb logcat | grep -E "ffpyplayer|kivy.*video|MediaPlayer"
- 重点关注日志中
Couldn't open media、Cleartext HTTP not permitted、No video handler found类的报错,这类日志会直接指向黑屏的核心原因
内容的提问来源于stack exchange,提问作者Q2Learn
相关产品推荐
相关产品推荐

