Android Media3：点击按钮无法停止MediaLibraryService，onDestroy未触发？

你在Activity点击按钮后尝试用两种方式停止继承自MediaLibrarySession的前台服务，但MediaLibraryService的onDestroy始终没触发，服务停不下来。你用到的代码分别是：

第一种方式：

val serviceIntent = Intent(this@PartyHostActivity, PlayerService::class.java)
stopService(serviceIntent)

第二种方式：

val serviceIntent = Intent(this@PartyHostActivity, PlayerService::class.java)
startService(serviceIntent)
stopService(serviceIntent)

核心原因分析 #

• 前台服务的优先级保护：前台服务属于系统高优先级进程，直接调用stopService()不会生效，必须先调用stopForeground(true)终止前台状态（参数true会同时移除状态栏通知），之后才能正常触发服务停止逻辑。
• MediaLibrarySession的资源绑定：MediaLibrarySession会和系统媒体服务建立持久绑定关系，不主动释放这个会话的话，系统会判定服务仍有活跃业务，不会允许销毁。必须先调用session.release()解除和系统媒体服务的关联。
• 多组件绑定未解除：如果你的服务还被其他组件（比如系统媒体控制UI、第三方应用）绑定，只有当所有绑定连接都解除，且调用停止服务的方法后，onDestroy才会被触发。

正确的停止步骤及代码示例 #

1. 在你的PlayerService中封装完整的停止逻辑方法：

class PlayerService : MediaLibraryService() {
    private var session: MediaLibrarySession? = null

    // ...其他服务初始化、会话创建逻辑

    fun stopServiceProperly() {
        // 1. 释放MediaLibrarySession资源
        session?.release()
        session = null
        // 2. 停止前台服务状态
        stopForeground(true)
        // 3. 终止服务自身
        stopSelf()
    }

    // 让Activity能调用内部方法的Binder实现
    inner class LocalBinder : Binder() {
        fun getService(): PlayerService = this@PlayerService
    }

    override fun onBind(intent: Intent): IBinder {
        return LocalBinder()
    }
}

2. 在Activity中通过绑定服务的方式调用停止方法（比直接stopService()更可靠）：

class PartyHostActivity : AppCompatActivity() {
    private var playerService: PlayerService? = null
    private var isServiceBound = false

    private val serviceConnection = object : ServiceConnection {
        override fun onServiceConnected(className: ComponentName, service: IBinder) {
            val binder = service as PlayerService.LocalBinder
            playerService = binder.getService()
            isServiceBound = true
        }

        override fun onServiceDisconnected(arg0: ComponentName) {
            isServiceBound = false
            playerService = null
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_party_host)
        // 绑定服务
        val bindIntent = Intent(this, PlayerService::class.java)
        bindService(bindIntent, serviceConnection, Context.BIND_AUTO_CREATE)

        // 按钮点击触发停止逻辑
        findViewById<Button>(R.id.stop_service_btn).setOnClickListener {
            if (isServiceBound) {
                playerService?.stopServiceProperly()
                // 解绑服务
                unbindService(serviceConnection)
                isServiceBound = false
            }
        }
    }

    override fun onDestroy() {
        super.onDestroy()
        if (isServiceBound) {
            unbindService(serviceConnection)
        }
    }
}

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