Companion项目中的Surface页面切换功能增强解析

背景介绍

Companion作为一个强大的控制面板管理软件，其Surface页面管理功能一直是核心特性之一。近期开发者社区提出了一个关于Surface页面切换命令的增强需求，主要针对在多设备环境下如何更灵活地控制不同Surface的页面切换。

功能现状

当前Companion的"set surface to page"命令支持两种方式指定目标Surface：

1. 通过下拉列表选择具体的Surface设备
2. 直接输入Surface的序号（如1、2、3等）

同时，页面切换的目标页码支持使用变量动态指定，这为动态控制提供了灵活性。然而，Surface的选择部分目前只能通过固定选择或直接输入数字，不支持使用变量来动态指定Surface。

用户需求场景

一个典型的应用场景是：在演播室环境中使用多台Streamdeck设备（通常称为Left、Middle、Right），但由于设备轮换使用，每次实际连接的物理设备序列号都不同。用户希望：

1. 通过简单的界面操作（如按下按钮）就能指定哪台设备对应Left/Middle/Right
2. 无需进入Companion的GUI界面进行复杂配置
3. 系统能记住这些对应关系，后续的页面切换命令能自动应用到正确的设备

技术实现方案

Companion开发团队已经在新版本中实现了以下改进：

1. 支持通过变量指定Surface序号：现在可以在"Set by index to page"动作中使用变量来动态指定Surface序号。这意味着用户可以：

   • 设置变量如Left=1、Middle=2、Right=3
   • 页面切换命令引用这些变量来确定目标Surface

2. 新增Surface组功能：作为替代方案，用户可以：

   • 创建名为"Left"、"Middle"、"Right"的Surface组
   • 将物理设备分配到这些组中
   • 页面切换命令直接引用组名而非具体设备

3. 新增this:surface_id变量：内部动作现在可以访问$(this:surface_id)，这使得：

   • 可以创建按钮将当前Surface的ID存储到自定义变量
   • 这些变量可用于后续的页面切换命令
   • 支持更复杂的逻辑，如根据当前Surface ID返回不同页面

最佳实践建议

对于需要频繁更换设备的用户环境，推荐以下工作流程：

1. 初始化设置：

   • 创建包含"Identify"按钮的特殊页面
   • 该按钮会闪烁指定序号的Surface设备
   • 操作员通过观察确定每台设备的位置

2. 变量配置：

   • 设置简单界面让操作员输入1/2/3对应Left/Middle/Right
   • 这些值存储为变量供后续命令使用

3. 页面切换：

   • 所有页面切换命令引用这些变量
   • 系统自动将命令路由到正确的物理设备

技术考量

1. 序号vs组名：

   • 序号方式更直观，适合快速配置
   • 组名方式更稳定，适合长期使用场景

2. 变量支持：

   • 新版本同时支持Surface名称和序号作为变量
   • 开发者可以根据需要选择更合适的方式

3. 扩展性：

   • 新的this:surface_id变量为更复杂的逻辑控制提供了可能
   • 可以实现基于当前设备的条件页面跳转等高级功能

总结

Companion通过这次功能增强，显著提升了在多设备环境下的易用性和灵活性。无论是通过序号变量还是新增的Surface组功能，用户都能更高效地管理复杂的设备配置。这些改进特别适合需要频繁更换硬件或多人协作的专业音视频环境，大大减少了配置工作量和出错可能性。