React Native iOS原生视频播放器锁屏解锁后无法二次播放问题咨询

这问题我之前帮同事排查过类似的，结合你说的「在线流正常、离线锁屏后黑屏」的现象，核心大概率是离线视频的播放器状态或本地文件关联在锁屏后失效了，给你梳理几个最可能的原因和落地的排查/解决方向：

1. 离线视频的本地路径在锁屏后失效 #

iOS的沙箱路径虽然相对稳定，但如果你的离线视频存在临时目录（比如NSTemporaryDirectory()），锁屏后系统可能会自动清理临时文件；或者你在创建播放器时缓存了路径字符串，但App从后台恢复时，某些动态生成的路径前缀可能发生变化（比如App Group的路径）。

• 排查步骤：在App解锁回到前台时，用react-native-fs的FileSystem.exists()检查离线视频文件是否还存在，同时打印当前使用的文件URL，确认和下载时的路径一致。
• 解决：把离线视频存在Documents目录（通过FileSystem.DocumentDirectoryPath获取），这里的文件不会被系统随意清理；每次播放前都重新获取最新的本地路径，不要缓存路径字符串。

2. AVPlayerItem的状态未在锁屏后重新恢复 #

在线流的AVPlayerItem会自动重试网络请求，但离线视频的AVPlayerItem在锁屏时可能因为媒体会话中断，直接进入failed或unknown状态，且不会自动恢复。

• 排查步骤：给AVPlayerItem添加status和error监听，在锁屏解锁后查看状态是否异常。如果用的是react-native-video库，可以监听onError和onLoad事件，看解锁后有没有报错。
• 解决：监听App的active状态（通过React Native的AppState API），当App从后台回到前台时，销毁旧的AVPlayerItem，重新创建新的Item并关联到播放器上，再调用播放方法。

3. 音频会话配置缺失导致权限丢失 #

iOS锁屏后会自动暂停非活跃的音频会话，离线视频如果没有正确配置音频会话类别，解锁后可能无法重新获取播放权限，导致视频只有黑屏（无画面渲染）或无声音。

• 排查步骤：检查你是否在播放器初始化前设置了音频会话类别。默认情况下，React Native的视频库可能没有配置AVAudioSessionCategoryPlayback，这个类别允许App在锁屏时继续播放媒体。
• 解决：在原生代码或通过react-native-audio-session库，初始化时设置：

// iOS原生代码示例
#import <AVFoundation/AVFoundation.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  NSError *error;
  [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback error:&error];
  [[AVAudioSession sharedInstance] setActive:YES error:&error];
  // 其他初始化代码
  return YES;
}

同时在App回到前台时，重新激活音频会话：

// React Native侧监听AppState
import { AppState } from 'react-native';

AppState.addEventListener('change', (state) => {
  if (state === 'active') {
    // 这里调用原生方法重新激活音频会话，或者用对应的RN库
    AudioSession.setActive(true);
  }
});

4. React Native组件生命周期的状态重置 #

如果你的视频播放器组件在App进入后台时被unmount（比如路由切换或状态管理的自动清理），解锁后重新渲染时没有正确加载离线视频的状态，也会导致黑屏。

• 排查步骤：在组件的componentDidMount/useEffect和componentWillUnmount里打印日志，看锁屏时组件是否被销毁。
• 解决：把离线视频的播放状态（比如文件路径、是否播放中）存在持久化存储（比如AsyncStorage）里，在组件重新挂载时读取状态，自动加载并恢复播放。

总结一下，核心思路就是：离线视频没有在线流的自动恢复机制，需要手动处理锁屏后的播放器状态、文件路径和音频会话的恢复，先从AppState监听和路径有效性排查入手，大概率能解决问题。

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