使用react-native-vision-camera在Z Fold 5上出现相机黑屏问题求助

架构老林

2026-6-30

react-native-vision-camera 在三星Z Fold 5上显示黑屏的排查方案

检查折叠屏适配配置
Z Fold5是折叠屏设备，Vision Camera可能需要针对折叠状态做特殊适配。在AndroidManifest.xml的对应activity标签里添加以下配置：
```
<activity
  ...
  android:resizeableActivity="true"
  android:supportsPictureInPicture="true"
  android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation" />
```
同时保证Camera组件用自适应布局（比如flex:1），别固定死宽高，避免折叠状态下视图尺寸异常导致渲染失败。
验证相机权限与硬件兼容性
哪怕其他设备正常，Z Fold5的相机硬件可能有特殊要求。确认android.permission.CAMERA已在Manifest中声明，且运行时动态申请了权限。另外试试切换前后置相机，看是否某一个能正常工作，排除硬件特定的兼容问题。
检查Vision Camera版本与适配补丁
确认你用的Vision Camera版本有没有修复折叠屏相关bug，直接升级到最新稳定版试试。也可以去库的GitHub issues里搜Z Fold5相关的问题，看看有没有现成的解决方案，部分旧版本可能需要手动加折叠屏的native补丁。
调试相机会话状态
在Camera组件里加状态监听，打印错误和状态信息：
```
<Camera
  ...
  onCameraError={(error) => console.log("Camera Error:", error)}
  onCameraStatusChanged={(status) => console.log("Camera Status:", status)}
/>
```
根据输出的信息定位问题，比如是不是相机会话初始化失败、预览纹理加载出问题了。
禁用硬件加速（临时排查）
部分折叠屏设备的硬件加速可能和相机预览冲突。试试在AndroidManifest.xml的application标签里加：
```
android:hardwareAccelerated="false"
```
测试能不能正常显示预览，如果有效再进一步排查硬件加速的具体冲突点。