macos – 在Swift中捕获OSX媒体控制按钮

我将嵌入博客文章和最终代码,以防万一博客或Gist消失.注意：这是一篇非常长的帖子,详细介绍了如何构建类以及如何在App的委托中调用其他方法.如果您想要的只是成品(MediaApplication类),请前往底部.它位于XML和Info.plist信息之上.

首先,要从媒体键获取关键事件,您需要创建一个扩展NSApplication的类.这很简单

import Cocoa

class MediaApplication: NSApplication {
}

接下来,我们需要覆盖sendEvent()函数

override func sendEvent(event: NSEvent) {
    if (event.type == .SystemDefined && event.subtype.rawValue == 8) {
        let keyCode = ((event.data1 & 0xFFFF0000) >> 16)
        let keyFlags = (event.data1 & 0x0000FFFF)
        // Get the key state. 0xA is KeyDown,OxB is KeyUp
        let keyState = (((keyFlags & 0xFF00) >> 8)) == 0xA
        let keyRepeat = (keyFlags & 0x1)
        mediaKeyEvent(Int32(keyCodE),state: keyState,keyRepeat: Bool(keyRepeat))
    }

    super.sendEvent(event)
}

现在,我并没有假装完全理解这里发生了什么,但我认为我有一个不错的主意. NSEvent对象包含几个关键属性：type,subtype,data1和data2.类型和子类型是相当不言自明的,但data1和data2非常模糊.由于代码只使用data1,这就是我们要看的@L_673_23@.据我所知,data1包含关键事件周围的所有数据.这意味着它包含密钥代码和任何密钥标志.似乎键标志包含有关键的状态的信息(是否按下了键？键是否被释放？)以及键是否被按下并重复信号.我还猜测密钥代码和密钥标记都占用了data1中包含的一半数据,而按位操作将数据分成适当的变量.在得到我们需要的值之后,我们@L_601_11@mediaKeyEvent(),我将在稍后介绍.无论发送到我们的MediaApplication的事件是什么,我们都希望默认的NSApplication也能处理所有事件.为此,我们在函数末尾调用super.sendEvent(event).现在,我们来看看mediaKeyEvent().

func mediaKeyEvent(key: Int32,state: Bool,keyRepeat: Bool) {
    // Only send events on KeyDown. Without this check,these events will happen twice
    if (statE) {
        switch(key) {
        case NX_KEYTYPE_PLAY:
            // Do work
            break
        case NX_KEYTYPE_FAST:
            // Do work
            break
        case NX_KEYTYPE_REWIND:
            // Do work
            break
        default:
            break
        }
    }
}

事情开始变得有趣.首先,我们只想检查当状态为真时按下了什么键,在这种情况下,只要按下键就可以了.一旦我们检查了密钥,我们就会查找NX_KEYTYPE_PLAY,NX_KEYTYPE_FAST和NX_KEYTYPE_REWIND.如果它们的功能不明显,则nX_KEYTYPE_PLAY是播放/暂停键,NX_KEYTYPE_FAST是下一个键,NX_KEYTYPE_REWIND是前一个键.现在,当按下任何键时没有任何反应,所以让我们回顾一些可能的逻辑.我们将从一个简单的场景开始.

case NX_KEYTYPE_PLAY:
    print("Play")
    break

使用此代码后,当您的应用程序检测到已按下播放/暂停键时,您将看到打印到控制台的“播放”.简单吧？让我们通过调用应用程序的NSApplicationDelegate中的函数来提高效率.首先,我们假设您的NSApplicationDelegate有一个名为printmessage的函数.我们将随时修改它,因此请密切关注这些变化.它们将是次要的,但更改将影响您从mediaEventKey调用它们的方式.

func printmessage() {
    print("Hello World")
}

这是最简单的情况.调用printmessage()时,您将在控制台中看到“Hello World”.您可以通过调用NSApplicationDelegate上的performSELEctor来调用它,可以通过MediaApplication访问它. performSELEctor接受一个SELEctor,它只是NSApplicationDelegate中函数的名称.

case NX_KEYTYPE_PLAY:
    delegate!.performSELEctor("printmessage")
    break

现在,您将看到打印到控制台的“Hello World”.让我们用一个新版本的printmessage来提升参数.

func printmessage(arg: String) {
    print(arg)
}

现在的想法是,如果调用printmessage(“Hello World”),您将在控制台中看到“Hello World”.我们现在可以修改performSELEctor调用来处理传入参数.

case NX_KEYTYPE_PLAY:
    delegate!.performSELEctor("printmessage:",withObject: "Hello World")
    break

关于这一变化,有几点需要注意.首先,重要的是要注意：已添加到选择器中.这将函数名称与参数发送给委托时将其分开.如何工作并不是太重要,不能记住,但它是委托调用printmessage：“Hello World”的东西.我很确定这不是100％正确,因为它可能会使用某种对象ID,但我没有对细节进行任何广泛的挖掘.无论哪种方式,要记住的重要事情是添加：传入参数时..第二件要注意的是我们添加了一个withObject参数. withObject采用AnyObject？作为一种价值.在这种情况下,我们只传入一个String,因为这是printmessage正在寻找的.当您的应用程序检测到已按下播放/暂停键时,您仍应在控制台中看到“Hello World”.让我们看一个最终的用例：printmessage的一个版本,它不是一个参数,而是两个参数.

func printmessage(arg: String,_ arg2: String) {
    print(arg)
}

现在,如果调用printmessage(“Hello”,“World”),您将在控制台中看到“Hello World”.我们现在可以修改performSELEctor调用来处理传递两个参数.

case NX_KEYTYPE_PLAY:
    delegate!.performSELEctor("printmessage::",withObject: "Hello",withObject: "World")
    break

和以前一样,这里有两件事需要注意.首先,我们现在添加两个：到SELEctor的末尾.像以前一样,这是委托可以传递包含参数的信息.在一个非常基本的层面上,它看起来像printmessage：“Hello”：“World”,但我再次不知道它在更深层次上的真实情况.需要注意的第二件事是我们在performSELEctor调用中添加了第二个withObject参数.像以前一样,这个withObject采用AnyObject？作为一个值,我们传入一个String,因为这是printmessage想要的.当您的应用程序检测到已按下播放/暂停键时,您仍应在控制台中看到“Hello World”.

最后要注意的是performSELEctor最多只能接受两个参数.我真的很想看到Swift添加像splatTing或varargs这样的概念,这样这种限制最终会消失,但是现在只是避免尝试调用需要两个以上参数的函数.

这就是一个非常简单的MediaApplication类,只要你完成上面的所有@L_673_23@,就会打印出一些文本：

import Cocoa

class MediaApplication: NSApplication {
    override func sendEvent(event: NSEvent) {
        if (event.type == .SystemDefined && event.subtype.rawValue == 8) {
            let keyCode = ((event.data1 & 0xFFFF0000) >> 16)
            let keyFlags = (event.data1 & 0x0000FFFF)
            // Get the key state. 0xA is KeyDown,OxB is KeyUp
            let keyState = (((keyFlags & 0xFF00) >> 8)) == 0xA
            let keyRepeat = (keyFlags & 0x1)
            mediaKeyEvent(Int32(keyCodE),keyRepeat: Bool(keyRepeat))
        }

        super.sendEvent(event)
    }

    func mediaKeyEvent(key: Int32,keyRepeat: Bool) {
        // Only send events on KeyDown. Without this check,these events will happen twice
        if (statE) {
            switch(key) {
            case NX_KEYTYPE_PLAY:
                print("Play")
                break
            case NX_KEYTYPE_FAST:
                print("Next")
                break
            case NX_KEYTYPE_REWIND:
                print("Prev")
                break
            default:
                break
            }
        }
    }
}

现在,我还要补充一点,默认情况下,应用程序在运行时将使用标准的NSApplication.如果您想使用整篇文章所涉及的MediaApplication,您需要继续修改应用程序的Info.plist文件.如果您在图形视图中,它将如下所示：

否则,它看起来像这样：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<Dict>
  <key>CFBundleDevelopmentRegion</key>
  <String>en</String>
  <key>CFBundleExecutable</key>
  <String>$(EXECUTABLE_Name)</String>
  <key>CFBundleIconFile</key>
  <String></String>
  <key>CFBundlEIDentifier</key>
  <String>$(PRODUCT_BUNDLE_IDENTIFIER)</String>
  <key>CFBundleInfoDictionaryVersion</key>
  <String>6.0</String>
  <key>CFBundlename</key>
  <String>$(PRODUCt_name)</String>
  <key>CFBundlePackageType</key>
  <String>APPL</String>
  <key>CFBundleShortVersionString</key>
  <String>1.0</String>
  <key>CFBundleSignature</key>
  <String>????</String>
  <key>CFBundLeversion</key>
  <String>1</String>
  <key>LSApplicationCategoryType</key>
  <String>public.app-category.utilities</String>
  <key>LSMinimumSystemVersion</key>
  <String>$(MACOSX_DEPLOymENT_TARGET)</String>
  <key>LSUIElement</key>
  <true/>
  <key>NSHumanReadableCopyright</key>
  <String>Copyright © 2015 Chris Rees. All rights reserved.</String>
  <key>NsmainNibFile</key>
  <String>MainMenu</String>
  <key>NSPrincipalClass</key>
  <String>NSApplication</String>
</Dict>
</plist>

在任何一种情况下,您都需要更改NSPrincipalClass属性.新值将包含项目的名称,因此它将类似于Notify.MediaApplication.完成更改后,运行您的应用程序并使用这些媒体键！