Unity开发Android应用：WhatsApp通知触发Video Player崩溃求助

Hey Luis, let's break down why your 360 wildlife app is hitting that black screen (with audio still playing) when a WhatsApp notification pops up during video playback—this is a common edge case with Unity on Android, and we've got several targeted fixes to try:

1. Activity生命周期未正确处理 #

Android apps rely on strict Activity lifecycle events, and when a notification appears, your Unity Activity might trigger onPause() temporarily. Unity's VideoPlayer often struggles to recover from this state if you don't explicitly handle pause/resume logic, leading to lost video textures while the audio stream (which runs independently) keeps going.

Fix: #

Implement OnApplicationPause in your Unity C# script to manage the VideoPlayer state explicitly:

using UnityEngine;
using UnityEngine.Video;

public class VideoLifecycleHandler : MonoBehaviour
{
    private VideoPlayer _videoPlayer;
    private float _lastPlaybackTime;
    private bool _wasPlayingBeforePause;

    void Awake()
    {
        _videoPlayer = GetComponent<VideoPlayer>();
    }

    void OnApplicationPause(bool pauseStatus)
    {
        if (pauseStatus)
        {
            // Save playback state when the app is interrupted
            _wasPlayingBeforePause = _videoPlayer.isPlaying;
            if (_wasPlayingBeforePause)
            {
                _lastPlaybackTime = (float)_videoPlayer.time;
                _videoPlayer.Pause();
            }
        }
        else
        {
            // Restore state when the app regains focus
            if (_wasPlayingBeforePause)
            {
                // Re-load the video source to fix texture corruption
                _videoPlayer.source = _videoPlayer.source; // Refresh the source
                _videoPlayer.time = _lastPlaybackTime;
                _videoPlayer.Play();
            }
        }
    }
}

Attach this script to your VideoPlayer GameObject to ensure it properly saves and restores playback state when the app is interrupted by notifications.

2. SurfaceView/TextureView焦点丢失 #

Unity’s default VideoPlayer rendering on Android uses a native SurfaceView or TextureView. When a notification pops up, the system can steal focus from this surface, causing it to be destroyed or uninitialized—while audio keeps playing because it’s handled by a separate audio stream.

Fix: #

Switch to using a RenderTexture for video rendering instead:

• Create a new RenderTexture in Unity (right-click in Project window > Render Texture)
• Assign this RenderTexture to your VideoPlayer’s Target Texture field in the Inspector
• Add a RawImage UI element (or a 3D quad for your 360 setup) and set its texture to the same RenderTexture

This way, video is rendered into a Unity-managed texture, which is far less likely to be affected by Android’s native surface focus changes.

3. Video Decoding Thread Preemption #

When a WhatsApp notification arrives, Android may allocate system resources to the notification service, which can starve Unity’s video decoding thread. This leads to the video frame pipeline getting stuck, resulting in a black screen even though audio continues.

Fixes: #

• Enable Multithreaded Rendering in Unity’s Player Settings (Edit > Project Settings > Player > Android > Other Settings > Multithreaded Rendering) to offload rendering tasks and reduce thread contention.
• Optimize your video file: Use H.264 Baseline or Main Profile (Android’s most efficient supported codec) and avoid overly high-resolution bitrates that would strain the decoder.
• In Unity’s VideoPlayer settings, set Render Mode to API Only if you’re using RenderTexture—this gives you more control over rendering timing and reduces reliance on native system components.

4. Background Restrictions & Permissions #

Some Android devices have strict background management policies. When a notification pops up, the system might temporarily restrict GPU access or put parts of your app in a low-power state, breaking video rendering.

Fixes: #

• Enable Run in Background in Unity’s Player Settings (Edit > Project Settings > Player > Android > Other Settings > Run in Background) to ensure your app maintains access to resources during brief interruptions.
• Add the WAKE_LOCK permission to your AndroidManifest.xml (edit this via Unity’s Player Settings > Android > Publishing Settings > Custom Main Manifest):

  <uses-permission android:name="android.permission.WAKE_LOCK" />
  

This prevents the device from reducing resource allocation to your app when it’s active but interrupted by a notification.

Start with the first two fixes (lifecycle handling and RenderTexture switch)—these resolve the vast majority of cases like this. Let me know if you need to tweak any of these steps for your specific 360 video setup!

内容的提问来源于stack exchange，提问作者Luis Fernando Casas Borja