如何在基于LineageOS 20的自定义Android系统导航栏添加音量键

1. 定位导航栏核心文件 #

LineageOS 20基于Android 13，导航栏的布局和逻辑主要在以下两个文件：

• 布局XML：frameworks/base/packages/SystemUI/res/layout/navigation_bar.xml
• 逻辑控制类：frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/phone/NavigationBarInflaterView.java

2. 修改导航栏布局XML #

打开navigation_bar.xml，在现有导航按钮（返回、主页、多任务）的容器中，插入音量加减按钮的布局块：

<!-- 在导航按钮组末尾添加音量按钮 -->
<LinearLayout
    android:id="@+id/volume_control_group"
    android:layout_width="wrap_content"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:gravity="center"
    android:paddingHorizontal="8dp">

    <ImageView
        android:id="@+id/btn_volume_up"
        android:layout_width="24dp"
        android:layout_height="24dp"
        android:src="@drawable/ic_volume_up"
        android:contentDescription="@string/accessibility_volume_up"
        android:padding="8dp"/>

    <ImageView
        android:id="@+id/btn_volume_down"
        android:layout_width="24dp"
        android:layout_height="24dp"
        android:src="@drawable/ic_volume_down"
        android:contentDescription="@string/accessibility_volume_down"
        android:padding="8dp"/>
</LinearLayout>

• 图标用系统自带的ic_volume_up/ic_volume_down，如果没有可自行添加矢量图到SystemUI的drawable目录
• 调整padding和尺寸适配平板导航栏大小

3. 绑定按钮点击事件 #

打开NavigationBarInflaterView.java，在inflateLayout方法末尾添加按钮初始化和逻辑：

// 初始化音量按钮
ImageView volumeUp = mView.findViewById(R.id.btn_volume_up);
ImageView volumeDown = mView.findViewById(R.id.btn_volume_down);

// 绑定音量加事件
volumeUp.setOnClickListener(v -> {
    AudioManager audioManager = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);
    audioManager.adjustStreamVolume(AudioManager.STREAM_MUSIC, 
        AudioManager.ADJUST_RAISE, AudioManager.FLAG_SHOW_UI);
});

// 绑定音量减事件
volumeDown.setOnClickListener(v -> {
    AudioManager audioManager = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);
    audioManager.adjustStreamVolume(AudioManager.STREAM_MUSIC, 
        AudioManager.ADJUST_LOWER, AudioManager.FLAG_SHOW_UI);
});

• 指定STREAM_MUSIC适配车载音响场景，如需控制通话音量可替换为STREAM_VOICE_CALL
• FLAG_SHOW_UI会弹出系统音量调节提示，不需要可移除

4. 确保全局显示（解决应用兼容性） #

部分应用会启用沉浸式模式隐藏导航栏，需修改导航栏可见性逻辑：
打开frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/phone/NavigationBarController.java，找到updateNavigationBarVisibility方法，添加强制显示逻辑：

// 在方法开头添加，强制导航栏保持可见（可根据需求添加白名单排除特定应用）
mNavigationBarView.setVisibility(View.VISIBLE);
mNavigationBarView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_VISIBLE);

如果需要保留少数应用的沉浸式，可通过包名判断添加例外：

String pkgName = mContext.getPackageManager().getNameForUid(mCurrentUserId);
if (!"com.some.fullscreen.app".equals(pkgName)) {
    mNavigationBarView.setVisibility(View.VISIBLE);
}

5. 编译与测试 #

• 进入LineageOS编译环境，执行cd frameworks/base/packages/SystemUI && mm编译SystemUI模块
• 将编译生成的SystemUI.apk替换到设备/system/priv-app/SystemUI/目录，重启设备
• 测试Agama启动器及常用应用，确认音量按钮正常显示且功能可用

额外优化 #

• 添加长按快速增减逻辑：

// 给音量按钮绑定长按事件
volumeUp.setOnLongClickListener(v -> {
    AudioManager audioManager = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);
    Handler handler = new Handler();
    Runnable repeatRaise = new Runnable() {
        @Override
        public void run() {
            audioManager.adjustStreamVolume(AudioManager.STREAM_MUSIC, 
                AudioManager.ADJUST_RAISE, AudioManager.FLAG_PLAY_SOUND);
            handler.postDelayed(this, 100);
        }
    };
    handler.postDelayed(repeatRaise, 300);
    return true;
});

• 横屏适配：在navigation_bar_land.xml中添加同样的音量按钮布局，调整为横向排列

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