React Native Video 组件在 Android 上的屏幕锁定问题解析

在使用 React Native Video 组件时，开发者可能会遇到一个常见问题：当视频正在播放或进入全屏模式时，Android 设备会因无操作而自动锁屏。这个问题不仅影响用户体验，还可能导致视频播放中断。

问题现象

在 Moto G31 等 Android 设备上，当使用 React Native Video 组件播放视频时，即使视频正在播放，系统仍会根据设备设置的无操作超时时间自动锁定屏幕。这种情况在全屏模式下尤为明显，因为用户通常不会在观看全屏视频时频繁操作设备。

解决方案

React Native Video 组件提供了一个专门用于解决此问题的属性：preventsDisplaySleepDuringVideoPlayback。这个属性的默认值为 true，理论上应该自动防止屏幕在视频播放期间锁定。但在某些情况下，特别是在较新版本的组件中，这个功能可能不会按预期工作。

有效解决方法

1. 显式设置属性：即使文档说明默认值为 true，也建议显式设置该属性：

   <Video
     preventsDisplaySleepDuringVideoPlayback={true}
     // 其他属性...
   />
   

2. 升级版本：如果问题持续存在，可以尝试升级到最新稳定版本（如 6.0.0-beta.4 或更高），因为这个问题可能在后续版本中得到了修复。

3. Android 原生配置：作为备选方案，可以在 Android 原生代码中配置保持屏幕常亮的权限，但这需要修改原生代码，不是纯 React Native 解决方案。

技术原理

preventsDisplaySleepDuringVideoPlayback 属性的实现原理是，在视频播放期间，组件会在底层调用 Android 的 WakeLock 机制，保持屏幕常亮。这个功能依赖于 Android 的 FLAG_KEEP_SCREEN_ON 标志，它告诉系统即使在用户无操作的情况下也不应该关闭屏幕。

最佳实践

1. 始终显式设置 preventsDisplaySleepDuringVideoPlayback 属性，而不是依赖默认值
2. 在组件挂载和卸载时正确处理屏幕常亮状态
3. 测试在不同 Android 版本和设备上的表现
4. 考虑用户设置：有些用户可能主动关闭了屏幕常亮功能，应用应该尊重这些设置

总结

React Native Video 组件的屏幕锁定问题通常可以通过正确使用 preventsDisplaySleepDuringVideoPlayback 属性来解决。开发者应该了解这个功能的工作原理，并在实际应用中充分测试，确保视频播放体验的连贯性。随着 React Native Video 版本的更新，这个问题可能会得到更好的解决，因此保持组件更新也是重要的维护策略。