Android设备视频FPS计算异常求助：Chaquopy集成OpenCV获取FPS返回0

我们开发一款Android视频帧提取应用，使用Chaquopy在Android Studio中集成Python。cv2.VideoCapture()可正常加载视频，但调用vid.get(cv2.CAP_PROP_FRAME_COUNT)获取视频总帧数时始终返回0。

原代码片段：

import cv2
import os
def hello(something):
    vid=cv2.VideoCapture('/storage/emulated/0/Movies/CameraX-Video/20_abc_.mp4')
    cur=0

    success=True
    path='/storage/emulated/0/Download'
    fps = vid.get(cv2.CAP_PROP_FRAME_COUNT)
    return fps
  
    while(True):
        success,frame=vid.read()
        if(success==False):
            break
        cv2.imwrite(os.path.join(path , 'frame%d.jpg'%cur), frame)
        
        
        cur+=1

解决方案 #

• 确保OpenCV包含完整FFmpeg编解码器
  Chaquopy默认安装的OpenCV可能缺少FFmpeg组件，导致无法解析视频元数据。在app模块的build.gradle中修改Chaquopy的pip配置，指定安装带完整编解码器的opencv-python-headless：

  chaquopy {
      pip {
          install "opencv-python-headless>=4.5.5"
      }
  }
  

• 验证视频文件与权限

  1. 检查视频文件是否完整：用Android系统自带播放器打开视频，确认能正常播放且显示正确时长。
  2. 确认权限配置：在AndroidManifest.xml中添加存储权限，Android 10及以下申请READ_EXTERNAL_STORAGE，Android 11+申请MANAGE_EXTERNAL_STORAGE，并在运行时动态请求权限。

• 调整代码逻辑，强制加载元数据
  部分视频需要先读取一帧才能正确解析元数据，修改代码如下：

  import cv2
  import os
  
  def hello(something):
      video_path = '/storage/emulated/0/Movies/CameraX-Video/20_abc_.mp4'
      vid = cv2.VideoCapture(video_path)
      
      # 检查视频是否成功打开
      if not vid.isOpened():
          return -1
      
      # 读取一帧后重置到起始位置，触发元数据加载
      success, _ = vid.read()
      if success:
          vid.set(cv2.CAP_PROP_POS_FRAMES, 0)
      
      frame_count = vid.get(cv2.CAP_PROP_FRAME_COUNT)
      path = '/storage/emulated/0/Download'
      cur = 0
      
      while success:
          success, frame = vid.read()
          if not success:
              break
          cv2.imwrite(os.path.join(path, f'frame{cur}.jpg'), frame)
          cur += 1
      
      # 释放视频资源
      vid.release()
      return frame_count
  

• 检查Chaquopy兼容性
  确保项目的minSdkVersion不低于21，使用最新稳定版的Chaquopy插件，避免版本兼容问题导致的元数据读取失败。

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