AerOn | vMix | Visual Radio | Handleiding
VisualRadio
Handleiding
april 2023
Copyright (C) 2023, Broadcast Partners
Axelsestraat 58 · 4537 AL Terneuzen · Nederland
tel. (31) 115 683 555
1 VisualRadio 2
2 Installatie VisualRadio 3
2.1 Installatie op Aeron PC 3
2.2 Installatie op vMix PC 4
2.3 Configuratie Aeron 6
2.4 Configuratie vMix 9
2.5 Configuratie VisualRadio 11
3 Video voice track 17
.Begin Inhoud C.
.Eind Inhoud C.
1 VisualRadio
VisualRadio gebruikt u in de combinatie van radio-automatisering Aeron (https://www.aeronstudio.nl/) en videomixer vMix (https://www.vmix.com/).
Aeron stuurt VisualRadio aan dat op zijn beurt vMix aanstuurt.
Aeron en vMix zijn elk op een eigen PC geïnstalleerd. De software van VisualRadio bestaat uit meerdere onderdelen waarvan er een aantal op de ene en een aantal op de andere PC geïnstalleerd zijn.
De handleiding is gebaseerd op vMix 26.
1.1 Wat heb je nodig?
1.2 Wat moet je doen?
- Videotrack met goede beeld- en geluidskwaliteit inladen in Aeron
- Titel en artiest invoeren
- Afbeelding bij de track (album of artiest) zoeken
- Track markeren als MUSIC of JINGLE
1.3 Wat krijg je als resultaat?
2 Installatie VisualRadio
2.1 Installatie op Aeron PC
Gebruik installer 1.16.3.29 of nieuwer.
Vink de optie ‘Aeron Studio VisualRadio messenger’ aan.
Maak gebruiker ‘VisualRadio’ aan en ken daar administratorrechten aan toe.
Onderstaande informatie is voor het controleren van een correcte installatie en het aanpassen van de standaard instellingen.
Volgende onderdelen zijn benodigd:
- Internet Information Services (IIS)
- dotNet Core 5.0.17
Aeron.MessageHandler
Installeer de MessageHandler in:
C:\Program Files\Broadcast Partners\VisualRadio\AeronMessageHandler
Contoleer en verbeter in appsettings.json de verbinding met de database en de WebApi.
{
"ConnectionStrings": {
"AeronDatabase": "Server=localhost;Port=5413;Database=aeron;User Id=aeron;Password=aeron"
},
"AeronVisualRadioSocketSettings": {
"RadioId": 1,
"VisualRadioHost": "127.0.0.1",
"VisualRadioPort": 8082
},
"AeronWebApiClientSettings": {
"WebApiEndpoint": "http://localhost:55053/"
},
Aeron.WebApi
Installeer de WebApi in:
C:\inetpub\wwwroot\VisualRadio\AeronWebApi
Contoleer en verbeter in appsettings.json de verbinding met de database.
{
"ConnectionStrings": {
"AeronDatabase": "Server=localhost;Port=5413;Database=aeron;User Id=aeron;Password=aeron",
},
2.2 Installatie op vMix PC
Gebruik installer 1.16.3.29 of nieuwer.
Vink de opties ‘Aeron Studio Software’ en ‘InOutBox’ uit.
Vink ‘Smart VisualRadio’ aan.
Maak gebruiker ‘VisualRadio’ aan en ken daar administratorrechten aan toe. Dit moet dezelfde gebruiker zijn als eerder is aangemaakt op de Aeron-PC.
Installeer de Smart VisualRadio-services met dit account en niet met het ‘Lokaal systeemaccount’.
Onderstaande informatie is voor het controleren van een correcte installatie en het aanpassen van de standaard instellingen.
Volgende onderdelen zijn benodigd:
- Internet Information Services (IIS)
- dotNet Core 5.0.17
- RabbitMQ 3.11.x
- PostgreSQL 14.x
VisualRadio.WebApp
Installeer de WebApp in:
C:\inetpub\wwwroot\VisualRadio\WebApp
Contoleer en verbeter in appsettings.json de verbinding met de database.
{
"ConnectionStrings": {
"VisualRadioDatabase": "Server=127.0.0.1;Port=5414;Database=visualradio;User Id=postgres;Password=postgres"
},
VisualRadio.EventHandler
Installeer de EventHandler in:
C:\Program Files\Broadcast Partners\VisualRadio\AeronMessageHandler
Contoleer en verbeter in appsettings.json de verbinding met de database.
{
"ConnectionStrings": {
"VisualRadioDatabase": "Server=127.0.0.1;Port=5414;Database=visualradio;User Id=postgres;Password=postgres"
},
VisualRadio.EvenHandlerWorker
Installeer de EventHandler in:
C:\Program Files\Broadcast Partners\VisualRadio\AeronMessageHandlerWorker
Contoleer en verbeter in appsettings.json de verbinding met de database.
{
"ConnectionStrings": {
"VisualRadioDatabase": "Server=127.0.0.1;Port=5414;Database=visualradio;User Id=postgres;Password=postgres"
},
2.3 Configuratie Aeron
Videobestanden dienen voor zowel Aeron als vMix beschikbaar te zijn. Aeron speelt de audiotrack, vMix laat het bijbehorende beeld zien.
We gaan er van uit dat deze bestanden op de Aeron-PC aanwezig zijn op een disk met de schijfletter P: (welke dat is maakt niet veel uit, maar in principe nooit C: waarop Windows geïnstalleerd is).
Maak van P: een netwerkshare, bijvoorbeeld: \\Aeron-PC\p
Maak een koppeling naar deze netwerkshare met schijfletter Z:. Later verwijst op de vMix-PC ook schijfletter Z: naar deze netwerkshare.
De schijfletter die verwijst naar de netwerkshare moet op beide PC’s dezelfde zijn.
Afhankelijk van wat er speelt in Aeron (muziek, jingle, commercial, …) zal er in vMix iets (of juist niets) getoond moeten worden. Dan doen we door het definiëren van eventtypes.
Deze handleiding beschrijft een basisconfiguratie met de eventtypes MUSIC en JINGLE. Een muziekvideo koppelen we aan eventtype MUSIC, een jinglevideo koppelen we aan eventtype JINGLE.
Voice tracks staan niet in de database van Aeron maar worden automatisch herkend en als eventtype VOICETRACK naar VisualRadio gestuurd.
Maak in de criteria ‘VIDEO MUSIC’ en ‘VIDEO JINGLE’.
Geef daarna in de Databank editor bij elke videotrack aan of het om muziek of een jingle gaat.
Maak in de Item browser de categorie ‘VisualRadio’ met daar onder de subcategorieen ‘JINGLE’ en ‘MUSIC’. Beide subcategorieren zijn filter op de eerder genoemde criteria.
Subcategorie ‘MUSIC’ is een filter op ‘Doelgroep – VIDEO MUSIC’.
Zodra een track in de Databank editor het criterium ‘VIDEO MUSIC’ aangevinkt krijgt zal deze direct zichtbaar zijn in de betreffende categorie in de Item browser. Dit is het enige dat de eindgebruiker hoeft te doen: criterium aanvinken als het om een videotrack gaat.
Voor de aansturing van VisualRadio zijn nog de volgende stappen nodig.
Ga naar Tools à Instellingen à Globaal
De instelling van de MessageHandler (Host en Port) kan normaliter op de standaard 127.0.0.1:8082 blijven staan. (Deze instelling moet overeenkomen met wat in appsettings.json van de MessageHandler staat.)
In de ‘Map met afbeeldingen’ is de afbeelding van de actieve track (track, album of artiest) te vinden. Aeron geeft deze door aan VisualRadio. Deze map (netwerkshare) moet voor vMix vindbaar zijn.
Het opslaan van de afbeelding van de actieve track gebeurt met ‘Export HTML/XML/Tekst’ (sectie Automatisering). Activeer het sjabloon ‘VisualRadio’ waarvan de output in de eerder genoemde ‘Map met afbeeldingen’ komt. Het is belangrijk dat dit dezelfde map is, anders kan vMix de afbeeldingen niet vinden.
Dit is voldoende om Aeron de VisualRadio software aan te sturen.
Op het moment dat er in Aeron een ‘play’ plaats vindt, controleert de software of het item in een subcategorie van ‘VisualRadio’ staat. Is dit het geval dan stuurt Aeron de naam van het eventtype (JINGLE of MUSIC) naar VisualRadio.
Voor voice tracks (eventtype VOICETRACK) gebeurt dit zonder tussenkomst van de Item browser.
Daarnaast stuurt Aeron het volgende naar VisualRadio:
- Titel van de track
- Artiest
- Locatie van de afbeelding
2.4 Configuratie vMix
VisualRadio gebruikt de eventtypes zoals die van Aeron binnen komen voor het aansturen van vMix.
Maak in vMix inputs van het type ‘Colour’ met de volgende namen aan:
- DEFAULT
- JINGLE
- MUSIC
- VOICETRACK
Input DEFAULT zal actief zijn als er geen geldig eventtype van Aeron komt.
Elke input toont een video en een balk met informatie over bijvoorbeeld track, tijd en actueel nieuws. Dit zijn lagen (layers) die over elkaar heen liggen. Layer 1 ligt op de achtergrond, de andere komen daar voor, met layer 10 voorop.
Elke layer is op zich ook weer een input.
De naamgeving van deze inputs moet aan de volgende standaard voldoen (bijvoorbeeld MUSIC):
Layer
Naam
Omschrijving
2
MUSIC_FALLBACK
Standaard afbeelding als er geen video en ook geen fallbackvideo is.
5
MUSIC_FALLBACK_VIDEO
Fallbackvideo als er geen video is.
9
MUSIC_UI
Balk met trackinformatie, nieuws, tijd, …
De FALLBACK-varianten worden enkel zichtbaar in het uiterste geval, als er geen video bij de track weergegeven kan worden. Dit komt normaliter niet voor.
VisualRadio zet de video op layer 6 waardoor de fallbacks onzichtbaar zijn.
Zodra een nieuwe track in Aeron start maakt VisualRadio die zichtbaar in vMix door de input met de naam van de eventtype (MUSIC, …) naar de output te sturen.
Het is mogelijk om bij het spelen van voice tracks de DJ en de muziekvideo beide in beeld te brengen als deze een overlap hebben (de DJ presenteert over outro en intro).
Hiervoor is het nodig om een input (type Colour) te maken met de naam PIP.
Configureer de ‘Multi View’ zoals getoond.
VisualRadio zet de voice track op layer 1, elke overige eventtype op layer 2. Daarna komt input PIP op layer 8 van de actieve input.
In dit geval zal de voice track beeldvullend zijn en de muziekvideo als ‘picture in picture’. Omgekeerd is ook mogelijk door bij ‘Position’ positie en formaat van de inputs aan te passen.
Voor het weergeven van titel, artiest en afbeelding is een input van het type ‘Title’ nodig, VisualRadio gebruikt hier voor de inputs met de naam ‘_UI’. ‘vMix GT Title Designer’ is een aparte applicatie voor het ontwerpen en aanpassen van deze titles.
vMix levert een aantal voorbeeldtemplates die te vinden zijn in:
C:\Program Files (x86)\vMix\titles\
Aeron bron
GT Object type
Naam
Titel
TextBlock
@TITLE
Artiest
TextBlock
@ARTIST
Afbeelding
Image
@ALBUMCOVER
2.5 Configuratie VisualRadio
Configureer VisualRadio in de browser: localhost:64808
License
Controleer of er een geldige licentie aanwezig is.
Bij ‘Allowed Sources’ moet in elk geval Aeron staan.
Radio’s
WebApiEndpoint
Het IP-adres van de Aeron-PC en de poort van de Aeron.WebApi. Een correcte configuratie is te controleren in de browser, bijvoorbeeld:
‘http://192.168.10.30:55052/swagger’
Automation
Linked to Radio
Kies de eerder ingestelde Aeron.
Web Controller (vMix WebApi) Url
Als VisualRadio en vMix op dezelfde PC geinstalleerd zijn is de standaard aansturing van vMix op ‘http://127.0.0.1:8088/’. In vMix is dit aan te passen in de Settings bij ‘Web Controller’.
De instellingen ‘Where can VisualRadio.EventHandler find the videos?’ en ‘Where can vMix find the videos?’ verwijzen naar dezelfde locatie met audio/videobestanden die door Aeron gebruikt wordt.
De EventHandler service heeft hiervoor een UNC pad nodig.
Voor vMix is er een schijfletter die verwijst naar dezelfde locatie nodig.
How should the active item be shown (and triggered)?
Kies: TransitionInActiveEventTypeInput
Bestaande vMix-configuraties hebben mogelijk een input met de naam VISUALRADIO_OUTPUT. Bij gebruik van deze input wordt de relevante input als layer in VISUALRADIO_OUTPUT geladen. Dit brengt een extra laag van te tonen inputs met zich mee wat een probleem vormt bij het gebruik van PIP die dan als een derde laag zichtbaar moet worden, wat niet mogelijk is.
Zie:
https://forums.vmix.com/posts/t22765-limit-to---of-stacked-input-layers
vMix is limited to 2 deep (for performance reasons), if you attempt a 3rd stack you will lose the layers in the 1st (bottom) Input Multiview.
Video sound
Standaard uit. Aeron speelt alle audio, ook van tracks zonder video of live presentaties.
What to do when no item is playing
- ShowLastPlayingInput: De laatste actieve input blijft zichtbaar, waarvan de layer ‘FALLBACK_VIDEO’ wodt getoond.
- ShowNotPlayingFallbackInput: Toon de input die ingesteld is bij ‘Fallback when nothing is playing’.
Fallback when nothing is playing
Vul hier de naam van de input in vMix in die getoond wordt als Aeron niets speelt.
AudioTriggering
Deze instellingen zijn voor het schakelen van camera’s en microfoons bij live programma’s met gasten.
Bereikt de input van een microfoon gedurende een bepaalde tijd een bepaald niveau, dan schakelt VisualRadio naar de bijbehorende input. Een lager dB-niveau is ook weer nodig om de input uit te schakelen.
EventTypes
De eventtypes zoals die bekend zijn in Aeron en vMix moeten hier toegevoegd worden.
AudioSources
Dit is een overzicht van alle beschikbare audioinputs die beschikbaar zijn voor audiotriggering.
3 Video voice track
Voor het opnemen van video voice tracks is een tweede vMix installatie nodig.
Configuratie: Tools à Instellingen à Lokaal
Actief
Vink aan om de Mix editor vMix aan te laten sturen bij het opnemen van een voice track.
Http host
IP-adres van de vMix installatie die camerabeelden opneemt.
Http port
Standaard 8088
vMix recording map
Dit is de map waarin vMix de opgenomen video’s opslaat. Dit is normaliter een lokale map op de vMix-PC die als een netwerkshare gedeeld wordt.
vMix vt afspeel map
Dit is een lokale map voor de voice tracks.
Aeron verplaatst de opnamen naar deze map en hernoemt naar naamgeving die voor voice tracks wordt gebruikt.
vMix record start delay (ms)
Vertraging waarmee een opnamecommando naar vMix wordt gestuurd.
Video player / editor
Programma dat Aeron gebruikt voor het weergeven van de opgenomen video voice track.