服务器多媒体管理器（FancyVideo）

服务端多媒体管理器（服务端）

此模组负责管理并将多媒体播放（视频和音频）广播给服务器上已连接的客户端。 它本身不渲染视觉或听觉内容，而是与世界中的玩家同步媒体状态。

功能特性

• 在平面区域（画布）上同步视频。
• 在球形点位（扬声器）同步音频。
• 为画布和扬声器提供无缝的队列和播放列表系统。
• 智能的三维音量衰减。
• 支持射线检测，便于使用准星生成和操控屏幕与扬声器。

命令（需要管理员权限）

视频命令

• /playvideo canvas spawn <pos1> [pos2] [url] [volume] [loop/repetitions] [isDual] - 生成一个新的画布。如果省略 pos2，则支持射线检测。
• /playvideo canvas set <url> [volume] [loop/repetitions] - 修改目标画布的面。
• /playvideo canvas remove - 移除目标画布。
• /playvideo canvas queue <url> - 将视频添加到目标画布的队列中。
• /playvideo canvas skip - 跳过目标画布上当前播放的视频。
• /playvideo canvas playlist - 显示目标画布的播放队列。
• /playvideo canvas clear - 清空目标画布的队列并停止播放。
• /playvideo <targets> <url> [volume] [canLeave] - 在玩家的个人界面上播放视频。

音频命令

• /playaudio speaker spawn [pos] [url] [minRadius] [maxRadius] [volume] [loop/repetitions] - 生成一个不可见的音频扬声器。如果省略位置，则支持射线检测。
• /playaudio speaker set <url> [minRadius] [maxRadius] [volume] [loop/repetitions] - 修改目标扬声器。
• /playaudio speaker remove - 移除目标扬声器。
• /playaudio speaker queue <url> - 将音频曲目添加到目标扬声器的队列中。
• /playaudio speaker skip - 跳过目标扬声器上当前播放的音频。
• /playaudio speaker playlist - 显示目标扬声器的播放队列。
• /playaudio speaker clear - 清空目标扬声器的队列并停止播放。
• /playaudio <targets> <url> [volume] - 在玩家的个人界面上播放音频。

详细命令与功能使用指南

1. 准星射线检测定位

在执行 spawn、set、remove 或队列命令时：

• 自动定位：如果在 /playvideo canvas spawn <pos1> 或 /playaudio speaker spawn 中省略坐标，第二个角或位置将自动对齐到你正在注视的精确方块或实体上。
• 方向定位：使用 /playvideo canvas set、queue 或 skip 时，直接注视画布的前面或背面会自动定位并独立修改该特定面！

2. 画布（世界内视频屏幕）

• 生成屏幕：/playvideo canvas spawn ~ ~ ~ （在你所在位置生成一个屏幕，将对角吸附到准星指向的位置）。
• 设置视频 URL：/playvideo canvas set https://example.com/video.mp4 100 0 （将视频应用于你当前注视的面，设置为 100% 音量和无限循环）。
• 视频排队：
  • /playvideo canvas queue https://example.com/video2.mp4 （将视频添加到队列末尾）。
  • /playvideo canvas skip （跳到队列中的下一个视频）。
  • /playvideo canvas playlist （显示当前播放的视频和即将播放的队列）。
  • /playvideo canvas clear （清空队列）。

3. 球形音频扬声器

• 在准星处生成扬声器：/playaudio speaker spawn （在你瞄准的位置创建一个不可见的音频扬声器）。
• 配置半径与媒体：/playaudio speaker set https://example.com/audio.mp3 5 15 100 1 （在 5 格内设置完整音量，在 15 格处平滑衰减至 0%，播放一次）。
• 音频排队：
  • /playaudio speaker queue https://example.com/song2.mp3
  • /playaudio speaker skip
  • /playaudio speaker playlist

4. 本地媒体和数据包支持

除了 HTTP/HTTPS 链接外，你还可以播放本地媒体而无需外部链接：

• 将音频文件放在 world/play/audio/<filename.mp3>
• 将视频文件放在 world/play/video/<filename.mp4>
• 在命令中直接使用文件名：/playvideo canvas set my_video.mp4 或 /playaudio speaker spawn my_song.mp3。

前置要求

• 适用于 Minecraft 1.19.2 的 Forge。
• 严格需要客户端安装配套模组 ClientMultimediaPlayer 才能实际看到和听到媒体。