本文详解如何使用 mediaplayer 正确播放 http 流式音频（如 radio-browser.info 提供的电台链接），解决因缺少音频属性配置、线程阻塞或过时 api 导致的静音、崩溃或错误码（如 -2147483648、-38）问题。
本文详解如何使用 mediaplayer 正确播放 http 流式音频（如 radio-browser.info 提供的电台链接），解决因缺少音频属性配置、线程阻塞或过时 api 导致的静音、崩溃或错误码（如 -2147483648、-38）问题。
在 Android 开发中，直接用 MediaPlayer 播放普通 MP3 文件较为简单，但播放 实时流媒体音频（如 Shoutcast/Icecast 电台流：http://play.sas-media.ru/play_256）时，常遇到“无声音”“黑屏播放”或 Logcat 报错 MediaPlayer error (1, -2147483648)（即 MEDIA_ERROR_UNKNOWN）和 error (-38, 0)（即 MEDIA_ERROR_NOT_VALID_FOR_PROGRESSIVE_PLAYBACK）。根本原因在于：流媒体需显式声明音频属性、避免主线程阻塞、并适配 Android 9+ 的网络明文限制与 API 演进。
✅ 正确实现要点
必须设置 AudioAttributes（替代已废弃的 setAudioStreamType()）
setAudioStreamType() 自 API 26 起已弃用。新方式需通过 AudioAttributes.Builder 明确指定用途（USAGE_MEDIA）和内容类型（CONTENT_TYPE_MUSIC），否则系统可能拒绝播放流媒体。prepare() 必须在后台线程执行
setDataSource() + prepare() 是阻塞操作，若在主线程调用会触发 NetworkOnMainThreadException 或 ANR；即使未崩溃，也易导致 UI 卡顿与播放失败。推荐使用 withContext(Dispatchers.IO) 或 prepareAsync() + 监听器。-
启用明文网络请求（如 URL 为 HTTP）
Android 9（API 28）起默认禁止明文 HTTP 请求。若电台地址为 http://...（非 HTTPS），需在 AndroidManifest.xml 中添加：<application android:usesCleartextTraffic="true" ... > -
添加必要权限
在 AndroidManifest.xml 中声明网络权限：<uses-permission android:name="android.permission.INTERNET" />
✅ 推荐代码实现（Kotlin + Coroutines）
private fun playAudio() {
val audioAttributes = AudioAttributes.Builder()
.setUsage(AudioAttributes.USAGE_MEDIA)
.setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
.build()
lifecycleScope.launch {
try {
val mediaPlayer = MediaPlayer().apply {
setAudioAttributes(audioAttributes)
setDataSource("https://play.sas-media.ru/play_256") // ✅ 建议优先使用 HTTPS
setOnPreparedListener {
it.start()
Toast.makeText(this@MainActivity, "Radio is playing", Toast.LENGTH_SHORT).show()
}
setOnErrorListener { _, what, extra ->
Log.e("MediaPlayer", "Error: $what, Extra: $extra")
Toast.makeText(this@MainActivity, "Playback failed", Toast.LENGTH_LONG).show()
return@launch
}
prepareAsync() // ✅ 非阻塞，回调驱动
}
} catch (e: IOException) {
Log.e("MediaPlayer", "DataSource setup failed", e)
Toast.makeText(this@MainActivity, "Failed to load stream", Toast.LENGTH_LONG).show()
}
}
}? 关键说明：
- 使用 prepareAsync() + setOnPreparedListener 是更安全、响应式的模式，避免手动管理线程；
- lifecycleScope 替代 GlobalScope，确保 Activity 销毁时协程自动取消，防止内存泄漏；
- setOnErrorListener 可捕获具体错误码（如 what=1 表示 MEDIA_ERROR_UNKNOWN，常因网络/格式/权限问题），便于精准调试。
⚠️ 注意事项与常见问题排查
- HTTPS 优先：尽可能使用 HTTPS 流地址（如 https://...），避免明文流量配置，提升兼容性与安全性。
- 流协议兼容性：MediaPlayer 原生支持 HTTP Live Streaming (HLS) 和部分 Icecast/Shoutcast 流，但对某些编码（如 AAC+）或重定向链路支持有限。若持续失败，可考虑 ExoPlayer（Google 官方推荐，对流媒体支持更健壮）。
- 资源释放：实际项目中务必在 onDestroy() 或暂停时调用 mediaPlayer?.release()，防止资源泄露。
- 后台播放：若需锁屏后继续播放，需结合 Foreground Service 与 AudioManager 音频焦点管理——此为进阶需求，不在本文范围。
掌握以上配置，即可稳定播放 radio-browser.info 等平台提供的绝大多数网络电台流。记住：流 ≠ 文件，配置与线程是成功的关键。
