Android中MediaPlayer模拟器正常运行但真机失效问题排查

Hey there! Let's break down why your direct-stream music app works smoothly on the emulator but hits a wall with prepare() failing on real devices. I've seen this exact scenario a bunch of times, so let's walk through the most likely fixes step by step.

Common Causes & Fixes #

1. Network Permissions & Security Restrictions (Most Likely Culprit) #

Emulators often have looser network rules, but real devices enforce Android's security policies strictly:

• Double-check the INTERNET permission: Make sure you've added this to your AndroidManifest.xml—it's non-negotiable for network-based streaming:

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

• Handle HTTP streams on Android 9+: If your direct link uses HTTP (not HTTPS), Android Pie and later block unencrypted traffic by default. To fix this:
  • Option 1: Switch your stream URL to HTTPS (preferred for security and long-term compatibility).
  • Option 2: Create a network security config file (res/xml/network_security_config.xml) to allow plaintext traffic:

    <?xml version="1.0" encoding="utf-8"?>
    <network-security-config>
        <base-config cleartextTrafficPermitted="true" />
    </network-security-config>
    

    Then reference it in your AndroidManifest.xml's <application> tag:

    <application
        ...
        android:networkSecurityConfig="@xml/network_security_config">
    

2. Use prepareAsync() Instead of Synchronous prepare() #

Streaming media relies on network latency, and the synchronous prepare() call can time out on real devices (even if it works fast on the emulator). Switch to asynchronous preparation with error handling to get actionable logs:

MediaPlayer mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
try {
    mediaPlayer.setDataSource(context, Uri.parse(yourStreamUrl));
} catch (IOException e) {
    e.printStackTrace();
    Log.e("PlayerInit", "Failed to set data source: " + e.getMessage());
    return;
}

// Set listeners for async preparation and errors
mediaPlayer.setOnPreparedListener(mp -> mp.start());
mediaPlayer.setOnErrorListener((mp, what, extra) -> {
    Log.e("PlayerError", "Error Code: " + what + ", Extra: " + extra);
    // Common error codes to diagnose:
    // - MEDIA_ERROR_IO: Network/IO issue (check URL accessibility)
    // - MEDIA_ERROR_UNSUPPORTED: Unsupported audio format/codec
    // - MEDIA_ERROR_SERVER_DIED: Stream server connection issue
    return true;
});

mediaPlayer.prepareAsync();

3. Verify Your Stream URL is Accessible on Real Devices #

Emulators might be on the same network as your stream server, but real devices (especially on mobile data) might not reach it. Test the URL directly in your device's browser:

• If the browser can't play the stream, the issue is with the URL itself (expired, authentication required, CORS restrictions, etc.).
• If it plays in the browser but not your app, check if the URL has special characters that need URL encoding (e.g., spaces, ampersands).

4. Fix MediaPlayer State Management #

Real devices are stricter about MediaPlayer state transitions. Ensure you're following the correct lifecycle:

• Always initialize a new MediaPlayer instance (or properly release the old one) before setting a new data source.
• Don't call prepare() or start() before setDataSource() completes successfully.
• Avoid performing MediaPlayer operations on the main UI thread (your AsyncTask approach is good here, but ensure doInBackground handles initialization exclusively).

5. Ditch AsyncTask (It's Deprecated!) #

AsyncTask has been deprecated since Android 11, and real devices may have background execution limits that break it. Replace it with Kotlin Coroutines or Java's ExecutorService for more reliable background processing:
Example with Coroutines (if you're using Kotlin):

lifecycleScope.launch(Dispatchers.IO) {
    val mediaPlayer = MediaPlayer().apply {
        setAudioStreamType(AudioManager.STREAM_MUSIC)
        setDataSource(context, Uri.parse(yourStreamUrl))
        prepareAsync()
    }
    withContext(Dispatchers.Main) {
        mediaPlayer.setOnPreparedListener { it.start() }
        mediaPlayer.setOnErrorListener { _, what, extra ->
            Log.e("PlayerError", "Error: $what, $extra")
            true
        }
    }
}

Final Steps #

1. Add the error listener from point 2 to get precise error codes—this will narrow down the issue faster than guessing.
2. Test your app on multiple real devices if possible (different brands/Android versions) to rule out device-specific quirks.

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