plugins
Global Shortcut
查看 Markdown注册与注销系统级快捷键。
注册与注销系统级快捷键。
globalShortcut 只声明前端调用和协议边界；全局按键注册依赖原生窗口消息循环，宿主要是
没有实现 RegisterGlobalShortcut / UnregisterGlobalShortcut，命令不会生效。
| 方法 | 协议命令 | Windows | Android |
|---|---|---|---|
KSM.globalShortcut.register({ shortcut }) | globalShortcut.register | 支持 | 不支持 |
KSM.globalShortcut.unregister({ shortcut }) | globalShortcut.unregister | 支持 | 不支持 |
Android 调用这些命令返回 NOT_SUPPORTED。
shortcut 是宿主约定的快捷键描述字符串，例如 "Ctrl+Shift+K"。格式由宿主决定，
前端只做非空校验。
register 返回 { registered: boolean }，unregister 返回
{ unregistered: boolean }。
import { KSM } from 'kasumi-bridge';
const { registered } = await KSM.globalShortcut.register({
shortcut: 'Ctrl+Shift+K'
});
if (!registered) {
console.warn('The shortcut could not be registered.');
}false，不会真正占用系统热键。RegisterGlobalShortcut，并在窗口销毁时注销。shortcut 为空字符串：INVALID_ARGS。NOT_SUPPORTED。{ registered: false }，不能抛 IO_ERROR 伪装成功。| 现象 | 优先检查 |
|---|---|
返回 false | 快捷键格式、注册热键冲突、宿主是否实现 |
Android 返回 NOT_SUPPORTED | 这是预期行为，不是故障 |
评论