背景概述
根据 黄金形态通APP 报道，金融科技公司 Spotware Systems 于 2021 年 2 月 5 日宣布推出 cTrader Automate API 4.0，该版本包含在 cTrader Desktop 4.0 中。cTrader Automate 功能允许用户通过 cBots 和指标实现交易自动化，cBots 是可独立执行交易的自定义策略，指标则用于辅助手动交易或集成到 cBots 中提供趋势信号。此次 API 升级引入了一系列新特性，旨在优化键盘交互、绘图选择和事件处理机制。
关键要点
cTrader Automate API 4.0 的主要更新包括：
- 键盘交互改进：所有图表视图现在始终包含一个标记为活动的图表，该图表将处理所有与图表相关的热键，例如空格键打开搜索，或上下箭头键切换图表周期。
- 键盘事件处理：cBots 和指标现在可以处理键盘事件，但有一定限制。当按下单个键或带有修饰键（Ctrl、Alt、Shift）的组合键时，会触发 Chart.KeyDown 事件。但被 cTrader 视为热键的事件不会对 cBots 和指标触发。
- 自定义热键：通过 Chart.AddHotkey 方法，用户可以使用 Key 枚举或字符串（如“Ctrl + R”）为某个操作设置自定义热键。如果该热键已被 cTrader 或其他 cBot/指标使用，则返回 false。
- 多选绘图：cTrader 4.0 允许选择多个绘图。可使用 Ctrl + A 全选，按住 Ctrl 键并单击鼠标可添加或移除选择。
- 新事件模型：旧的 ObjectSelectionChanged 事件被弃用，新增 ObjectsSelectionChanged 事件，包含 ObjectsAddedToSelection 和 ObjectsRemovedFromSelection 集合。同时，ObjectAdded、ObjectUpdated 和 ObjectsRemoved 事件被弃用，新增 ObjectsAdded、ObjectsUpdated 和 ObjectsRemoved 事件，每个事件包含绘图集合，以支持批量操作。
影响解读
这些更新对开发者和交易者具有实际意义。键盘事件处理能力的增强使得 cBots 和指标能够更灵活地响应用户输入，但需注意避免与 cTrader 内置热键冲突。自定义热键方法简化了为特定操作分配快捷键的流程，提升了操作效率。多选绘图功能以及新的事件模型，使得处理批量绘图操作（如粘贴或拖动多个绘图）更加高效，开发者无需再为每个绘图单独处理事件，从而简化了代码逻辑。整体而言，API 4.0 提升了 cTrader 自动化生态的交互能力和开发体验。
关键对比
| 特性 | 旧版本 | cTrader Automate API 4.0 |
|---|---|---|
| 绘图选择 | 仅支持单选 | 支持多选（Ctrl + A 或 Ctrl + 单击） |
| 选择事件 | ObjectSelectionChanged（单个 ChartObject） | ObjectsSelectionChanged（包含添加和移除集合） |
| 对象变更事件 | ObjectAdded、ObjectUpdated、ObjectsRemoved（单个 ChartObject） | ObjectsAdded、ObjectsUpdated、ObjectsRemoved（绘图集合） |
| 键盘事件处理 | 不支持 | 支持 Chart.KeyDown 和 Chart.AddHotkey |
未来展望
Spotware Systems 表示，新版本将在被认为稳定并准备好发布到生产环境时正式推出。随着 cTrader Automate API 4.0 的引入，开发者可以构建更强大的自动化交易工具，并利用新的键盘事件和多选功能优化用户体验。未来，cTrader 平台可能会继续扩展其 API 能力，进一步降低自动化交易策略的开发门槛。
编辑总结
cTrader Automate API 4.0 是一次重要的功能升级，重点改进了键盘交互、绘图选择和事件处理机制。这些改进不仅提升了 cBots 和指标的开发灵活性，也增强了终端用户的操作效率。对于依赖 cTrader 进行自动化交易的开发者和交易者而言，及时了解并适配新 API 将有助于保持竞争力。
常见问题解答
问题：cTrader Automate API 4.0 包含在哪个版本中？
回答：cTrader Automate API 4.0 包含在 cTrader Desktop 4.0 中。
问题：cBots 和指标如何处理键盘事件？
回答：当按下单个键或带有修饰键（Ctrl、Alt、Shift）的组合键时，会触发 Chart.KeyDown 事件。但被 cTrader 视为热键的事件不会对 cBots 和指标触发。此外，可以使用 Chart.AddHotkey 方法为操作设置自定义热键。
问题：如何为操作设置自定义热键？
回答：使用 Chart.AddHotkey 方法，可以通过 Key 枚举或字符串（如“Ctrl + R”）设置热键。如果热键已被使用，则返回 false。
问题：cTrader 4.0 如何支持多选绘图？
回答：可以使用 Ctrl + A 全选绘图，或按住 Ctrl 键并单击鼠标来添加或移除选择。
问题：新的事件模型有哪些变化？
回答：旧的 ObjectSelectionChanged 事件被弃用，新增 ObjectsSelectionChanged 事件，包含 ObjectsAddedToSelection 和 ObjectsRemovedFromSelection 集合。同时，ObjectAdded、ObjectUpdated 和 ObjectsRemoved 事件被弃用，新增 ObjectsAdded、ObjectsUpdated 和 ObjectsRemoved 事件，每个事件包含绘图集合。旧事件仍可工作，但仅当存在订阅时，会为每个绘图单独触发。
