Android Kotlin中Service后台播放音频仅持续11秒问题排查

核心原因 #

Android 8.0（API 26）及以上版本对前台服务有强制要求：调用startForegroundService()启动服务后，必须在5秒内调用startForeground()展示一个持续的前台通知，否则系统会直接终止该服务。你提到AudioService的onStartCommand方法未完整实现，大概率是漏掉了这一步——系统在5秒后杀死服务，导致音频播放中断（剩下的几秒是MediaPlayer的缓冲播放时间）。

另外，如果onStartCommand的返回值设置不当，服务被系统回收后无法自动重启，也可能加剧这个问题，但当前的核心矛盾是前台服务的合规性要求。

解决步骤 #

1. 完善AudioService的onStartCommand方法，强制启动前台服务

必须在方法内完成通知渠道创建、通知构建、调用startForeground()这几个关键步骤，示例代码如下：

class AudioService : Service() {
    private lateinit var mediaPlayer: MediaPlayer
    private val NOTIFICATION_ID = 1001
    private val CHANNEL_ID = "BACKGROUND_AUDIO_CHANNEL"

    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        // 创建通知渠道（API 26+必填）
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                CHANNEL_ID,
                "后台音频播放",
                NotificationManager.IMPORTANCE_LOW
            ).apply {
                description = "用于显示后台音频播放状态"
            }
            val notificationManager = getSystemService(NOTIFICATION_SERVICE) as NotificationManager
            notificationManager.createNotificationChannel(channel)
        }

        // 构建前台通知
        val notification = NotificationCompat.Builder(this, CHANNEL_ID)
            .setContentTitle("音频播放中")
            .setContentText("后台持续播放")
            .setSmallIcon(R.drawable.ic_audio_player) // 必须设置纯色小图标
            .setPriority(NotificationCompat.PRIORITY_LOW)
            .build()

        // 启动前台服务，绑定通知
        startForeground(NOTIFICATION_ID, notification)

        // 初始化MediaPlayer并开始播放
        intent?.getStringExtra("AUDIO_PATH")?.let { audioPath ->
            mediaPlayer = MediaPlayer().apply {
                setDataSource(audioPath)
                prepare()
                start()
                // 播放完成后关闭前台服务并停止自身
                setOnCompletionListener {
                    stopForeground(STOP_FOREGROUND_REMOVE)
                    stopSelf()
                }
            }
        }

        // 返回START_STICKY，保证服务被系统回收后能自动重启
        return START_STICKY
    }

    override fun onDestroy() {
        super.onDestroy()
        // 释放MediaPlayer资源，避免内存泄漏
        if (::mediaPlayer.isInitialized) {
            mediaPlayer.stop()
            mediaPlayer.release()
        }
    }

    override fun onBind(intent: Intent): IBinder? = null // 无需绑定服务，返回null
}

2. 检查权限与服务注册

确保AndroidManifest.xml中已正确配置：

<!-- 前台服务权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- 注册服务 -->
<service android:name=".AudioService" />

3. 合理管理服务生命周期

• 在Activity的onStop()中启动服务时，必须调用startForegroundService()，而不是旧的startService()：

  override fun onStop() {
      super.onStop()
      val intent = Intent(this, AudioService::class.java).apply {
          putExtra("AUDIO_PATH", "你的音频文件路径")
      }
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
          startForegroundService(intent)
      } else {
          startService(intent) // 低版本兼容
      }
  }
  

• 音频播放完成后，记得调用stopForeground(STOP_FOREGROUND_REMOVE)移除通知，再调用stopSelf()关闭服务，避免不必要的资源占用。

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