VSK VIRTUAL STUDIO KIT
ENPL

Instalacja Sprawdzone w studiu

VSK podróżuje jako jeden folder wtyczki. Skopiowanie go do projektu i wciśnięcie trzech przycisków Studio Setup odbudowuje całe studio - poniższa procedura to ta sama, której użyto do przeniesienia wtyczki między prawdziwymi maszynami.

Wymagania

WymaganiePo co
Unreal Engine 5.8 (Windows)Wtyczka celuje w EngineVersion 5.8.0; przechwytywanie audio to WASAPI/Win64.
Toolchain C++ (Visual Studio)VSK ma jeden moduł Runtime w C++; pierwsze otwarcie go kompiluje (zamienia projekt Blueprint-only w projekt z kodem).
Blackmagic Desktop Video + karta DeckLinkPrzechwytywanie/wyjście SDI. Sprawdzone w studiu na DeckLink Quad 2 przy 1080p50.
ffmpeg w PATHNagrywanie MP4/MOV i miniatury wideo. winget install Gyan.FFmpeg, potem restart edytora.
Środowisko NDI (opcjonalnie)Tylko dla NDI we/wy - darmowe z ndi.video. Bez niego funkcje NDI pozostają po cichu nieaktywne.

Kroki instalacji

  1. Skopiuj folder wtyczki do <Projekt>/Plugins/VirtualStudioKit/. Usunięcie wcześniej Intermediate/ i Binaries/ jest OK - odbudują się.
  2. Otwórz projekt i zaakceptuj monit „missing modules - rebuild?”. Moduł kompiluje się w kilka sekund.
  3. Włącz wtyczkę Blackmagic Media (Edit ▸ Plugins) i zrestartuj, gdy poprosi.
  4. Otwórz Window ▸ VSK Project i wciśnij STUDIO SETUP ▸ Apply Project Config, potem restart. To zapisuje wymaganą konfigurację silnika (adres HTTP, r.AllowGlobalClipPlane=True, game mode VSK) - pierwszy start po tym raz rekompiluje shadery.
  5. Wciśnij Create SDI Input Assets (idempotentne - można wciskać ponownie) i Create SDI Output Asset. To materializuje cały tor mediów w /Game/VSK/Media.
  6. Zbuduj lub zmigruj poziom: Camera Director, po jednym AVS_Billboard na prezentera, CineCamery, światła i aktor Planar Reflection. Wskaż Plate każdego billboardu na jego teksturę VS_MT_CamN i dodaj komponent VS Media Input.
  7. SHOW FILE ▸ Import pliku .vskshow, by przywrócić kompletne studio - ustawienia, sceny, panele, skróty i media z półki w jednym kroku.
Zapora (jednorazowo) - aby dosięgnąć pilota web z innych urządzeń, zezwól na port w terminalu administratora:
netsh advfirewall firewall add rule name="VSK Web Remote 8090" dir=in action=allow protocol=TCP localport=8090

Co podróżuje, a co nie

Wszystko w folderze wtyczki podróżuje: moduł, cała zawartość Blueprint, materiały keyera i strona pilota web. Stan po stronie projektu (ustawienia, sceny, wartości keyera, panele…) mieszka w slotach SaveGame i podróżuje przez pliki show. Dwa assety wciąż robi się ręcznie, bo używają selektorów urządzeń: VS_Genlock_BM (custom time step) i VS_TC_BM (timecode provider).

Cykl kompilacji - przy pracy nad źródłami wtyczki: zamknij edytor, uruchom Build.bat (≈6-9 s), otwórz ponownie. Edytor blokuje DLL modułu, gdy działa.