WATERMeDIA: Multimedia API

📕 ОБЗОР

WATERMeDIA — это мультимедийная библиотека с хорошо продуманным API: она воспроизводит видео, музыку, прямые трансляции, изображения и анимации, а также декодирует и кодирует их, выполняет рендеринг с помощью OpenGL и Vulkan и воспроизводит звук через OpenAL. Изображения проходят через наши собственные декодеры на чистом Java, а все остальное — через FFmpeg, включенный в сопутствующий мод. WATERMeDIA: Бинарные файлы. Ничего компилировать или установите, просто подключите и играйте.

Поддерживает Forge, NeoForge и Fabric во всех версиях Minecraft от 1.18.2 до 26.2, работающих на Java 17 или новее. на клиентах и выделенных серверах. Он также работает вне Minecraft: открытие jar запускает полноценный медиаплеер и любое Java-приложение может встроить API.

🛠️ ОСОБЕННОСТИ

* Зависит от используемого вами мода и работает только тогда, когда его подключил разработчик. Спросите его автора.

• 🎬 Видео и музыка воспроизводятся с помощью FFmpeg 9, входящего в состав WATERMeDIA: Binaries для Windows (x64), Linux (x64, ARM64) и macOS (Intel, Apple Silicon)

• 🖼️ Наши собственные декодеры изображений на чистом Java: PNG, APNG, JPEG, GIF, WebP (также с анимацией), SVG и Netpbm. Безопасно дизайн, они используют гораздо меньше процессора и видеопамяти, и многие анимации могут воспроизводиться одновременно, не тормозя игру.

• ⚡ Аппаратное декодирование видео на NVIDIA, AMD, Intel и macOS с возможностью возврата к программному обеспечению в случае проблем с графическим процессором.

• 🌋 Рендеринг Vulkan рядом с OpenGL, готовый для Minecraft 26.x. На Vulkan декодируются и декодируются видео H.264, H.265 и AV1. рисуйте прямо на графическом процессоре, никогда не затрагивая оперативную память

• 🌈 HDR и 10, 12 и 16-битные видео выглядят естественно на обычных экранах, и каждое видео сохраняет свои настоящие цвета, от старые клипы SD в широкоцветные видео и записи с телефона или веб-камеры

• 💾 Дисковый кэш для видео и изображений: быстрая и надежная загрузка, экономящая трафик

• 📡 Прямые трансляции (HLS и DASH) и плейлисты IPTV, которые открываются в виде списка каналов.

• 🌐 Поддержка популярных онлайн-платформ (YouTube, Twitch, Kick, BiliBili, TikTok, Twitter (X) и других), с меры безопасности для контента для взрослых, если платформа предоставляет его

• 🖥️ Работает на выделенных серверах. Устанавливайте его туда только тогда, когда мод, использующий WATERMeDIA, требует его на стороне сервера; это предоставляет дополнительный файловый сервер, который передает загруженные медиафайлы игрокам через ссылки water://remote/.

• 🗣️ Видео с отдельной звуковой дорожкой воспроизводятся синхронно, открывая более высокое качество на таких платформах, как YouTube. Дублированный видео воспроизводятся на исходном языке или на том, который вы предпочитаете, и вы можете переключать языки во время просмотра*

• 🎚️ Выбирайте качество, меняйте скорость, осуществляйте точный поиск, зацикливайте и уменьшайте разрешение удаленных экранов для сохранения. видеопамять*

• 🔊 Позиционный звук, который затухает с расстоянием. Стереоэкраны могут воспроизводить каждую сторону со своего края и многое другое. динамики могут воспроизводить звук с экрана где угодно, не загружая его дважды*

• ⏱️ Синхронизированное воспроизведение через часы сервера, поэтому все смотрят один и тот же момент*

• 🔍 Поиск видео по ключевым словам на YouTube, Twitch, Kick и Imgur*

• 🎥 Записывайте видео со звуком в форматы MP4, MOV, MKV, WebM и Ogg, а также сохраняйте изображения и анимацию в форматах PNG, APNG и GIF (экспериментально)*

• 🔒 HTTPS-носитель проверяет сертификаты, а токены, пароли и данные для входа никогда не попадают в логи

🌐 ПОДДЕРЖИВАЕМЫЕ ПЛАТФОРМЫ

• 📺 YouTube, Twitch, Kick, БилиБили, Odysee, D.Tube, VidLii
• 🐦 Twitter (X), Bluesky, TikTok, Facebook, Instagram
• 🎵 SoundCloud, Newgrounds (кино, музыка и искусство)
• 🖼️ Imgur, Lightshot, Medal, Streamable, Sendvid
• 📁 Google Диск, Dropbox, MediaFire
• 🔞 PornHub (только если в настройках разрешен контент для взрослых)
• 🔗 Прямые ссылки на любое видео, музыку, изображения или плейлисты, локальные файлы и water:// ресурсы.

YouTube, SoundCloud, Facebook и Instagram воспроизводятся через yt-dlp, для которого требуется WATERMeDIA: Binaries. БилиБили воспроизводится в разрешении до 1080p (8K с VIP), если вы добавите файл cookie сеанса в настройках; без него до 480р.

🧩 МОДЫ С ИСПОЛЬЗОВАНИЕМ WATERMeDIA

Мод	Автор	Ссылка
🖼️ WaterFrames	SrRapero720	CurseForge
📺 WaterVision	SrRapero720	CurseForge
🧱 FancyMenu	Кексуччино	CurseForge
🖼️ LittlePictureFrames	CreativeMD	CurseForge
🏺 Vista	МехВахдДжукаар	CurseForge
⏪ WaterFrames: Backported Edition	Toshayo	CurseForge
📽️ Голографические рендереры	Mysticpasta1	CurseForge
📽️ BBS CML Edition	McHorse	CurseForge
💻 Условные видео	MateoF024	CurseForge
⏯️ Owleaf PlayBack	Owleaf_Studio	CurseForge

🏅 Особые упоминания

• Видеоплеер (не поддерживается)

📦 WATERMeDIA: Двоичные файлы

В сопутствующем моде включены встроенные файлы FFmpeg и несколько дополнительных общих библиотек. WATERMeDIA: Бинарные файлы. Его истоки живут в этот репозиторий под binaries/.

• Для клиентов Minecraft требуются двоичные файлы, и оба мода должны быть версии 3.0.
• Выделенные серверы могут пропустить это. CurseForge и Modrinth перечисляют его как необходимый, поскольку их зависимости не могут выражать условия клиент/сервер, поэтому установщики могут добавлять их и на серверы
• Приложения, в которых реализован Java API, могут работать без него, сохраняя поддержку изображений, но теряя декодирование видео и платформы, поддерживаемые yt-dlp

⧈166 ⧉Linux⧈17 8⧉ ✅⧈1 90⧉ ✅

Архитектура	Windows	macOS	Android
x86_64	✅	✅	⛔
aarch64	⛔	✅	⛔

🎮 СОЗДАЙТЕ СВОЙ СЕРВЕР ПО НИЗКИМ ЦЕНАМ

KineticHosting, наши партнеры по хостинговым решениям, отлично подходят для создания сервера и обмена мультимедиа с вашим друзьям со всеми модами, перечисленными выше.

⁉️ Часто задаваемые вопросы

• ¿работает ли WATERMeDIA на серверах?
  • Да, начиная с версии 3.0 загружается на выделенных серверах. WATERMeDIA: Двоичные файлы здесь необязательны
• ¿Мне все еще нужен VLC?
  • Нет. VLC был заменен на FFmpeg, входящий в состав WATERMeDIA: Binaries, и удаление VLC безопасно
• ¿Почему видео заикается?
  • Отключите аппаратное декодирование в config/watermedia.toml
• ¿Могу ли я использовать свой собственный FFmpeg?
  • Да, FFmpeg можно отключить или заменить на свою совместимую сборку в настройках
• ¿Почему некоторые видео заблокированы?
  • Содержимое для взрослых по умолчанию блокируется, и сайт может быть исключен из белого или черного списка; см. ДЛЯ ПОЛЬЗОВАТЕЛЕЙ
• ¿Почему игра останавливается при запуске с помощью TLauncher?
  • TLauncher не поддерживается, игра останавливается при его обнаружении
• ¿Где я могу сообщить об ошибках?
  • При Проблемах GitHub или Discord)

🙋 ДЛЯ ПОЛЬЗОВАТЕЛЕЙ

WATERMeDIA хранит свои настройки в config/watermedia.toml внутри папки с игрой (или папки вашего сервера на выделенный сервер). Он создается при первом запуске с комментарием над каждым полем. Редактируйте его, пока игра закрыто, и ваши изменения вступят в силу при следующем запуске. Каждое имя ниже представляет собой [section] плюс поле: player.cacheBudget — это cacheBudget под [player].

📤 ВКЛЮЧИТЬ ФАЙЛОВЫЙ СЕРВЕР

Файловый сервер позволяет игрокам загружать свои собственные видео, музыку и изображения на ваш сервер Minecraft и делиться ими. со всеми через water://remote/ ссылки, без внешнего хостинга. Требуется WATERMeDIA на сервере и мод. который предлагает загрузки.

1. На сервере установите эти поля в config/watermedia.toml, указав общедоступный IP-адрес или домен вашего сервера в remoteUrl:

   [network]
     server = "DEDICATED"
     serverBindAddress = "0.0.0.0"
     serverPort = 25572
     remoteUrl = "http://play.example.com:25572/"
     token = "a-long-secret-only-you-know"
   

2. Откройте этот порт (TCP) в брандмауэре или на панели хоста; WATERMeDIA не откроет его для вас.
3. Скопируйте одинаковые remoteUrl и token в config/watermedia.toml каждого игрока. Модпаки могут отправить его.

• Сервер не запустится для внешних игроков, пока token сохраняет значение по умолчанию. Меняйте его на каждом сервере обновите, чтобы посторонние не могли загружать файлы.
• Каждая загрузка может весить до 8 МБ (maxUploadSize, 0 означает отсутствие ограничений), а все вместе — до 1024 МБ. (maxStorageSize).
• Загруженные файлы попадают в watermedia/files внутри папки сервера; удалите их там, чтобы освободить место.
• Он говорит по простому HTTP, поэтому поместите его за своим собственным HTTPS-прокси, когда он выходит в Интернет.
• server = "ALWAYS" также запускает его из вашей игры для миров, которые вы размещаете сами.

🖥️ АВТОНОМНОЕ ПРИЛОЖЕНИЕ

Банка WATERMeDIA также является настольным медиаплеером. Если установлена Java 17 или новее, дважды щелкните ее или запустите. java -jar watermedia-<version>.jar с терминала.

• Воспроизвести мультимедиа открывает любую ссылку или путь к файлу или выполняет поиск по ключевому слову. В образцах плиток проверяются ссылки из каждого поддерживаемая платформа, а Телевидение открывает прямые телеканалы по регионам.
• Храните WATERMeDIA: Binaries в одной папке для воспроизведения видео и музыки; без него только картинки и анимация играть.
• При первом запуске загружается несколько библиотек, поэтому на этот раз требуется Интернет.
• Он рисует с помощью Vulkan и возвращается к OpenGL, когда Vulkan терпит неудачу. Напишите engine=OPENGL в config/app.properties. всегда использовать OpenGL.
• Очистка кеша очищает медиакеш, тот же, который используется в вашей игре.

🐞ОТЧЕТЫ И ЖУРНАЛЫ ОБ ОШИБКАХ

Что-то сломалось в вашей игре? Откройте приложение из папки Minecraft mods и выберите Загрузить журналы (U):

1. Он находит ваш latest.log, самый новый отчет о сбое и самый новый файл сбоя JVM (hs_err_pid).
2. Он скрывает токены, пароли и данные для входа, а затем загружает файлы в mclo.gs.
3. Копирует готовый отчет в буфер обмена. Выберите, куда его отправить: WATERMeDIA или мод, который вы подозреваете. (FancyMenu, WaterFrames, WaterVision или LittleFrames, если они установлены) и вставьте его на страницу задачи, открывается.

Файлы размером более 10 МБ или 25 000 строк не загружаются, поэтому делитесь ими вручную. Вы всегда можете отправить logs/latest.log и crash-reports из папки с игрой на GitHub Issues или Дискорд.

💾 НАСТРОЙКА РАЗМЕРА КЕША

Загруженные видео и изображения остаются на диске, поэтому в следующий раз они загружаются быстрее и экономят трафик. Они живут в watermedia/cache во временной папке вашей системы (%TEMP% в Windows, /tmp в Linux) и удалите его. пока игра закрыта, безопасно.

• player.cacheBudget: дисковое пространство для всего кэша, в МБ (по умолчанию 8192). Когда он заполнится, самые старые файлы уйти первым.
• codecs.ffmpeg.cacheMaxResponse: самый большой видео- или музыкальный файл, который он хранит, в МБ (по умолчанию 10). Большие файлы стримить каждый раз.
• player.watertx.cache и codecs.ffmpeg.cache: установите для них значение false, чтобы прекратить кэширование изображений или видео.
• player.watertx.texturesBudget: видеопамять для плавной анимации, в МБ (по умолчанию 32). Установите его на 0, когда ваш Графическому процессору не хватает видеопамяти.

🚦 БЕЛЫЙ СПИСОК, ЧЕРНЫЙ СПИСОК И КОНТЕНТ ДЛЯ ВЗРОСЛЫХ

Выберите, на каких сайтах можно играть под [platforms]:

[platforms]
  allowMatureContent = false
  whitelist = ["youtube.com", "imgur.com"]
  blacklist = ["example.com"]

• whitelist: когда в списке указаны какие-либо сайты, воспроизводятся только ссылки с этих сайтов. Пусто, по умолчанию, позволяет играть на всех сайтах.
• blacklist: ссылки с этих сайтов никогда не воспроизводятся.
• Оба принимают только имена хостов, например website.com: нет https://, пути или *.
• website.com охватывает весь сайт, включая субдомены (some.website.com, another.website.com), а some.website.com охватывает только этот поддомен и никогда не website.com.
• allowMatureContent: видео и потоки для взрослых остаются заблокированными, пока вы не установите значение true. Это работает там, где платформа помечает их, например Kick, Twitch или Twitter (X), и PornHub вообще нуждается в этом для воспроизведения.

💻 ДЛЯ РАЗРАБОТЧИКОВ

Эту работу выполняют два класса: MRL (Расположение мультимедийного ресурса) разбирает ссылку на ее источники, качества и метаданные, а MediaPlayer воспроизводит их через выбранные вами движки (GLEngine, VKEngine, ALEngine и другие).

MRL mrl = PlayerAPI.mrl(URI.create("https://imgur.com/gallery/snow-ducks-YcDd9x"));

// IN A TICK-LOOP METHOD
if (mrl.status() == MRL.Status.LOADED) {
    MediaPlayer player = PlayerAPI.player(mrl,
            () -> PlayerAPI.glEngine(renderThread, renderExecutor),
            () -> PlayerAPI.alEngine());
}

• PlayerAPI: воспроизведение и отображение мультимедиа.
• PlatformAPI: поддержка веб-платформы для загрузки и поиска мультимедиа.
• NetworkAPI: хост и удаленное хранилище для частных медиафайлов.
• CodecsAPI (экспериментальный, пока не используйте его в своих модах): наши собственные кодеки изображений и анимации, а также Аудио и видео с поддержкой FFmpeg

Полное руководство по API находится на wiki в Английский, Испанский (Мексика), Испанский (Аргентина), Португалия (Бразилия), Русский и 简体中文. Артефакты включены ДжитПак.

💰 ПОЖЕРТВОВАНИЯ

Благодарим вас за использование WATERMeDIA! 🫶 Каждое пожертвование, большое или маленькое, помогает нам сохранять его бесплатным, обновлять и расти вместе с каждую новую версию Майнкрафта.

Пожалуйста, рассмотрите возможность пожертвования разработчикам FFmpeg. Каждое видео WATERMeDIA plays проходит через их работу, и без них этого проекта не было бы.

⚖️ ЛИЦЕНЗИЯ

WATERMeDIA и WATERMeDIA: Бинарные файлы находятся под Защитная лицензия на открытый исходный код (некоммерческая) v1.0.1. Авторские права SrRapero720 (https://github.com/SrRapero720).

Разрешено некоммерческое использование (включая, помимо прочего, пакеты модов и серверные пакеты). Коммерческое использование запрещено; свяжитесь с нами, чтобы использовать WATERMeDIA в коммерческих целях.

Сторонние библиотеки, поставляемые обоими модами, сохраняют свои собственные лицензии; прочитайте их в WATERMeDIA и WATERMeDIA: Двоичные файлы репозиториев перед распространением.