如何在 Android 中正确播放网络电台流媒体 URL-java教程-PHP中文网

如何在 Android 中正确播放网络电台流媒体 URL

本文详解如何使用 MediaPlayer 正确播放来自 radio-browser.info 等平台的实时音频流（如 Shoutcast/Icecast），重点解决因缺少音频属性配置、线程阻塞及弃用 API 导致的「无声播放」和 MediaPlayer error (1, -2147483648) 等常见问题。

本文详解如何使用 mediaplayer 正确播放来自 radio-browser.info 等平台的实时音频流（如 shoutcast/icecast），重点解决因缺少音频属性配置、线程阻塞及弃用 api 导致的「无声播放」和 `mediaplayer error (1, -2147483648)` 等常见问题。

在 Android 开发中，直接调用 MediaPlayer 播放 .mp3 文件链接较为简单，但播放 实时流媒体（如电台 URL） 时极易失败——表面无崩溃、Toast 提示“已开始播放”，实际却无声，Logcat 显示 error (1, -2147483648)（即 MEDIA_ERROR_UNKNOWN）或 error (-38, 0)（MEDIA_ERROR_NOT_VALID_FOR_PROGRESSIVE_PLAYBACK）。根本原因在于：流媒体需显式声明音频属性、避免主线程阻塞准备操作，且旧版 setAudioStreamType() 已被弃用。

✅ 正确实现步骤

1. 配置音频属性（必需）

Android 8.0（API 26）起，setAudioStreamType() 被弃用，必须使用 AudioAttributes 指定媒体用途与内容类型：

val audioAttributes = AudioAttributes.Builder()
    .setUsage(AudioAttributes.USAGE_MEDIA)        // 表明用于媒体播放（非通话/提示音）
    .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC) // 标识为音乐类内容
    .build()

2. 在后台线程完成数据源设置与准备

setDataSource() 和 prepare() 是阻塞 I/O 操作，绝不可在主线程执行（否则 ANR 或 prepareAsync 失败）。推荐使用协程 + Dispatchers.IO：

Android Adb Skill

Android 开发调试技能，通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能：(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作；(2)...

下载

private fun playAudio() {
    GlobalScope.launch(Dispatchers.Main) {
        try {
            val mediaPlayer = MediaPlayer().apply {
                setDataSource("https://play.sas-media.ru/play_256") // 推荐使用 HTTPS
                setAudioAttributes(audioAttributes)
                setOnPreparedListener { 
                    it.start()
                    Toast.makeText(this@MainActivity, "Radio is playing", Toast.LENGTH_SHORT).show()
                }
                setOnErrorListener { mp, what, extra ->
                    Log.e("MediaPlayer", "Error: $what, Extra: $extra")
                    Toast.makeText(this@MainActivity, "Playback failed", Toast.LENGTH_LONG).show()
                    return@launch
                }
            }

            // 在 IO 线程执行 prepare（同步方式更可控）
            withContext(Dispatchers.IO) {
                mediaPlayer.prepare() // 注意：此处为 blocking call，故必须在 IO 线程
            }

        } catch (e: IOException) {
            e.printStackTrace()
            Toast.makeText(this@MainActivity, "IO Error: ${e.message}", Toast.LENGTH_LONG).show()
        }
    }
}

⚠️ 注意事项：
不要混用 prepareAsync() 与手动 start()：若使用 prepareAsync()，必须通过 setOnPreparedListener 回调启动，否则 start() 会因未就绪而静默失败。

URL 必须支持跨域与 HTTP/HTTPS 流式传输：确保目标电台 URL（如 https://play.sas-media.ru/play_256）返回的是有效 Icecast/Shoutcast 流（HTTP 200 + audio/mpeg 等 MIME 类型），可通过浏览器或 curl -I 验证。
添加权限：AndroidManifest.xml 中需声明网络权限：
<uses-permission android:name="android.permission.INTERNET"></uses-permission><uses-permission android:name="android.permission.FOREGROUND_SERVICE"></uses-permission>
资源释放：实际项目中应在 Activity 生命周期（如 onDestroy()）中调用 mediaPlayer?.release()，避免内存泄漏。

✅ 替代方案建议（推荐长期维护）

MediaPlayer 对复杂流媒体兼容性有限。生产环境建议升级至 ExoPlayer（Google 官方推荐）：

原生支持 DASH、HLS、MP3 流、重连、缓冲策略；
更完善的错误日志与自定义解码器支持；

示例初始化仅需几行：

val player = ExoPlayer.Builder(this).build()
val mediaItem = MediaItem.fromUri("https://play.sas-media.ru/play_256")
player.setMediaItem(mediaItem)
player.prepare()
player.play()

综上，播放电台流的核心是：正确音频属性 + 后台线程准备 + 完善错误监听。避开弃用 API 与主线程阻塞，即可稳定驱动 MediaPlayer 播放真实网络电台流。