一加侧键功能

通过 LSPosed 为一加、OPPO 等设备的侧边快捷键配置自定义操作。设置界面简单直观,配置会自动保存。

侧键功能设置界面预览

项目主页:SlimeNull/OppoCustomSideButtonFunctions

安装与启用

  1. 安装模块 APK,在 LSPosed 中启用“侧键功能”。
  2. Android 系统框架(android 加入作用域。
  3. 重启设备,让系统框架加载模块。只重启 SystemUI 可能无法使侧键功能生效。
  4. 打开“侧键功能”,开启“启用自定义侧键功能”,选择操作模式并配置动作。

使用“小布快捷指令”时,可另外将 com.coloros.shortcuts 加入作用域。打开 ColorOS 快捷指令编辑页面时,模块会尝试复制指令 ID;这不是侧键操作本身的必需作用域。

操作模式

“简单操作”和“摩斯电码操作”可以随时切换,另一种模式的配置会保留。

简单操作

可以分别设置单击、双击和长按的动作。双击未设置动作时,单击会在松开后立即执行;设置了双击动作后,单击会等待第二次按下。默认双击等待时间和长按触发时间均为 300ms,可在 100~800ms 之间调整。

摩斯电码操作

使用 01 组成指令序列: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)许可证。

Releases

v1.0.3

Stable

9/22/2026, 6:18:44 PM

添加音量键控制光标移动的功能


感觉要变成大杂烩了

Assets

1