audio_service Release模式下通知栏按钮不显示问题

复现特征 #

• Debug构建下应用通知栏播放控件、功能按钮显示与交互完全正常
• Release构建安装后，通知栏仅展示音频基础信息，播放/暂停、切歌等功能按钮完全消失
• 搭载Android 10系统的Oppo A15设备可稳定复现该问题

核心原因 #

1. Release构建默认开启R8代码压缩与混淆，未配置对应规则时，audio_service库中通知按钮渲染、媒体会话Action序列化相关的类会被混淆或裁剪，导致通知构造时无法正确加载按钮资源
2. Oppo ColorOS对Android 10版本的第三方应用通知存在特殊管控逻辑，未声明对应权限、未设置高通知优先级的媒体通知，会被系统自动隐藏操作按钮
3. 资源压缩开启后，通知按钮依赖的图标资源可能被误标记为无用资源被移除

修复步骤 #

1. 补充混淆与资源保留规则 #

打开app模块下的proguard-rules.pro文件，添加如下规则：

# 保留audio_service全量类不被混淆
-keep class com.ryanheise.audioservice.** { *; }
# 保留媒体会话、通知Action相关的Parcelable序列化类
-keepclassmembers class * implements android.os.Parcelable {
    public static final ** CREATOR;
}
-keep class androidx.media.app.** { *; }
-keep class android.support.v4.media.app.** { *; }

在res/raw/keep.xml路径下创建资源保留配置，避免按钮图标资源被误裁剪：

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@drawable/audio_service_*" />

检查模块级build.gradle的release构建块，确认规则文件被正确引入：

android {
    buildTypes {
        release {
            minifyEnabled true
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

2. 适配Oppo ColorOS通知管控 #

在AndroidManifest.xml中补充Oppo自定义通知权限与基础通知权限：

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="com.coloros.notification.permission.SHOW_CUSTOM_NOTIFICATION" />

初始化AudioService时，显式指定通知按钮展示配置，避免被系统判定为低优先级通知裁剪按钮：

AudioServiceConfig(
  androidNotificationChannelId: "com.yourapp.audio_playback",
  androidNotificationChannelName: "音频播放",
  androidNotificationChannelDescription: "音频播放控制通知",
  // 强制设置通知优先级为高，避免被系统折叠隐藏按钮
  androidNotificationImportance: NotificationImportance.high,
  // 显式指定紧凑模式下展示的按钮索引，覆盖Oppo系统默认裁剪逻辑
  androidCompactActionIndices: const [0, 1, 2],
  androidShowNotificationBadge: true,
)

3. 验证逻辑 #

重新打包Release安装包，安装到Oppo A15设备后，手动在系统通知设置中找到应用的音频播放通知频道，确认通知优先级设置为「高」，开启通知的所有展示权限，启动应用播放音频后即可看到通知栏功能按钮正常显示。

注：如果设备开启了省电模式、后台管控限制，需要将应用加入后台运行白名单，否则系统会在应用退到后台后重置通知权限，隐藏操作按钮。

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