Jellium Desktop循环播放插件：添加高级循环选项

【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop

Jellium Desktop是一款非官方的Jellyfin桌面客户端，为用户提供了丰富的媒体播放体验。本文将详细介绍如何为Jellium Desktop添加高级循环选项，让用户能够更灵活地控制媒体播放方式。

了解Jellium Desktop的播放核心

Jellium Desktop的媒体播放功能主要依赖于MPV播放器，相关实现位于src/mpv/目录下。MPV是一个功能强大的开源媒体播放器，支持各种高级播放功能，包括循环播放。

在Jellium Desktop中，MPV的事件处理通过事件循环实现。src/mpv/src/event_loop.rs文件定义了MPV事件循环的实现，负责接收和处理来自MPV的各种事件。

循环播放功能的实现基础

循环播放功能的核心在于控制MPV的播放行为。MPV提供了循环播放的API，Jellium Desktop可以通过发送命令来控制这一功能。相关的命令发送逻辑可以在src/mpv/src/command.rs中找到。

Jellium Desktop的播放协调器位于src/playback/src/coordinator.rs，它负责协调各种播放相关的操作，包括处理MPV事件和发送播放控制命令。

添加高级循环选项的步骤

1. 扩展MPV命令封装

首先，需要在MPV命令封装中添加对循环播放模式的支持。在src/mpv/src/command.rs中，可以添加如下命令：

pub fn set_loop(handle: &MpvHandle, loop_mode: i32) -> Result<(), MpvError> { let cmd = vec!["set_property".to_string(), "loop".to_string(), loop_mode.to_string()]; handle.command(&cmd) }

这里的loop_mode可以取不同的值，0表示不循环，1表示单曲循环，-1表示列表循环。

2. 添加播放控制接口

接下来，在播放协调器中添加设置循环模式的接口。在src/playback/src/coordinator.rs中添加：

pub fn set_loop_mode(&mut self, loop_mode: i32) { if let Some(mpv) = &self.mpv { let _ = mpv::command::set_loop(mpv, loop_mode); } self.state.loop_mode = loop_mode; }

3. 实现前端UI控制

最后，需要在前端界面中添加循环模式控制的UI元素。这可以在src/web/overlay.js中实现，添加循环模式切换按钮，并通过JavaScript与后端交互：

function setupLoopControls() { const loopButton = document.createElement('button'); loopButton.className = 'control-btn loop-btn'; loopButton.innerHTML = '🔁'; loopButton.title = '循环模式'; let loopMode = 0; // 0: 不循环, 1: 单曲循环, -1: 列表循环 loopButton.addEventListener('click', () => { loopMode = (loopMode + 1) % 3 - 1; // 循环切换三种模式 updateLoopButton(); nativeApi.setLoopMode(loopMode); }); function updateLoopButton() { switch(loopMode) { case 0: loopButton.innerHTML = '🔁'; loopButton.title = '不循环'; break; case 1: loopButton.innerHTML = '🔂'; loopButton.title = '单曲循环'; break; case -1: loopButton.innerHTML = '🔄'; loopButton.title = '列表循环'; break; } } document.querySelector('.controls').appendChild(loopButton); }

测试和验证

添加完高级循环选项后，需要进行充分的测试。可以通过以下步骤验证功能：

1. 启动Jellium Desktop，播放一个媒体文件
2. 点击新添加的循环模式按钮，切换不同的循环模式
3. 验证媒体播放行为是否符合预期：
   • 不循环模式：播放结束后停止
   • 单曲循环模式：当前文件反复播放
   • 列表循环模式：播放完所有文件后从头开始

总结

通过以上步骤，我们成功为Jellium Desktop添加了高级循环选项，提升了用户的媒体播放体验。这一功能的实现涉及到MPV命令封装、播放协调器接口扩展和前端UI实现等多个方面，展示了Jellium Desktop的模块化设计和扩展性。

未来，我们可以进一步扩展这一功能，比如添加记住每个播放列表的循环模式偏好，或者实现更复杂的循环逻辑，如随机循环等。Jellium Desktop的开源特性使得这些改进可以由社区共同参与和实现。

【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop