You need to enable JavaScript to run this app. 使用Kivy通过Buildozer部署至Android 9平板实现视频流的相关问题
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 16:15:04