exchanger/addons/native_video/INSTALLATION.ru.md

1.7 KiB
Raw Permalink Blame History

Установка Native Video

Пакет предназначен для Godot 4.6+ на Windows x86_64 и GNU/Linux x86_64.

  1. Распакуйте архив в корень проекта Godot. В результате файл расширения должен находиться по пути res://addons/native_video/native_video.gdextension.
  2. Полностью перезапустите редактор Godot.
  3. Используйте NativeVideoStream через обычный VideoStreamPlayer.

В Windows дополнительных мультимедийных пакетов не требуется: используется Media Foundation. Сборка проверена в Godot 4.7.1 Mono с рендерером Vulkan.

В Linux используются динамические системные библиотеки GStreamer 1.x. Для Debian/Ubuntu установите runtime-компоненты:

sudo apt install libgstreamer1.0-0 libgstreamer-plugins-base1.0-0 \
  gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
  gstreamer1.0-plugins-bad gstreamer1.0-libav gstreamer1.0-vaapi

Linux-сборка рассчитана на glibc 2.36+ и Vulkan (Forward+ или Mobile). Аппаратный декодер обязателен по умолчанию. Если он недоступен, расширение выводит понятную ошибку. Явно разрешить программный fallback для диагностики можно переменной окружения GODOT_NATIVE_VIDEO_ALLOW_SOFTWARE=1.

Подробности о кодеках, драйверах и диагностике находятся в README.md.