Android Studio中MediaPlayer引发渲染问题的解决办法

问题根源 #

Android Studio的Compose Preview是沙盒预览环境，无法正常初始化MediaPlayer这类依赖真实Android系统服务的组件，直接在@Composable函数顶层创建MediaPlayer实例会触发渲染失败。

解决方案 #

方案1：通过预览状态判断规避初始化（推荐）

利用LocalInspectionMode.current判断当前是否处于预览环境，仅在真实运行时初始化MediaPlayer，同时配合remember和DisposableEffect管理资源生命周期：

@Composable
@Preview
fun TestScreen(){
    val context = LocalContext.current
    val isPreview = LocalInspectionMode.current
    
    // 仅在非预览环境初始化MediaPlayer
    val audio = remember {
        if (!isPreview) {
            MediaPlayer.create(context, R.raw.testaudio1).apply {
                setOnCompletionListener { release() }
            }
        } else {
            null
        }
    }

    // 组件销毁时释放MediaPlayer资源
    DisposableEffect(audio) {
        onDispose {
            audio?.release()
        }
    }

    Button(onClick = {
        // 空值判断+播放状态校验，避免异常
        audio?.takeIf { !it.isPlaying }?.start()
    }) {
        Text(text = "play")
    }
}

方案2：临时测试方案（仅用于预览）

如果只是需要让预览正常显示，可将MediaPlayer的初始化移至点击事件中（注意：此方案每次点击都会创建新实例，存在内存泄漏风险，仅适合临时测试）：

@Composable
@Preview
fun TestScreen(){
    val context = LocalContext.current
    Button(onClick = {
        val audio = MediaPlayer.create(context, R.raw.testaudio1)
        audio.start()
        // 播放完成后释放资源
        audio.setOnCompletionListener { it.release() }
    }) {
        Text(text = "play")
    }
}

额外注意事项 #

• 始终记得在MediaPlayer使用完毕后调用release()方法，避免占用系统资源导致内存泄漏。
• 若音频文件路径或资源ID错误，也可能触发渲染或运行时异常，需确保R.raw.testaudio1指向正确的MP3文件。

内容的提问来源于stack exchange，提问作者Justice Gabriel Antaputra