android - uni-app 背景音乐播放通知栏不显示问题解决方案？

Question

各位大哥，我使用uni-app来编写一款安卓的音乐App，使用的是 uni.getBackgroundAudioManager() api创建音频对象，也就是背景音乐对象，为什么我播放歌曲 设备的通知栏没有任何显示（歌曲可以正常播放），我已经设置了 title、singer、coverImgUrl 这些属性，要怎么做通知栏才能有显示出正在播放歌曲。各位大哥给小弟支支招。

Answer 1

在 Android 开发中，系统（尤其是 Android 8.0+）会限制后台应用的网络活动以节省电量，导致 App 退到后台时网络请求和 Socket 连接中断。uni-app 基于跨平台框架，但后台服务需要原生 Android 代码实现。你已尝试前台服务但失败，可能原因包括：未正确设置前台通知、服务未启动或绑定、权限缺失、或 AndroidManifest.xml 配置错误。下面提供完整解决方案，使用前台服务（Foreground Service）保持后台运行。

解决方案步骤

1. 创建前台服务类（原生 Android 代码）：

   • 在 uni-app 项目的 nativeplugins 目录（或自定义原生模块）中添加一个 Service 类。这个服务负责处理网络请求和 Socket 连接。

   • 示例代码（Java）：

     // 文件路径: /nativeplugins/MyForegroundService.java
     import android.app.Notification;
     import android.app.NotificationChannel;
     import android.app.NotificationManager;
     import android.app.Service;
     import android.content.Intent;
     import android.os.Build;
     import android.os.IBinder;
     import android.util.Log;
     import java.net.Socket;
     import java.io.IOException;
     import java.net.UnknownHostException;
     
     public class MyForegroundService extends Service {
         private static final String CHANNEL_ID = "MyForegroundServiceChannel";
         private Socket socket; // 示例 Socket 对象
         private Thread networkThread; // 用于处理网络请求的线程
     
         @Override
         public void onCreate() {
             super.onCreate();
             createNotificationChannel();
             // 启动前台服务，必须设置一个通知
             Notification notification = new Notification.Builder(this, CHANNEL_ID)
                     .setContentTitle("App 后台运行中")
                     .setContentText("保持网络连接...")
                     .setSmallIcon(R.drawable.ic_notification) // 替换为你的通知图标
                     .build();
             startForeground(1, notification); // 关键：使服务成为前台服务
     
             // 启动网络和 Socket 逻辑
             startNetworkOperations();
         }
     
         private void createNotificationChannel() {
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                 NotificationChannel channel = new NotificationChannel(
                         CHANNEL_ID,
                         "My Foreground Service",
                         NotificationManager.IMPORTANCE_LOW
                 );
                 NotificationManager manager = getSystemService(NotificationManager.class);
                 manager.createNotificationChannel(channel);
             }
         }
     
         private void startNetworkOperations() {
             networkThread = new Thread(() -> {
                 try {
                     // 示例：建立 Socket 连接（替换为你的服务器地址和端口）
                     socket = new Socket("your.server.com", 8080);
                     // 保持连接的心跳机制，例如每 30 秒发送一次数据
                     while (!Thread.interrupted()) {
                         if (socket != null && socket.isConnected()) {
                             // 发送心跳或处理数据
                             socket.getOutputStream().write("heartbeat".getBytes());
                             Thread.sleep(30000); // 30 秒间隔
                         } else {
                             // 重连逻辑
                             reconnectSocket();
                         }
                     }
                 } catch (InterruptedException | IOException e) {
                     Log.e("MyService", "Socket error: " + e.getMessage());
                     // 错误处理：尝试重连
                     reconnectSocket();
                 }
             });
             networkThread.start();
         }
     
         private void reconnectSocket() {
             // 简单重连示例，实际中应添加重试次数限制
             try {
                 socket = new Socket("your.server.com", 8080);
             } catch (IOException e) {
                 Log.e("MyService", "Reconnect failed: " + e.getMessage());
             }
         }
     
         @Override
         public int onStartCommand(Intent intent, int flags, int startId) {
             // 服务启动时调用
             return START_STICKY; // 系统会重启服务如果被杀死
         }
     
         @Override
         public void onDestroy() {
             super.onDestroy();
             // 清理资源
             if (networkThread != null) {
                 networkThread.interrupt();
             }
             try {
                 if (socket != null) socket.close();
             } catch (IOException e) {
                 e.printStackTrace();
             }
         }
     
         @Override
         public IBinder onBind(Intent intent) {
             return null;
         }
     }

2. 配置 AndroidManifest.xml：

   • 添加服务声明和必要权限。在 uni-app 项目中，编辑 AndroidManifest.xml（路径通常为 src/main/AndroidManifest.xml）。

     <manifest xmlns:android="http://schemas.android.com/apk/res/android"
         package="your.package.name">
         <!-- 添加前台服务权限（Android 9.0+ 必须） -->
         <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
         <!-- 其他权限如网络权限 -->
         <uses-permission android:name="android.permission.INTERNET" />
         <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     
         <application>
             <!-- 声明服务 -->
             <service
                 android:name=".MyForegroundService"
                 android:enabled="true"
                 android:exported="false" />
             <!-- 其他配置... -->
         </application>
     </manifest>

3. 在 uni-app 中启动和停止服务：

   • 使用 uni-app 的 plus.android API 调用原生代码。在 App 的 Vue 组件或全局逻辑中处理。

   • 示例代码（JavaScript）：

     // 在需要的地方（如 App.vue 的 onLaunch 或页面）
     export default {
         methods: {
             startForegroundService() {
                 // 导入 Android 上下文
                 const main = plus.android.runtimeMainActivity();
                 const Context = plus.android.importClass('android.content.Context');
                 const Intent = plus.android.importClass('android.content.Intent');
                 
                 // 创建启动服务的 Intent
                 const intent = new Intent(main, plus.android.importClass('your.package.name.MyForegroundService'));
                 
                 // 根据 Android 版本启动服务（Android 8.0+ 使用 startForegroundService）
                 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                     main.startForegroundService(intent);
                 } else {
                     main.startService(intent);
                 }
                 uni.showToast({ title: '后台服务已启动', icon: 'none' });
             },
             stopForegroundService() {
                 const main = plus.android.runtimeMainActivity();
                 const Intent = plus.android.importClass('android.content.Intent');
                 const intent = new Intent(main, plus.android.importClass('your.package.name.MyForegroundService'));
                 main.stopService(intent);
                 uni.showToast({ title: '后台服务已停止', icon: 'none' });
             }
         },
         onLaunch() {
             // App 启动时自动运行服务
             this.startForegroundService();
         }
     }

4. 处理 Socket 和网络请求：

   • 在服务中维护 Socket 连接：使用心跳机制（如每 30 秒发送数据）防止超时断开。

   • 网络请求：在服务线程中使用 HTTP 库（如 OkHttp）替代 uni-app 的 uni.request，因为后者依赖主线程。

     • 示例：在服务中添加 OkHttp 依赖（在 build.gradle 中添加 implementation 'com.squareup.okhttp3:okhttp:4.9.0'），然后在 startNetworkOperations 中发起请求。
   • 错误处理：添加重连逻辑（如代码中的 reconnectSocket 方法），避免单点故障。

常见失败原因和调试建议

• 前台通知未设置：前台服务必须显示一个持续通知（Notification），否则服务会被系统杀死。检查通知图标是否有效（替换 R.drawable.ic_notification 为你的资源）。
• 权限问题：确保 AndroidManifest.xml 添加了 FOREGROUND_SERVICE 权限（Android 9.0+ 必须）。
• 服务未正确启动：在 uni-app 中，使用 plus.android.runtimeMainActivity() 获取上下文，避免空指针。测试时，在 onCreate 方法添加 Log 输出（如 Log.d("MyService", "Service started")），用 Android Studio 查看日志。
• Android 版本兼容：Android 8.0+ 需使用 startForegroundService() 而非 startService()。代码中已处理。
• 后台限制：Android 会优化后台服务，添加 START_STICKY 确保服务重启。如果问题依旧，考虑使用 WorkManager 或 AlarmManager 作为备选（但前台服务是首选）。
• uni-app 集成：确保原生代码路径正确。如果使用 HBuilderX，编译自定义原生代码需配置本地插件。
• 测试：在真机上测试（模拟器可能行为不同），检查通知栏是否显示服务运行。

备选方案

• 如果前台服务仍失败，尝试 WorkManager 或 JobScheduler 处理周期性网络任务，但实时性较差。
• 对于 Socket，使用 WebSocket 并配置心跳，uni-app 的 uni.connectSocket 在后台可能失效，优先在原生服务中实现。

如果以上步骤仍不工作，提供更多细节（如错误日志、Android 版本），我可以进一步诊断。