CapacitorJS应用在部分Android设备上无法唤起原生相机求助

问题复盘 #

在CapacitorJS应用中使用标准HTML标签<input type="file" accept="image/*" capture>唤起原生相机，多数设备正常，但Motorola Moto G31和Pixel 5模拟器上直接跳转至文件浏览器。原生浏览器中所有测试的input组合均有效，移植到Capacitor后全部失效，控制台出现两个关键错误：

D/Capacitor: Unable to find a Capacitor plugin to handle permission requestCode, trying Cordova plugins 190163686
W/Capacitor/FileChooser: Media capture intent could not be launched. Falling back to default file picker.

Manifest已配置相机、存储权限及硬件特性，调整权限位置后问题依旧。

可行解决方案 #

1. 改用Capacitor官方Camera插件替代HTML input #

Capacitor的Camera插件是原生实现，比HTML input更适配跨设备场景，可避免WebView内核的兼容性问题：

import { Camera, CameraResultType, CameraSource } from '@capacitor/camera';

async function takePhoto() {
  const image = await Camera.getPhoto({
    quality: 90,
    allowEditing: false,
    resultType: CameraResultType.Uri,
    source: CameraSource.Camera // 直接指定相机源
  });

  // 处理返回的图片URI
  const imageUrl = image.webPath;
}

同时确认AndroidManifest.xml中已配置插件所需权限（插件通常会自动合并，也可手动添加）：

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />

2. 调整Capacitor FileChooser的配置 #

Capacitor的FileChooser组件负责处理input file请求，部分设备上可能因intent解析问题 fallback到文件选择器。可在capacitor.config.ts中添加配置强制优先调用相机：

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'your.app.id',
  appName: 'Your App',
  webDir: 'www',
  android: {
    intentFilters: [
      {
        actions: ['android.media.action.IMAGE_CAPTURE'],
        categories: ['android.intent.category.DEFAULT'],
        dataTypes: ['image/*']
      }
    ]
  }
};

export default config;

3. 手动检查并请求相机权限 #

虽然Manifest已配置权限，但应用运行时可能未获得实际授权。调用input前先执行权限检查：

import { Permissions } from '@capacitor/core';

async function checkCameraPermission() {
  const status = await Permissions.check({ name: 'camera' });
  if (status.state !== 'granted') {
    const result = await Permissions.request({ name: 'camera' });
    if (result.state !== 'granted') {
      // 提示用户授权相机权限
      return false;
    }
  }
  return true;
}

4. 升级Capacitor版本 #

旧版本Capacitor可能存在FileChooser组件的兼容性bug，尝试升级到最新稳定版：

npm install @capacitor/core@latest @capacitor/android@latest
npx cap sync android

5. 针对Pixel模拟器的特殊处理 #

Pixel 5模拟器可能存在虚拟相机配置问题，可尝试：

• 确认模拟器已启用虚拟相机（AVD管理器中编辑设备，Camera选项设为“Emulated”）
• 重启模拟器或创建新的AVD实例测试

关键原因分析 #

控制台错误Media capture intent could not be launched说明Capacitor的FileChooser无法正确唤起相机intent，可能原因：

• 设备厂商对WebView的intent处理做了自定义限制（如Motorola的WebView修改）
• Capacitor的FileChooser组件与特定Android版本/设备的intent解析不兼容
• HTML input的capture属性在WebView中的支持度弱于原生浏览器

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