Jellyfin

Jellyfin 集成将 Macro Deck 连接到一台或多台 Jellyfin 媒体服务器，并作用于其上的会话：已登录并正在播放的 Jellyfin 应用、浏览器和电视。它不需要 Jellyfin 插件。可以使用 API 密钥登录，这样 Macro Deck 能看到并控制服务器上的所有会话；也可以使用用户名和密码登录，这样只能控制该账户有权控制的会话。

可以做什么

• 播放、暂停、停止、切换曲目、跳转到某个位置，或者向前、向后跳转若干秒。
• 设置音量、静音和取消静音，并设置客户端的随机播放和循环模式。
• 使用 播放媒体 在服务器上搜索电影、剧集、歌曲或专辑，并在设备上开始播放。
• 在 Jellyfin 客户端上显示带标题的消息。
• 在 音乐播放器 组件中显示正在播放的内容，或在 Jellyfin 会话 组件中显示服务器上的播放情况。
• 在播放开始、暂停、继续或停止时，在内容切换时，或在客户端连接时启动自动化。

一些示例设置：

• 一个控制客厅电视的 Toggle Play/Pause 按键，旁边放一个 快退 按键，用于重看最后 10 秒。
• 一个由电视的 播放已开始 触发的自动化，在 {{ event.itemType }} 为 Movie 时调暗灯光，另一个由 播放已停止 触发的自动化再把灯调亮。
• 一个使用 显示消息 在电视上显示“晚饭好了”的按键。

服务器和设备

添加的每台服务器在选择播放器的地方都会以两种形式出现。服务器名称会跟随最近播放过内容的那个会话。服务器 · 设备，例如 Home · Living Room TV，始终指向该设备，并在设备关闭时显示为未连接。Macro Deck 会在最后一次看到设备后记住它 30 天。

在 Jellyfin 10.11 及更高版本上，Macro Deck 通过 WebSocket 实时跟踪服务器。如果服务器不发送实时更新，则改为每两秒查询一次会话。服务器离线时，Macro Deck 会在后台持续重试，并在几次尝试失败后在 集成 下的 Jellyfin 页面上报告。并非每个 Jellyfin 客户端都支持所有命令：客户端无法执行的命令会失败并显示消息。