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 用戶端都支援所有指令：用戶端無法執行的指令會失敗並顯示訊息。