TL; DR
Aqui está uma aula:
KeyManager: new Lang.Class({
Name: 'MyKeyManager',
_init: function() {
this.grabbers = new Map()
global.display.connect(
'accelerator-activated',
Lang.bind(this, function(display, action, deviceId, timestamp){
log('Accelerator Activated: [display={}, action={}, deviceId={}, timestamp={}]',
display, action, deviceId, timestamp)
this._onAccelerator(action)
}))
},
listenFor: function(accelerator, callback){
log('Trying to listen for hot key [accelerator={}]', accelerator)
let action = global.display.grab_accelerator(accelerator)
if(action == Meta.KeyBindingAction.NONE) {
log('Unable to grab accelerator [binding={}]', accelerator)
} else {
log('Grabbed accelerator [action={}]', action)
let name = Meta.external_binding_name_for_action(action)
log('Received binding name for action [name={}, action={}]',
name, action)
log('Requesting WM to allow binding [name={}]', name)
Main.wm.allowKeybinding(name, Shell.ActionMode.ALL)
this.grabbers.set(action, {
name: name,
accelerator: accelerator,
callback: callback,
action: action
})
}
},
_onAccelerator: function(action) {
let grabber = this.grabbers.get(action)
if(grabber) {
this.grabbers.get(action).callback()
} else {
log('No listeners [action={}]', action)
}
}
})
E é assim que você o usa:
let keyManager = new KeyManager()
keyManager.listenFor("<ctrl><shift>a", function(){
log("Hot keys are working!!!")
})
Você precisará de importações:
const Lang = imports.lang
const Meta = imports.gi.Meta
const Shell = imports.gi.Shell
const Main = imports.ui.main
Para parar de ouvir:
for (let it of keyManager.grabbers) {
global.display.ungrab_accelerator(it[1].action)
Main.wm.allowKeybinding(it[1].name, Shell.ActionMode.NONE)
}
Explicação
Eu posso estar terrivelmente errado, mas o que eu descobri nos últimos dias.
Em primeiro lugar, Mutter é responsável por ouvir as teclas de atalho. Mutter é uma estrutura para criar gerenciadores de janelas, não é um gerenciador de janelas. O Gnome Shell tem uma classe escrita em JS e chamada "Window Manager" - este é o gerenciador de janelas real que usa o Mutter internamente para fazer todas as coisas de baixo nível. Mutter tem um objeto MetaDisplay. Este é o objeto que você usa para solicitar a escuta de uma tecla de atalho. Mas! Mas o Mutter exigirá que o Gerenciador de Janelas aprove o uso dessa tecla de atalho. Então, o que acontece quando a tecla de atalho é pressionada? - MetaDisplay gera o evento 'filter-keybinding'. - O Gerenciador de Janelas no Gnome Shell verifica se essa tecla de atalho pode ser processada. - Gerenciador de janelas retorna o valor apropriado para o MetaDisplay - Se for permitido processar essa tecla de atalho, o MetaDisplay gerará o evento 'acelerador-ativado' - Sua extensão deve ouvir esse evento e descobrir por ID de ação qual tecla de atalho está ativada.