Možnosti nastavení

Nastavení aplikace

Možnosti nastavení aplikace jsou rozděleny do tří záložek:

• Zobrazení - volby pro nastavení uživatelského rozhraní
• Zvuk & obraz - volby pro nastavení obrazu z kamery a zvuku
• Systémové nastavení - volby konfigurace backendu klienta CoUnSiLu

Nastavení vlastností uživatelského rozhraní

• Jazyk - aplikace je lokalizována do tří jazyků: Češtiny, Slovenštiny a Angličtiny, změna jazyka se projeví po restartování aplikace
• Zvětšit o - volba umožňuje nastavit parametr zvětšení okna studenta, který je vyvolaný o definovaný počet pixelů. Výchozí volba je 30 pixelů
• Barevné zvýraznění při hlášení - nastavení barvy orámování, které signalizuje hlásícího se studenta (výchozí barvou je červená)
• Barevné zvýraznění při vyvolání - nastavení barvy orámování, které signalizuje studenta, jemuž bylo uděleno slovo (výchozí barvou je modrozelená)

Nastavení obrazu a zvuku

• Zvuk - nastavení zařízení pro snímání a přehrávání audia
  • Vstupní zařízení - volba vstupního zvukového zařízení (mikrofonu), v rozbalovací nabídce se zobrazují dostupná zařízení
  • Výstupní zařízení - volba výstupního zařízení, v rozbalovací nabídce se zobrazují dostupná zařízení
• Obraz - nastavení pro vykreslování obrazů kamer dalších účastníků
  • Výstupní zařízení - volba výstupního zařízení pro vykreslování obrazu kamer, na výběr jsou dvě: gl a sdl, výchozí a preferovanou variantou je gl. Pro další informace konzultujte dokumentaci UltraGridu
  • Rozšířené nastavení - doplňující nastavení pro zobrazovací výstup sdl nodecorate, okna účastníků budou bez dekorací
• Zařízení - nastavení kamery uživatele
  • Zařízení - volba kamery, v rozbalovací nabídce se zobrazují dostupná zařízení; pro testovací účely je přidána tzv. testcard
  • Formát - formát barevného prostoru (pokročilá volba nastavení). Doporučujeme ponechat výchozí hodnoty pro zvolené zařízení.
  • Velikost - rozlišení obrazu kamery, pro učitele doporučujeme 400x300 pixelů, pro tlumočníka 640x480 pixelů, pro studenty 320x200 pixelů
  • Snímková frekvence (fps) - nastavení snímkové frekvence, doporučujeme min. 25 snímků, max. 30 snímků
  • Nastavení zařízení je doplňková informace o parametrech nástroje UltraGrid, vhodné pouze pro správce a administrátory systémů
  • Tlačítko Test kamery
• Prezentace - nastavení parametrů pro snímání prezentace, volby jsou shodné s nastavením parametrů kamer v sekci Zařízení. Pro snímání prezentace je nutné mít zvolenu roli Učitel a připojit zařízení pro snímání obrazovky (tzv. frame grabber).

Nastavení systémových požadavků

Nastavení systémových požadavků slouží k pokročilejším úpravám konfigurace klienta. Bez hlubší znalosti významu jednotlivých voleb nedoporučujeme uživatelům do konfigurací jakkoliv zasahovat.

• IP adresa klienta - nastavení aktuální IP adresy klienta (naleznete jej v nastavení pro síťové karty)
• Nastavení serveru - konfigurace
  • IP adresa - adresa serveru
  • Jméno serveru - uživatelské označení serveru v seznamu dostupných serverů,
  • port - komunikační port pro získání základních informací o serveru (dostupné místnosti aj.), výchozím portem je port 80
  • Tlačítko Přidat - uloží nový server do seznamu dostupných serverů, při dalším spuštění aplikace bude zobrazen v úvodní nabídce serverů
  • Tlačítko Použít - uloží změny v nastavení parametrů serveru
  • Tlačítko Odstranit - smaže aktuálně zobrazený server ze seznamu dostupných serverů
• Umístění UltraGridu - cesta k aplikaci UltraGrid
• Umístění složky layoutů - cesta k umístění složky s konfiguračními soubory rozmístění oken
• Tlačítko Načíst cesty slouží k ověření platnosti nastavení

Soubory s konfiguracemi

Konfigurační soubor klienta

Konfigurační soubor je umístěn v adresáři configs. Jedná se o textový soubor používající JSON notaci. Všechny uvedené parametry lze nastavit v grafickém uživatelském rozhraní. Nedoporučujeme ruční úpravy souboru.

Nastavení jazyka. Možnosti jsou: Czech, English, Slovak

  "language":"English",

Barva orámování okna studenta, který se hlásí o slovo. Hodnota je definována po složkách RGB (červená, zelená modrá). Hodnoty mohou být v rozsahu 0-255.

  "raise hand color":{  
     "red":255,
     "green":0,
     "blue":0
  },

Barva orámování okna studenta, která signalizuje, že studentovi bylo uděleno slovo. Hodnota je definována po složkách RGB (červená, zelená modrá). Hodnoty mohou být v rozsahu 0-255.

  "talking color":{  
     "red":0,
     "green":255,
     "blue":255
  },

Hodnota IP adresy klienta. IP adresa musí být veřejná.

  "this ip":"147.251.0.1",

Parameter určující, zda z daného klienta bude posílán také obraz počítače/prezentace. Může být nastavený na true pouze pro roli učitele.

  "presentation":false,

Nastavení kamery.

  "producer settings":"avfoundation:device=0:mode=4:framerate=25",

Nastavení pro zobrazení obrazu z kamer. Hodnoty mohou být gl nebo sdl.

  "consumer settings":"gl",

Parametry výstupního audio zařízení (reproduktory/sluchátka). Pokud je hodnota prádná, klient nebude přijímat zvuk.

  "audio consumer":"",

Parametry vstupního audio zařízení (mikrofon). Pokud je hodnota prádná, klient nebude posílat zvuk.

  "audio producer":"",

Cesta k aplikaci UltraGrid uv.exxe

  "ultragrid path":"/Users/Your/Path/To/Ultragrid/bin/uv.exe",

Cesta k adresáři s konfiguračními soubory rozložení oken

  "layout path":"configs/layout",

Cesta k aplikaci zrcadla paketů. Zpravidla je ve složce UltraGrid/bin.

  "distributor path":"/Users/Your/Path/To/Ultragrid/bin/hd-rum-transcode",

Seznam serverů dostupných v uživatelském rozhraní. Každý server je definován komunikačním portem (port), IP adresou (ip), jménem (name), které může být libovolný text.

  "server ips":[  
     {  
        "port":"80",
        "ip":"147.251.36.2",
        "name":"server Teresias"
     }
  ],

Parametr, který určuje o kolik se zvětší okno studenta, kterému bylo uděleno slovo. Výchozí hodnota je 30 (pixelů).

  "talking resizing":30

Konfigurační soubor pro nastavení výchozího rozložení oken

Konfigurační soubor, v němž je definováno výchozí rozložení oken klienta je uložen v adresáři configs/layouts/. Součástí instalace je vzorový konfigurační soubor, který obsahuje varianty rozložení pro všechny uživatelské role.

Soubor má jednoduchou strukturu. Obsahuje seznam dostupných rozložení oken (layoutů) a výchozí pozici pro menu aplikace, které je definováno hodnotou parametrů x a y uvedených v pixelech. Pozice x=0, y=0 je v levém horním rohu obrazovky. Struktura souboru je následující:

{  
   "layouts" : [
       {
          Definice layoutu 1
       },
       . . . 
        {
          Definice layoutu n
       }
   ],
   
   "startingMenu" : {
       "x" : "0",
       "y" : "0"
   }
}

Definice layoutu

Definice jednotlivých layoutů má tři části:

• conditions: seznam podmínek, za kterých, jsou-li všechny splněny, dojde k aplikaci pravidel layoutu
• windows: pozice oken dle jejich typu:
  • presentation - obrazovka počítače
  • interpreter - okno tlumočníka
  • teacher - okno učitele
  • student - okna studentů
• menu: pozice menu pro daný layout. Pozice je dána hodnotou parametrů x a y uvedených v pixelech. Pozice x=0, y=0 je v levém horním rohu obrazovky.

Ukázka záznamu je uvedena níže:

       {
           "conditions":[
               {"role":"presentation", "count":"1"},
               {"role":"student", "less":"5"},
               {"my role":"student"}
           ],
           "windows":{
               "presentation": [
                   {"x": "0", "y": "0", "width": "1024", "height": "768"}
               ],
               "interpreter": [
                   {"x": "1024", "y": "50", "width": "640", "height": "480"}
               ],
               "teacher": [
                   {"x": "1", "y": "769", "width": "428", "height": "321"}
               ],
               "student":[
                   {"x": "1024", "y": "530", "width": "400", "height": "275"},
                   {"x": "1024", "y": "805", "width": "400", "height": "275"},
                   {"x": "1424", "y": "530", "width": "400", "height": "275"},
                   {"x": "1424", "y": "805", "width": "400", "height": "275"}
               ]
           },
           "menu":{
               "x":"1025",
               "y":"0"
           }
       },

Podmínky

Seznam podmínek ve výchozí podobě obsahuje tři položky:

• zobrazení prezentace - buď {"role":"presentation", "count":"1"} nebo {"role":"presentation", "count":"0"}
• počet studentů, dle nichž lze tvořit alternativní rozložení oken (při menším počtu např. v jedné řadě s většími rozměry oken, při větším počtu ve dvou řadách s menšími okny studentů.
  • Příklad 1: {"role":"student", "less":"5"} bude splněno, jestliže připojených studentů bude méně než 5
  • Příklad 2: {"role":"student", "more":"4"} bude splněno, jestliže připojených studentů bude 5 a více
• pro jakou uživatelskou roli je dané rozložení platné. Varianty jsou:
  • {"my role":"student"}
  • {"my role":"teacher"}
  • {"my role":"interpreter"}

Podmínky jsou uzavřeny ve složených závorkách ({ a }) a odděleny čárkou (,).

           "conditions":[
               {"role":"presentation", "count":"1"},
               {"role":"student", "less":"5"},
               {"my role":"student"}
           ],

Umístění oken

Definice umístění okna zahrnuje čtyři parametry, všechny v pixelech:

• x - horizontální pozici levého horního rohu okna,
• y - vertikální pozici levého horního rohu okna,
• width - šířku okna,
• height - výšku okna.

Příklad

       {"x": "1424", "y": "805", "width": "400", "height": "275"}

Pro role teacher, interpreter a presentation smí být vždy nejvýše jedna definice. Pro role student je možné specifikovat více pozic.

Pokročilé volby nastavení klienta CoUnSiL

Spuštění klienta s alternativním konfiguračním souborem

Je-li klient spuštěn bez parametru, bude konfigurační soubor vyhledán ve složce configs/. Je-li CoUnSiL klient instalován do adresáře Program Files, může nastat problém s oprávněním zápisu do konfiguračních souborů. Nejen pro tyto případy je možné zadat při spouštění cestu k alternativnímu konfiguračnímu souboru, jako argument programu.

 CoUnSiL.exe C:\Cesta\k\lternativnímu\konfiguracnimu\souboru\clientConfig.json

Fixní nastavení klienta pouze na roli Student

Pokud je klient nainstalován na počítačích, kde se budou připojovat pouze studenti (typicky v učebnách), je možné přidat do konfiguračního souboru speciální klíč student only s hodnotami true nebo false. Ten zajistí, že v uživatelském rozhraní bude možné zvolit pouze roli student. Jako jedinou, tuto volbu není možné nastavit v grafickém uživatelském rozhraní a je nutné ji dopsat do konfiguračního souboru přímo.

 "student only": true,