Android Studio按钮点击音效消失问题排查及正确实现方法

错误原因 #

• 音频资源泄漏：每次点击按钮都通过MediaPlayer.create()创建新实例，但从未调用release()释放资源。Android系统的音频资源配额有限，多次创建后资源耗尽，就会出现音效无法播放的情况。
• 引用覆盖导致资源无法回收：单个lateinit var sound变量每次被新的MediaPlayer实例覆盖，旧实例失去引用，无法被垃圾回收器回收，进一步加剧资源占用。
• 未处理播放生命周期：音效播放完毕后，MediaPlayer仍持续占用系统资源，没有及时释放。

正确实现方案一：使用SoundPool（推荐） #

SoundPool专门针对短音频片段播放场景设计，适合按钮点击这类音效，资源占用更低、响应更快，还支持同时播放多个音效。

class MainActivity : AppCompatActivity() {
    private lateinit var mainView: ActivityMainBinding
    private lateinit var soundPool: SoundPool
    private var blueSoundId = 0
    private var redSoundId = 0
    private var greenSoundId = 0
    private var yellowSoundId = 0

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        mainView = ActivityMainBinding.inflate(layoutInflater)
        setContentView(mainView.root)

        // 配置音频属性，指定为游戏音效类型
        val audioAttributes = AudioAttributes.Builder()
            .setUsage(AudioAttributes.USAGE_GAME)
            .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
            .build()
        
        // 初始化SoundPool，设置最大同时播放流数量
        soundPool = SoundPool.Builder()
            .setMaxStreams(1)
            .setAudioAttributes(audioAttributes)
            .build()

        // 提前加载所有音效资源
        blueSoundId = soundPool.load(this, R.raw.blue_bt_tap_sound, 1)
        redSoundId = soundPool.load(this, R.raw.red_bt_tap_sound, 1)
        greenSoundId = soundPool.load(this, R.raw.green_bt_tap_sound, 1)
        yellowSoundId = soundPool.load(this, R.raw.yellow_bt_tap_sound, 1)

        mainView.apply {
            blueButton.setOnClickListener {
                soundPool.play(blueSoundId, 1f, 1f, 1, 0, 1f)
            }

            redButton.setOnClickListener {
                soundPool.play(redSoundId, 1f, 1f, 1, 0, 1f)
            }

            greenButton.setOnClickListener {
                soundPool.play(greenSoundId, 1f, 1f, 1, 0, 1f)
            }

            yellowButton.setOnClickListener {
                soundPool.play(yellowSoundId, 1f, 1f, 1, 0, 1f)
            }
        }
    }

    override fun onDestroy() {
        super.onDestroy()
        // 页面销毁时释放SoundPool资源
        soundPool.release()
    }
}

正确实现方案二：修复MediaPlayer的使用 #

如果坚持使用MediaPlayer，必须严格管理每个实例的生命周期，确保播放完成或出错时及时释放资源：

class MainActivity : AppCompatActivity() {
    private lateinit var mainView: ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        mainView = ActivityMainBinding.inflate(layoutInflater)
        setContentView(mainView.root)

        mainView.apply {
            blueButton.setOnClickListener {
                playSound(R.raw.blue_bt_tap_sound)
            }

            redButton.setOnClickListener {
                playSound(R.raw.red_bt_tap_sound)
            }

            greenButton.setOnClickListener {
                playSound(R.raw.green_bt_tap_sound)
            }

            yellowButton.setOnClickListener {
                playSound(R.raw.yellow_bt_tap_sound)
            }
        }
    }

    private fun playSound(resId: Int) {
        val mediaPlayer = MediaPlayer.create(this, resId)
        mediaPlayer.start()
        
        // 播放完成后立即释放资源
        mediaPlayer.setOnCompletionListener { player ->
            player.release()
        }
        
        // 播放出错时也释放资源，避免泄漏
        mediaPlayer.setOnErrorListener { player, _, _ ->
            player.release()
            true
        }
    }
}

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