掌控办公室音乐的魔法：CrispyFi

在寻找一种方式来统一管理办公室的音乐播放吗？CrispyFi，一个基于Node.js的小型服务器，能与Spotify无缝集成，并通过Slack命令进行控制。它旨在在树莓派上运行，连接你的音响系统，但也可适应任何支持node-spotify和amixer（非必需）的系统。

简而言之——本地伪机器人

CrispyFi不只是一款普通的Slack集成工具，而是一个在你办公室里运行的本地服务器，可以直接访问你的声音硬件。它通过HTTP请求监听和响应，而不是像传统机器人那样直接加入聊天室。如果你从Slack发送指令，甚至会收到回复。

必要条件

要使CrispyFi工作，你需要：

1. 在树莓派上安装Node.js，这个链接可以帮你快速完成。
2. 有一个Spotify帐户。
3. 申请一个Spotify API-Key，在此处操作。

安装步骤

1. 将此仓库克隆到你选择的目录中。
2. 将你的spotify_appkey.key文件复制到安装目录。
3. 编辑config.json以符合你的需求。
4. 运行npm install。
5. 最后，执行npm start或node index。

完成了！现在，你的个性化CrispyFi实例已经准备就绪。

配置及如何工作

通过修改根目录下的config.json文件，你可以控制所有重要设置。默认情况下，CrispyFi会在8000端口监听并提供单个HTTP端点。通过POST请求该端点并提供认证令牌和命令，即可向其发出指令。

目前，支持以下触发词：

• play [Spotify URI]：无URI时恢复播放，有URI时切换至指定歌曲。
• pause：暂停播放。
• stop：停止播放并重置当前曲目。
• skip：跳过当前歌曲。
• shuffle：切换随机播放模式。
• vol [up|down|0..10]：调整音量，或设定具体值（范围是0-10，0代表静音，10代表最大音量）。
• list [command] [options]：有关播放列表的操作。
• status：显示当前播放信息、播放列表状态和是否开启随机播放。
• help：查看帮助。

如果你使用Slack集成，只需创建一个对外webhook指向http://your-crispyfi-url/handle，配置相应的触发词。

播放列表和插件

你可以使用类似命令行的方式来管理播放列表，包括添加、删除和重命名。此外，CrispyFi还提供了扩展机制，当默认命令无法满足需求时，可以通过编写插件实现自定义功能。

带着节奏前行

由于树莓派可能位于防火墙或NAT之后，或者拥有动态IP，直接将Slack的webhook与其IP关联可能会遇到困难。我们建议使用ngrok，它不仅可以绕过这些难题，还能简化Web服务的开发。当然，如果你有其他更习惯的方法，也不妨一试。

开源软件和许可证

CrispyFi建立在kilianc的ApiServer之上，内置了预编译版本的FrontierPsychiatrist的node-spotify，以及simonlast的node-persist用于持久化存储播放列表数据。所有代码遵循MIT许可，详情见licenses目录。

跟随CrispyFi的节拍

让我们一起探索音乐的无限可能，让CrispyFi成为你办公室的新成员，赋予你的空间新的活力。立即开始，掌控你团队的旋律吧！

注：本文档需使用Markdown格式阅读以获取最佳效果。