react-native-video在iPhone 13设备无法播放拍摄视频的问题求助

1. 对比视频编码与容器参数 #

导出iPhone13用户拍摄的视频文件，用媒体信息工具（比如MediaInfo）查看以下参数，和能正常播放的视频（如模拟器下载的视频）做对比：

• 容器格式（MOV/MP4）
• 视频编码（HEVC/H.264）及编码配置文件
• 分辨率、帧率、码率
• 音频编码格式

iPhone13默认拍摄的HEVC视频可能带有特定参数（比如10bit色深），部分旧版react-native-video依赖的AVPlayer组件可能存在兼容问题。

2. 验证视频路径的有效性与沙盒权限 #

用户拍摄的视频URI可能来自相机返回的assets-library://或ph://路径，尝试将视频复制到React Native FS可访问的沙盒目录，用本地file://路径重新播放：

import RNFS from 'react-native-fs';

// 假设originalUri是相机返回的视频路径
const copyVideo = async (originalUri) => {
  const destPath = `${RNFS.DocumentDirectoryPath}/temp-video.mp4`;
  await RNFS.copyFile(originalUri, destPath);
  // 用destPath作为react-native-video的source.uri
};

如果复制后能正常播放，说明原路径的沙盒访问权限或URI解析存在问题。

3. 排查react-native-video版本兼容性 #

检查当前使用的react-native-video版本，是否存在针对iOS 15+（iPhone13预装系统）的已知播放bug：

• 尝试升级到最新稳定版
• 若升级后问题依旧，可临时回退到v5.2.1等经多机型验证的稳定版本

4. 查看真机控制台错误日志 #

用Xcode连接iPhone13真机，运行应用并尝试播放视频，查看控制台中的AVPlayer相关错误信息：

• 关注类似AVPlayerItemFailedToPlayToEndTime的错误回调
• 记录错误码及描述（如解码失败、资源不可用），这是定位核心问题的关键

5. 强制启用软件解码 #

iPhone13的A15芯片硬件解码可能存在特定编码的兼容限制，尝试在react-native-video配置中强制启用软件解码：

<Video
  source={{ uri: videoUri }}
  // iOS专属配置
  useSoftwareDecoder={true}
  // 其他属性
/>

6. 验证权限配置 #

确认Info.plist中已正确添加相机、照片访问权限：

<key>NSCameraUsageDescription</key>
<string>需要访问相机拍摄视频</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>需要访问相册保存视频</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册选择视频</string>

即使其他机型正常，iPhone13的iOS版本可能对权限的校验更严格。

内容的提问来源于stack exchange，提问作者Shantanu Ingle