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 <Carbon/Carbon.h>
+#include <CoreFoundation/CoreFoundation.h>
+#include <map>
+
 #include "base/lazy_instance.h"
-#include "chrome/browser/extensions/global_shortcut_listener.h"
+#include "base/mac/scoped_nsobject.h"
 
 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
+// non-media key global keyboard shortcuts (eg. Command-Shift-1).
 class GlobalShortcutListenerMac : public GlobalShortcutListener {
  public:
   virtual ~GlobalShortcutListenerMac();
 
   virtual void StartListening() OVERRIDE;
   virtual void StopListening() OVERRIDE;
 
+  // Keyboard event callbacks.
+  bool OnKeyEvent(EventHotKeyID hotKeyID);
+  bool OnMediaKeyEvent(int key_code);
+
  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 functions for registering a keyboard shortcut.
+  void RegisterHotKey(const ui::Accelerator& accelerator);
+  void UnregisterHotKey(const ui::Accelerator& accelerator);
+
+  // Enable and disable the media key event tap.
+  void StartWatchingMediaKeys();
+  void StopWatchingMediaKeys();
+
+  // Convert from mac media key code to the equivalent keyboard code.
+  ui::KeyboardCode MediaKeyCodeToKeyboardCode(int keyCode);

[Robert Sesek, 2013/11/22 16:49:59]

naming: key_code

[smus, 2013/11/22 20:48:09]

Done.

+
+  // Determine if a key is a media key or not.
+  // TODO(smus): Use the one in CommandService.

[Robert Sesek, 2013/11/22 16:49:59]

What is "the one" referring to?

[Finnur, 2013/11/22 17:52:53]

Neo.

[smus, 2013/11/22 20:48:09]

No longer relevant. Switched to CommandService::IsMediaKey

+  bool IsMediaKey(const ui::Accelerator& accelerator);
+
+  // Whether or not any media keys are currently registered.
+  bool AreMediaKeysRegistered();
+
+  // Re-enable the event tap if it was disabled by a timeout.
+  void EnableTap();
+
+  // The callback for when an event tap happens.
+  static CGEventRef EventTapCallback(
+      CGEventTapProxy proxy, CGEventType type, CGEventRef event, void* refcon);
+
   // 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;
+  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_;
+
+  // Event tap for intercepting mac media keys.
+  CFMachPortRef event_tap_;
+  CFRunLoopSourceRef event_tap_source_;
+
   DISALLOW_COPY_AND_ASSIGN(GlobalShortcutListenerMac);
 };
 
 }  // namespace extensions
 
 #endif  // CHROME_BROWSER_EXTENSIONS_GLOBAL_SHORTCUT_LISTENER_MAC_H_