Digimoodien käyttöönotto

Digimoodien käyttöä varten täytyy asentaa wrc-proxy-apuohjelma sekä virtuaaliaudiokaapeliajuri. Näiden apuohjelmien asennus täytyy tehdä vain kerran (per tietokone), mutta se on välttämätöntä, jotta digimoodisovelluksia voidaan yhdistää Web Radio Controliin.

wrc-proxy-apuohjelman asennus

wrc-proxy-apuohjelma tulee asentaa ennen digimoodisovellusten käyttöä. Asennus tarvitsee tehdä vain kerran. Asennuksen jälkeen tulee seurata ohjeita kohdassa Digimoodisovelluksen yhdistäminen Web Radio Controliin.

  1. Lataa wrc-proxy-asennuspaketti käyttöjärjestelmällesi.

  2. Pura ladattu ZIP-paketti. Paketti sisältää apuohjelmatiedoston (wrc-proxy tai wrc-proxy.exe) sekä asennusskriptin.

  3. Suorita asennusskripti

    • Windowsilla: suorita install-wrc-proxy.bat järjestelmänvalvojana klikkaamalla tiedostoa oikealla napilla ja valitsemalla Run as administrator eli Suorita ohjelma järjestelmänvalvojana ja hyväksy rekisterimuutokset, jotka skripti tekee (jos Windows niitä pyytää hyväksymään). wrc-proxy.exe-ohjelmatiedosto asennetaan käyttäjän kotihakemistoon.

    • Linuxilla: suorita install-wrc-proxy.sh. wrc-proxy-binääri asennetaan bin/wrc-proxy-tiedostoon käyttäjän kotihakemistoon.

    • Mac OS:lla: asennusskriptiä ei toistaiseksi ole valmiina, joten wrc-proxy tulee aina käynnistää komentoriviltä myöhemmin esitettävien ohjeiden mukaisesti.

Virtuaaliaudiokaapelin asennus

Seuraa käyttämäsi käyttöjärjestelmän (Windows, Linux tai Mac OS) mukaisia ohjeita.

Windows

Windows-ympäristöön täytyy erikseen ladata ja asentaa virtuaaliaudiokaapeliajuri. Tällaisiä on useampia ja yksi yleisimmin käytetyistä on VB Audio Virtual Cable. Virtual Cable:n ilmaisversiolla saa vain yhden "kaapelin" (eli loopback-laitteen), joten radiokäyttöä varten ohjelmasta täytyy maksaa (minimi 5€), jotta saa kaksi virtuaalikaapelia. Muut tiedossa olevat virtuaaliaudiokaapeliajurit Windowsille ovat myös maksullisia.

  1. Osta ja lataa kaksi virtuaaliaudiolaitetta tarjoava versio VB Audio Virtual Cable:sta.

  2. Asenna lataamasi VB Audio Virtual Cable ja käynnistä Windows tarvittaessa uudelleen.

  3. Äänentoistolaitteissa (playback) pitäisi nyt olla listattuna CABLE-A Input sekä CABLE-B Input ja tallennuslaitteissa (recording) CABLE-A Output sekä CABLE-B Output. Äänensignaali kulkee siis Input-laitteista Output-laitteisiin.

Linux (PulseAudio)

Useimmat Linux-distribuutiot käyttävät PulseAudio-äänijärjestelmää. Sen avulla on helppo lisätä virtuaaliaudiokaapeleita eli loopback-laitteita.

Loopback-laitteiden konfigurointi

Seuraava esimerkki lisää kaksi laitetta:

  • radio-output, jonne on tarkoitus viedä radion tuottama äänisignaali selaimesta

  • radio-input, jonne on tarkoitus video digimoodisovelluksen tuottama äänisignaali

Loopback-laitteet voi lisätä PulseAudio-järjestelmään kahdella tavalla:

On suositeltavaa luoda laitteet pysyvästi (tapa 1), mutta jos haluat testata loopback-laiteasetusten toimintaa muuttamatta järjestelmän ääniasetuksia, ohjeissa on myös kuvattu väliaikainen tapa. Jos loopback-laitteet on jo luotu pysyvästi, niitä ei tarvitse enää luoda uudelleen, joten äänen kytkeminen sovellusten välille on nopeampaa.

Tapa 1: loopback-laitteiden lisääminen pysyästi

Tarvitset root-käyttäjän tai sudo-oikeudet järjestelmätiedostojen muuttamiseen!

Lisää tiedostoon /etc/pulse/default.pa seuraavat rivit:

# Loopback devices
load-module module-null-sink sink_name=radio-output sink_properties=device.description="radio-output"
load-module module-null-sink sink_name=radio-input sink_properties=device.description="radio-input"
load-module module-loopback source=radio-output.monitor latency_msec=100 adjust_time=0 rate=48000
load-module module-loopback source=radio-input.monitor latency_msec=100 adjust_time=0 rate=48000

Vähentääksesi latenssia (poistamalla näytteenottotaajuuden konversioita), tiedostoon /etc/pulse/daemon.conf voi myös lisätä rivit: (ei pakollista)

default-sample-format = s16le
default-sample-rate = 48000
alternate-sample-rate = 44100

Käynnistä muutosten jälkeen PulseAudio uudelleen komentorivillä komennolla pulseaudio -k ja odota hetki sen käynnistymistä.

Tapa 2: loopback-laitteiden lisääminen väliaikaisesti

Suoritta seuraavat komennot komentorivillä pactl-hallintaohjelman avulla:

pactl load-module module-null-sink sink_name=radio-output sink_properties=device.description="radio-output"
pactl load-module module-null-sink sink_name=radio-input sink_properties=device.description="radio-input"
pactl load-module module-loopback source=radio-output.monitor latency_msec=100 adjust_time=0 rate=48000
pactl load-module module-loopback source=radio-input.monitor latency_msec=100 adjust_time=0 rate=48000

MacOS

Mac OS-käyttöjärjestelmään tulee ladata ja asentaa virtuaaliaudiokaapeliajuri, jotta äänisignaaleja voi välittää ohjelmien välillä. Yleisesti käytettyjä virtuaaliaudiokaapeleita ovat esim. Soundflower ja Loopback.

Asenna joko Soundflower- tai Loopback-virtuaaliaudiokaapeli:

Digimoodisovellusten kytkeminen Web Radio Controliin