是否可安全自定义设置CGEvent的eventSourceUserData字段值？

背景与使用场景 #

我们在CFRunLoop上部署并运行了一个CGEventTap。处理接收到的事件时，有时需要发送多个新事件而非修改当前事件——比如收到按下'a'的按键事件时，发送2次按下'b'和抬起'b'的事件，期望输出为'abb'。

但我们不希望自己发送的'b'事件回流到CGEventTap中：如果回流，且后续设置了“收到'b'事件时发送2次'c'事件”的规则，最终输出会变成'abccbcc'，不符合预期。

我们的解决方案思路是：给发送的'b'事件的eventSourceUserData字段设置一个魔术数字，当CGEventTap接收到事件时，检查该字段的值，若匹配魔术数字则将事件置空。

伪代码示例：

tap = CGEventTap(..., function(event) {
  if (event.eventSourceUserData == MAGIC) {
    event.setType(NULL)
    return
  }
  
  if (event.getType() == KEYDOWN && event.getKeycode() == 'a') {
    eventBDown = createEvent(KEYDOWN, 'b').withEventSourceUserData(MAGIC)
    eventBUp = createEvent(KEYUP, 'b').withEventSourceUserData(MAGIC)
    
    loop twice {
      eventBDown.post()
      eventBUp.post()
    }
  }
})

CFRunLoop.runWithTap(tap)

结论与分析 #

完全可以安全地为eventSourceUserData设置任意自定义整数值，这正是该字段的设计用途：

• eventSourceUserData属于CGEventFields中专门留给开发者的自定义数据字段，系统本身不会依赖这个字段的值处理事件，也不会对其取值做限制（只要是合法的整数值）。
• 在你的场景中，用它标记自发送的事件并在Tap中过滤，是合理且安全的实现方式：系统不会因为这个字段的自定义值改变事件的正常处理逻辑，也不会影响其他应用或系统组件对事件的处理（其他程序通常不会读取或依赖这个字段）。

从Core Graphics的设计逻辑来看，这类带UserData后缀的字段，核心作用就是让开发者在事件传递中携带私有标记或数据，不存在设置任意值导致系统异常的风险，你的伪代码思路是正确的，可以放心使用。

内容的提问来源于stack exchange，提问作者Josh Leeb-du Toit