本文详解如何通过前台服务（foreground service）确保 android 13+ 应用中 webview 加载的网页音频在屏幕关闭后仍能持续播放，涵盖服务创建、webview 线程安全加载、通知配置及关键适配要点。
本文详解如何通过前台服务（foreground service）确保 android 13+ 应用中 webview 加载的网页音频在屏幕关闭后仍能持续播放，涵盖服务创建、webview 线程安全加载、通知配置及关键适配要点。
在 Android 13 及更高版本中，系统对后台执行限制显著加强，普通 Activity 或后台线程无法维持 WebView 的音频播放——一旦屏幕关闭或应用进入后台，系统会暂停或销毁 WebView 的渲染与媒体上下文，导致音频中断。唯一可靠且符合 Google Play 政策的方案是使用前台服务（Foreground Service），并配合正确的媒体生命周期管理与线程处理。
✅ 核心实现步骤
-
声明必要权限与组件
在 AndroidManifest.xml 中添加：<uses-permission android:name="android.permission.FOREGROUND_SERVICE" /> <uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> <!-- Android 13+ 必须 --> <service android:name=".AudioPlaybackService" android:exported="false" android:foregroundServiceType="mediaPlayback" />⚠️ 注意：foregroundServiceType="mediaPlayback" 是 Android 10+ 强制要求，明确声明服务用途，避免被系统误杀；Android 13 起还需动态申请 POST_NOTIFICATIONS 权限。
-
创建前台服务类
继承 Service，并在 onCreate() 中启动前台通知（必须）：class AudioPlaybackService : Service() { private lateinit var webView: WebView private val notificationId = 1001 override fun onCreate() { super.onCreate() // 创建媒体播放类通知渠道（Android 8.0+） if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { val channel = NotificationChannel( "audio_playback_channel", "Audio Playback", NotificationManager.IMPORTANCE_LOW ).apply { setShowBadge(false) } getSystemService<NotificationManager>()?.createNotificationChannel(channel) } // 启动前台服务（必须带有效通知） val intent = Intent(this, MainActivity::class.java).apply { flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK } val pendingIntent = PendingIntent.getActivity( this, 0, intent, PendingIntent.FLAG_IMMUTABLE) val notification = NotificationCompat.Builder(this, "audio_playback_channel") .setContentTitle("Audio Playing") .setContentText("WebView audio is active") .setSmallIcon(R.drawable.ic_play) .setContentIntent(pendingIntent) .setOngoing(true) .build() startForeground(notificationId, notification) } -
在 onStartCommand() 中初始化 WebView（⚠️ 关键：非 UI 线程不可直接操作 WebView）
WebView 必须运行在拥有 Looper 的线程上（如主线程），但前台服务默认在主线程运行。因此需显式创建 HandlerThread 并在其 Looper 上构建 WebView：override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int { // 启动专用 HandlerThread 托管 WebView val webThread = HandlerThread("WebViewThread").apply { start() } val handler = Handler(webThread.looper) handler.post { webView = WebView(this@AudioPlaybackService).apply { settings.apply { javaScriptEnabled = true mediaPlaybackRequiresUserGesture = false // 允许自动播放 domStorageEnabled = true setSupportMultipleWindows(true) } // 必须设置 WebViewClient，防止跳转到外部浏览器 webViewClient = WebViewClient() // 加载音频页面（示例） loadUrl("https://example.com/audio-player.html") } } return START_STICKY } -
Activity 中启动并绑定服务
// 在 MainActivity 中 private val connection = object : ServiceConnection { override fun onServiceConnected(name: ComponentName?, service: IBinder?) { // 可选：通过 Binder 提供控制接口（如 play/pause） } override fun onServiceDisconnected(name: ComponentName?) {} } private fun startAudioService() { Intent(this, AudioPlaybackService::class.java).also { intent -> if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { startForegroundService(intent) } else { startService(intent) } } bindService(Intent(this, AudioPlaybackService::class.java), connection, Context.BIND_AUTO_CREATE) }
⚠️ 重要注意事项
- WebView 不支持跨线程访问：切勿在子线程中直接调用 webView.loadUrl() 或操作 DOM；所有 WebView 操作必须在它所属的 Looper 线程（如上述 HandlerThread）中执行。
- 自动播放策略：确保网页
- 资源释放：在 onDestroy() 中务必 webView.destroy() 并 quitSafely() HandlerThread，防止内存泄漏。
- 省电优化兼容性：部分厂商 ROM（如小米、华为）会强制冻结前台服务，需引导用户手动关闭“电池优化”白名单。
通过以上结构化实现，你的 WebView 音频即可稳定运行于息屏状态，完全满足 Android 13 的后台媒体播放规范。
