SuperRadio - Rozšířená verze (Úprava od mxnticek & Gemini AI)
=============================================================
Verze: 0.1 - Vychází z poslední dostupné verze pluginu SuperRadio.

Co je zde nového?
-----------------
- Opraveno zasekávání a nefunkčnost některých rádií při rychlém přepínání (případné chyby prosím hlaste).
- Zcela nová funkce odesílání názvu aktuálně hrající skladby (metadat) ze streamu přímo na displej rádia v OMSI.
- Možnost přehrávat lokální písničky nebo celé playlisty přímo z vašeho disku.

Kompatibilita:
--------------
Plně kompatibilní s:
- Starým konfiguračním souborem SuperRadio (SuperRadio.opl).
- Autobusy od Sobola (bez podpory názvů skladeb na displeji, ale s plnou podporou lokálních playlistů a písniček).
- Autobusy od P3ty (rádia plně podporují zobrazení názvů skladeb za použití přiloženého programu SuperRadioHelper).

Není kompatibilní s:
- Starou verzí pluginu SuperRadio (s jinými DLL soubory nebo staršími skripty se nemusí chovat správně).

Jak nainstalovat?
-----------------
1. Pro správný chod je nutné mít nainstalovaný .NET Desktop Runtime 8.0.26 nebo novější.
   - 64-bit: https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-desktop-8.0.26-windows-x64-installer
   - 32-bit: https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-desktop-8.0.26-windows-x86-installer
2. Zkopírujte všechny soubory z archivu do hlavní složky, kde máte nainstalované OMSI 2.
   - Soubory ze složky "scripts" nakopírujte do složek s vašimi autobusy, které podporují toto rádio (např. autobusy od P3ty, mimo model 1090).
   - Soubory ze složky "plugins" nakopírujte do složky "OMSI 2\plugins".
   - Ostatní soubory z hlavní složky vložte přímo do kořenové složky OMSI 2.
3. Hotovo! Můžete hrát.

Co je program SuperRadioHelper (složka SRH)?
--------------------------------------------
Ve složce SRH se nachází program "SuperRadioHelper.exe". Jedná se o pomocníka, který běží na pozadí, propojuje se s hrou přes OmsiHook a plynule zapisuje aktuální název skladby na displej rádia v autobuse.
Samotný plugin SuperRadio bude hrát i bez něj, ale s Helperem získáte maximální zážitek z reálného zobrazení hudby na displeji.
Upozornění: Složku SRH si můžete přesunout kamkoliv chcete, ale musíte program spouštět se stejnými právy jako OMSI (pokud OMSI spouštíte jako správce, SuperRadioHelper musí být také spuštěn jako správce).

Jak na lokální písničky a playlisty?
------------------------------------
Do konfiguračního souboru "OMSI 2\plugins\SuperRadio.opl" si můžete kromě internetových streamů nastavit také vlastní hudbu z počítače. Cesty v configu musí vždy začínat příslušnou předponou a mohou být zadány jako relativní (vycházející z hlavní složky OMSI 2) nebo absolutní (přesná cesta na disku).

1. Přehrání jedné konkrétní písničky (předpona f:)
Pokud chcete na vybrané stanici přehrávat konkrétní .mp3 soubor, použijte předponu f:

Příklad (relativní cesta ke složce OMSI 2):
CH2=f:Plugins\SuperRadio\Music\pisnicka.mp3

Příklad (absolutní cesta kamkoliv na disku):
CH3=f:C:\Users\Uzivatel\Hudba\oblibena_pisnicka.mp3

2. Přehrávání lokálního playlistu (předpona p:)
Pokud chcete přehrávat více písniček za sebou, můžete si vytvořit textový playlist (.txt nebo .m3u) a použít předponu p:

Příklad (relativní cesta ke složce OMSI 2):
CH4=p:Plugins\SuperRadio\Playlists\muj_mix.txt

Příklad (absolutní cesta kamkoliv na disku):
CH5=p:D:\Zaloha_Hudby\Playlisty\leto.txt

*Tip pro playlisty:*
Uvnitř textového souboru playlistu (např. muj_mix.txt) se skladby vypisují pod sebe na nové řádky.
Lze zde použít buď jen jména souborů (plugin je bude hledat ve stejné složce jako leží playlist), nebo rovnou absolutní cesty k písničkám. Například:

pisnicka1.mp3
pisnicka2.mp3
C:\Hudba\Album2\dalsi_pisnicka.mp3
