通过 LSPosed 为一加、OPPO 等设备的侧边快捷键配置自定义操作。设置界面简单直观,配置会自动保存。
项目主页:SlimeNull/OppoCustomSideButtonFunctions
- 安装模块 APK,在 LSPosed 中启用“侧键功能”。
- 将 Android 系统框架(
android) 加入作用域。 - 重启设备,让系统框架加载模块。只重启 SystemUI 可能无法使侧键功能生效。
- 打开“侧键功能”,开启“启用自定义侧键功能”,选择操作模式并配置动作。
使用“小布快捷指令”时,可另外将 com.coloros.shortcuts 加入作用域。打开 ColorOS 快捷指令编辑页面时,模块会尝试复制指令 ID;这不是侧键操作本身的必需作用域。
“简单操作”和“摩斯电码操作”可以随时切换,另一种模式的配置会保留。
可以分别设置单击、双击和长按的动作。双击未设置动作时,单击会在松开后立即执行;设置了双击动作后,单击会等待第二次按下。默认双击等待时间和长按触发时间均为 300ms,可在 100~800ms 之间调整。
使用 0、1 组成指令序列:0 表示短按,1 表示长按。例如 000 表示连续三次短按,01 表示一次短按后接一次长按。每条序列都可以指定一个动作。
- 长按阈值默认 300ms,可设置为 100~800ms。
- 输入结束等待时间默认 300ms,可设置为 100~800ms。
- 开启“尽可能立即执行操作”后,已经确定不会与更长指令冲突的序列会提前执行。
- 未匹配的输入会在等待窗口结束后丢弃,避免误操作。
按键提示振动与动作执行后的振动分别设置,均可独立开启或关闭。
两种模式都支持以下动作:
- 响铃、振动、静音循环
- 免打扰
- 相机、手电筒、截屏
- 微信和支付宝快捷入口
- ColorOS 快捷功能
- 小布快捷指令
- 自定义 Activity
- Url Scheme
- Shell 指令
首页的“振动与提示”可以设置动作触发后的振动和 Toast。摩斯电码还可以单独设置未知序列提示。
“高级设置”可以修改按键码、输入设备路径,以及息屏时是否唤醒设备。默认按键码为 735,输入路径为 /dev/input/event0。
- 模块会优先适配 Oplus 的侧键实现,也会尝试 Android 系统框架和原始输入设备。不同机型、ColorOS 版本或 ROM 可能存在兼容性差异。
- 免打扰动作需要系统允许本模块修改免打扰状态。
- 截屏使用系统接口,并在部分设备上尝试其他兼容方式,实际效果取决于 ROM。
- Shell 指令在系统框架进程中通过
su执行,设备需要 Root,并允许该进程执行命令。 - 如果使用原始输入设备读取方式,修改设备路径后可能需要重启设备。
本模块使用 GNU Lesser General Public License v3.0(LGPL-3.0)许可证。
