Mac global keybindings

chrome/browser/extensions/global_shortcut_listener_mac.h

 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_EXTENSIONS_GLOBAL_SHORTCUT_LISTENER_MAC_H_
 #define CHROME_BROWSER_EXTENSIONS_GLOBAL_SHORTCUT_LISTENER_MAC_H_
 
+#include "chrome/browser/extensions/global_shortcut_listener.h"
+
+#include <map>
+#include <Carbon/Carbon.h>
+
 #include "base/lazy_instance.h"
-#include "chrome/browser/extensions/global_shortcut_listener.h"
+#include "base/mac/scoped_nsobject.h"
+
+@class GlobalShortcutListenerTap;
 
 namespace extensions {
 
 // Mac-specific implementation of the GlobalShortcutListener class that
 // listens for global shortcuts. Handles basic keyboard intercepting and
 // forwards its output to the base class for processing.
-// TODO(finnur/smus): Implement this class.
+//
+// Uses an event tap for intercepting media keys (PlayPause, NextTrack,
+// PreviousTrack). Also uses the Carbon RegisterEventHotKey API for binding to
+// global keyboard shortcuts.

[Finnur, 2013/11/19 13:10:05]

nit: Add 'other' in front of 'global' or 'non-media keys' somewhere in the mix.

[smus, 2013/11/20 04:28:51]

Done.

 class GlobalShortcutListenerMac : public GlobalShortcutListener {
  public:
   virtual ~GlobalShortcutListenerMac();
 
   virtual void StartListening() OVERRIDE;
   virtual void StopListening() OVERRIDE;
 
+  // Keyboard event callbacks.
+  bool OnKeyEvent(EventHotKeyID hotKeyID);
+  bool OnMediaKeyEvent(ui::KeyboardCode keyCode);
+
  private:
   friend struct base::DefaultLazyInstanceTraits<GlobalShortcutListenerMac>;
 
   GlobalShortcutListenerMac();
 
   // Register an |accelerator| with the particular |observer|.
   virtual void RegisterAccelerator(
       const ui::Accelerator& accelerator,
       GlobalShortcutListener::Observer* observer) OVERRIDE;
   // Unregister an |accelerator| with the particular |observer|.
   virtual void UnregisterAccelerator(
       const ui::Accelerator& accelerator,
       GlobalShortcutListener::Observer* observer) OVERRIDE;
 
+  // Mac-specific function for registering a hotkey.
+  void RegisterHotKey(const ui::Accelerator& accelerator);
+  void UnregisterHotKey(const ui::Accelerator& accelerator);
+
+  // Determine if a key is a media key or not.

[Finnur, 2013/11/19 13:10:05]

Add a TODO(smus): Use the one in CommandService.
... or something.

[smus, 2013/11/20 04:28:51]

Done.

+  bool IsMediaKey(const ui::Accelerator& accelerator);
+
   // Whether this object is listening for global shortcuts.
   bool is_listening_;
 
+  // A counter representing the current hotkey identifier.
+  int hotkey_id_ = 0;
+
+  // A map of all hotkeys (media keys and shortcuts) mapping to their
+  // corresponding hotkey IDs. For quickly finding if an accelerator is
+  // registered.
+  typedef std::map< ui::Accelerator, int > HotKeyIdMap;

[Robert Sesek, 2013/11/19 18:34:58]

nit: no space inside <>

[smus, 2013/11/20 04:28:51]

Done.

+  HotKeyIdMap hotkey_ids_;
+
+  // The inverse map for quickly looking up accelerators by hotkey id.
+  typedef std::map< int, ui::Accelerator > IdHotKeyMap;
+  IdHotKeyMap id_hotkeys_;
+
+  // Keyboard shortcut IDs to hotkeys map for unregistration.
+  typedef std::map< int, EventHotKeyRef > IdHotKeyRefMap;
+  IdHotKeyRefMap id_hotkey_refs_;
+
+  // Global shortcut listener tap used for intercepting mac media keys.
+  base::scoped_nsobject<GlobalShortcutListenerTap> tap_;
+
   DISALLOW_COPY_AND_ASSIGN(GlobalShortcutListenerMac);
 };
 
 }  // namespace extensions
 
 #endif  // CHROME_BROWSER_EXTENSIONS_GLOBAL_SHORTCUT_LISTENER_MAC_H_