Companion项目中按钮长按事件的传递机制解析

背景介绍

在Companion项目中使用Stream Deck Pedal时，开发者发现了一个关于按钮长按事件传递的特殊情况。当通过动态按钮分配功能将踏板映射到支持"持续时间组"(DURATION GROUP)的按钮时，系统能够正确处理短按操作，但长按功能却无法正常工作。

问题本质

这个问题的核心在于Companion内部的事件传递机制。当使用"INTERNAL: BUTTON: TRIGGER*"这类内部动作来模拟按钮按下时，默认情况下不会自动传递长按事件的相关信息。这导致目标按钮虽然支持长按功能，但由于触发源没有正确传递长按状态，使得长按相关的操作无法执行。

解决方案

经过项目组成员的验证，目前有两种可行的解决方案：

1. 手动配置分离的按下和释放动作

   这是官方推荐的标准解决方案。用户需要在踏板配置中分别设置：

   • 按下动作：internal: Button: Trigger press
   • 释放动作：internal: Button: Trigger release

   这种明确的分离配置能够确保长按事件被正确传递和处理。

2. 自动继承长按状态的潜在改进

   理论上，Companion可以增加一个"继承长按/释放"(INHERIT LONG PUSH/RELEASE)的功能选项，这可以通过两种方式实现：

   • 在按钮属性中添加该选项
   • 在"INTERNAL: BUTTON: TRIGGER*"动作中添加该开关

   启用此选项时，系统应自动禁用与DURATION GROUP相关的功能，以确保事件传递的一致性。不过，由于实现复杂度较高，项目组目前暂未采纳这一方案。

技术实现建议

对于需要实现类似功能的开发者，建议采用以下最佳实践：

1. 对于简单的按键映射场景，优先使用分离的按下/释放动作配置
2. 在需要动态按钮分配的复杂场景中，确保目标按钮的触发逻辑能够正确处理来自不同源的事件
3. 注意事件传递的时序问题，特别是在涉及长按判断时

总结

Companion项目中的按钮事件传递机制提供了灵活的配置选项，但在处理长按等特殊事件时需要开发者特别注意。通过理解事件传递的基本原理和采用正确的配置方法，可以确保各种按键操作都能被正确处理。虽然自动继承长按状态的方案在理论上可行，但从工程实现角度看，目前的手动配置方案已经能够满足大多数使用场景的需求。