Ionic/Capacitor应用后台模式下vibrate振动功能失效如何解决

核心原因 #

安卓系统从6.0开始引入的电源优化、8.0开始的后台服务限制、以及高版本的应用后台权限拦截逻辑，会默认阻止后台应用访问振动硬件、执行非用户交互类的触发操作，仅前台可见、亮屏场景下的调用会被系统放行。

可落地解决方案 #

• 基础权限配置
  首先在AndroidManifest.xml中声明必要权限：

  <!-- 基础振动权限，全版本都需要 -->
  <uses-permission android:name="android.permission.VIBRATE" />
  <!-- 安卓12及以上前台服务通用权限 -->
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  <!-- 申请绕过电池优化权限（可选，按需使用） -->
  <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
  

• 使用前台服务承载振动触发逻辑
  后台场景的振动逻辑不要放在普通后台服务或者Activity上下文中执行，必须绑定到前台服务运行。启动前台服务时必须弹出可见的常驻通知，让系统判定该应用正在执行用户可感知的前台任务，此时调用vibrator.vibrate()不会被拦截。
• 绕过电池优化限制
  对于依赖实时后台触发的场景，可以引导用户手动将应用加入系统电池优化白名单，调用以下代码跳转设置页面引导用户授权：

  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
      Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
      intent.setData(Uri.parse("package:" + getPackageName()));
      startActivity(intent);
  }
  

  注：该权限如果用于Google Play上架的应用，需要符合Google Play的权限使用规范，否则可能被驳回
• 高版本系统兼容处理
  安卓10（API 29）及以上系统禁止后台应用直接访问振动器，此时可以通过触发高优先级通知附带振动效果的方式实现需求：创建通知渠道时设置振动属性，后台场景下弹出通知即可同步触发系统层面的振动，不需要单独调用振动器API，不受后台权限限制。
  示例代码片段：

  // 创建通知渠道（安卓8.0及以上需要）
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
      NotificationChannel channel = new NotificationChannel("alert_channel", "提醒通知", NotificationManager.IMPORTANCE_HIGH);
      channel.enableVibration(true);
      channel.setVibrationPattern(new long[]{0, 500, 200, 500});
      notificationManager.createNotificationChannel(channel);
  }
  // 后台需要振动时，发送对应渠道的通知即可自动触发振动
  

• 定制ROM特殊处理
  小米、华为、OPPO等国产厂商定制系统有额外的后台权限管控，除了上述通用配置外，需要引导用户手动开启「后台弹出界面」「允许后台活动」「熄屏后允许运行」等厂商定制权限，否则即使有系统通用权限也会被厂商层面拦截。

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