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

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

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

功能特性

• 在多边形区域（画布）上同步视频。
• 在球形点（扬声器）上同步音频。
• 为画布和扬声器提供无缝的队列和播放列表系统。
• 智能的三维音量衰减。
• 支持射线投射，可轻松使用准星生成和操作屏幕与扬声器。

命令（需要操作员权限）

视频命令

• /playvideo canvas spawn <位置1> [位置2] [URL] [音量] [循环/重复次数] [是否双面] - 生成一个新的画布。省略位置2时支持射线投射。
• /playvideo canvas set <URL> [音量] [循环/重复次数] - 修改准星对准的画布表面。
• /playvideo canvas remove - 移除准星对准的画布。
• /playvideo canvas queue <URL> - 将视频添加到准星对准的画布队列中。
• /playvideo canvas skip - 跳过准星对准的画布上当前播放的视频。
• /playvideo canvas playlist - 显示准星对准的画布的播放队列。
• /playvideo canvas clear - 清空队列并停止准星对准的画布上的播放。
• /playvideo <目标> <URL> [音量] [可离开] - 在玩家的个人界面上播放视频。

音频命令

• /playaudio speaker spawn [位置] [URL] [最小半径] [最大半径] [音量] [循环/重复次数] - 生成一个不可见的音频扬声器。省略位置时支持射线投射。
• /playaudio speaker set <URL> [最小半径] [最大半径] [音量] [循环/重复次数] - 修改准星对准的扬声器。
• /playaudio speaker remove - 移除准星对准的扬声器。
• /playaudio speaker queue <URL> - 将音频曲目添加到准星对准的扬声器队列中。
• /playaudio speaker skip - 跳过准星对准的扬声器上当前播放的音频。
• /playaudio speaker playlist - 显示准星对准的扬声器的播放队列。
• /playaudio speaker clear - 清空队列并停止准星对准的扬声器上的播放。
• /playaudio <目标> <URL> [音量] - 在玩家的个人界面上播放音频。

详细命令与功能使用指南

1. 准星射线投射目标定位

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

• 自动定位：如果你在 /playvideo canvas spawn <位置1> 或 /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 URL之外，你还可以在没有外部链接的情况下播放本地媒体：

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

前置要求

• Forge 用于 Minecraft 1.20.1。
• 严格需要在客户端安装配套模组 ClientMultimediaPlayer，以便实际看到和听到媒体内容。