欢迎，RWTH大一新生：您的Stream Deck Neo入门指南

如果你正在阅读这篇文章，说明你刚刚在亚琛工业大学（RWTH Aachen）电气工程系学生会举办的欢迎活动中领取了一台 Stream Deck Neo。这台设备归你所有。本指南将介绍两项值得尝试的操作：在约五分钟内让它在你的笔记本电脑上运行；以及如果你想进一步探索，可以为其开发应用程序并发布到Elgato Marketplace，供任何人安装。

Stream Deck Neo 是一款放置在键盘旁边的小型控制器。它拥有八个 LCD 按键、两个用于在不同按键页面之间切换的触控点，以及位于中央的 LCD 信息栏，可显示时间、CPU 负载或日历中的下一项安排。

每个按键都对应一个独立的屏幕，因此您随时都能看到它的功能，并由您决定具体要执行什么操作。一个按键可以打开应用程序、执行命令、静音麦克风，或者依次触发这三项操作。它通过 USB-C 接口连接并由此供电，无需电池，也不需要电源适配器。

Stream Deck 于 2017 年诞生于直播领域，此后不断发展演变。放在学生书桌上，它就是你常用软件的快捷工具箱。

您需要：一台运行 Windows 11 或更高版本、或 macOS 13 或更高版本的笔记本电脑或台式机，以及一个空闲的 USB-C 接口。使用 Linux 系统吗？本文末尾有相关说明。

1. 安装 Stream Deck 软件

下载适用于 Windows 或 macOS 的Stream Deck。该软件免费，正是它能将按键转换为您所需的任何功能。

2. 插上电源

只需将一条 USB-C 数据线插入设备。按键随即亮起，软件会自动识别该设备。无需配对步骤，也无需创建账户。

3. 加载您的RWTH FSET个人资料

您无需从空设备开始。我们已为此激活配置好了配置文件，因此钥匙到手即可使用。

下载 RWTH FSET 配置文件 — 然后双击该文件，Stream Deck 便会自动安装该配置文件。

本指南中包含所有内容：SDK 文档、插件示例、Maker Discord、Marketplace 以及获取帮助的途径。只需各按一次，即可直接从设备上访问。这只是一个起点，并非固定的布局。其中的每个按键都可以修改、重命名或删除。

4. 融入个人风格

添加自定义按键的操作方式与此相同。软件右侧面板列出了按键的所有功能：打开网站、启动应用程序、执行热键、启动计时器、执行命令。将其中一项功能拖放到按键上，在下方面板中进行设置，然后按下该按键。这就是整个操作流程。如需完整操作指南，请参阅《Stream Deck 快速入门指南》。

八个按键听起来似乎很少。但事实并非如此，原因有二：一是“触点”功能可在页面间切换，二是切换应用程序时，配置文件会自动切换。以下是攻读工程学位的一些起点：

• 编程。构建、运行、测试、提交。A 多操作 将多个步骤串联到一个快捷键上，因此“保存、构建、运行”只需按一次键，而非三次。
• 讲座。开始录制，打开幻灯片，在没听懂的部分添加时间戳，并在进入下一部分前开始倒计时。
• 实验和项目工作。触发测量脚本、打开日志、在共享机器上的各个工具之间切换。
• 群组通话。无需先费劲寻找相应窗口，即可直接静音、开启摄像头、共享屏幕或退出通话。

一旦你为其中一种情况设计出一个合适的布局，就意味着你已经创建了一个配置文件。而有趣的部分也从这里开始。

配置文件是一种已保存的按键布局：即哪些操作分配在哪些按键上，以及相应的图标和设置。你可以为编辑器、讲座和通话分别设置不同的配置文件，并让 Stream Deck 根据当前处于焦点状态的应用程序自动在它们之间切换。

你已经有一个了：即第3步中创建的RWTH配置文件。在软件中打开它，你就能清楚地看到它的具体构成：哪个操作对应哪个按键，每个按键被配置为执行什么操作。拆解一个已经能正常工作的配置文件，是理解你能构建什么的最快途径。

配置文件可导出为单个文件，该文件可与朋友或同学分享。该文件还可发布到 Elgato Marketplace 上，这意味着您为某款特定的实验室软件或特定工具链构建的布局，任何使用相同软件或工具链的人都可以安装。

这是从使用Stream Deck 到为其发布内容所需操作最少的途径。完全不需要编写任何代码。

请记住，这不仅仅关乎 Stream Deck Neo 本身，更涉及跨多设备的整个 Stream Deck 生态系统。在开始探索 SDK 的功能之前，建议先浏览“探索 Stream Deck”页面，快速了解整体情况。

Stream Deck 除内置操作之外的所有功能，都是通过插件实现的，而用于编写插件的 SDK 是公开的，相关文档可在docs.elgato.com/sdk 上查阅。有一点需要提前说明：插件是用 TypeScript 编写的，在 Node.js 上运行，而不是你即将用整个第一学期学习的 C 和 C++。 如果你从未接触过这两种语言，那么掌握它们所需的时长只是一个周末，而非一个学期；况且，你身边的大多数开发工具本来就是用 TypeScript 编写的。编写一个可运行的插件非常简单：

1. 安装 Node.js，版本 24 或更高。
2. 从 npm 安装 Stream Deck CLI。
3. 运行 streamdeck create。向导会生成一个完整且可运行的插件。
4. 运行 `npm run watch` 并进行编辑。当设备连接时，更改内容会自动在设备上热重载。

此外，GitHub 上的插件示例都是完整的、可运行的插件，你可以克隆、运行并对其进行分析。这些示例可帮助你入门。当你深入学习时，文档将发挥重要作用。

Elgato Marketplace 是分发 Stream Deck 插件、配置文件、图标、屏保和音效库的平台。向该平台发布内容，您便成为一名 Elgato 创作者。设置只需三个步骤，且只需完成一次：

1. 请前往Maker Console并创建您的组织。
2. 签署《创客协议》。
3. 提交您的产品。所有产品在上线前都会经过审核。

您可以自行设定价格，并可免费发布作品。付费产品的分成比例为70/30。您可获得70%的收益，Elgato收取30%，款项通过Stripe Connect进行结算。免费产品不受国家限制。详细信息请参阅创作者文档。

为 Stream Deck 开发一款应用，并将其发布到 Elgato Marketplace 上。作品提交截止日期为 2027 年 12 月 1 日。

RWTH学生提交的最佳作品将获得1,000欧元奖励——可选择现金或Elgato设备，由你决定。

1. 做到

配置文件是快速入门的方式：针对特定任务的关键布局，经过导出并共享。插件的开发比听起来要简单：SDK 是开源的，附有文档，而且 GitHub 上有其他人的示例代码。

2. 发布它

将其提交至 Elgato Marketplace。就在那一刻，你便成为了一名 Elgato 创作者。

3. 请告知我们这是您的

请提交您的Marketplace链接，以便我们确认该链接来自RWTH。

截止日期：2027年12月1日

从 SDK 开始

比赛条款与细则

• 创客 Discord ——以开发插件和配置文件为生的人士，随时为您解答疑问。这是解决问题的最快途径。
• 创客文档 — 您可以发布的所有内容以及提交流程。
• 创客通讯 — SDK 发布、表单动态，以及其他创客的最新成果。我们正在策划一项专门面向学生创客的活动；该通讯将率先发布相关公告。