RaceResult

  • Na záložke RaceResult sa udalosť prepojí s udalosťou v RaceResult - jedno prepojenie pre impulzy, časomieru aj overlay
  • Prepojenie je API link simpleapi/get - zoznam Simple API linkov udalosti, z ktorého si aplikácia nájde všetko ostatné
  • Link je možné vložiť ručne, alebo ho aplikácia vytvorí sama aj so všetkými API a webhookmi - bez API Creatora

Vloženie linku

  1. V časti API link vyberte Enter the link
  2. Vložte link simpleapi/get do API link (simpleapi/get)
  3. Kliknite na Load

Warning

Link cez http:// nie je šifrovaný a jeho prístupový kľúč je možné zachytiť - v cloude používajte https://

Vytvorenie API

  1. Vyberte Log in to RaceResult and create the APIs
  2. Skontrolujte Server - predvolene events.raceresult.com, tlačidlo Use cloud default ho vráti
  3. Zadajte User a Password, alebo prepnite na API key
  4. Kliknite na Log in and create API
  5. Vyberte udalosť v RaceResult (pole Search zoznam filtruje) a kliknite na Next: choose APIs
  6. Zakliknite API, ktoré udalosť potrebuje, a kliknite na Create
  • Aplikácia v udalosti v RaceResult vytvorí vybrané Simple API linky, prípadne webhooky pre overlay, uloží link api a hneď sa odhlási
  • Nastavenie najprv porovná, čo v udalosti už je:
    • čo chýba, sa vytvorí
    • čo je nastavené inak, sa opraví
    • čo je správne, sa nechá tak, aj s prístupovými kľúčmi
  • Možnosť Rename APIs and webhooks older tools created premenuje API a webhooky z Time Makera, Race Timera a RaceView (manual, starts, raceview_splits, …) na nové názvy msky_… - kľúče zostanú
  • Všetko ostatné v udalosti zostáva nedotknuté

Important

Prihlasovacie údaje do RaceResult sa nikam neukladajú. Prihlásenie trvá len jednu úlohu - vytvorenie API alebo odstránenie prepojenia - a po jej dokončení alebo zrušení sa aplikácia odhlási

Tip

Keďže opakované vytvorenie nič správne neprepisuje, je možné ho spustiť aj počas preteku na overenie prepojenia

Lokálna verzia

  • V lokálnej verzii sa aplikácia pripája na RaceResult server v mieste podujatia - do poľa Server zadajte jeho adresu, napríklad 192.168.1.20
  • Tlačidlo je Connect and create API - bez prihlásenia, server v mieste podujatia odpovedá aj bez neho
  • Link môže byť aj cez http://, ak server nemá certifikát
  • Webhooky pre overlay smerujú na počítač s lokálnou verziou - nahradia tie, ktoré nastavil cloud

Important

Prihlásenie na RaceResult server v mieste podujatia ho zhodí - preto sa lokálna verzia neprihlasuje

API

SkupinaAPINa čo
Commonapizoznam všetkých Simple API - povinné
Impulses (Time Maker)msky_manualodosielanie impulzov a ručných časov
msky_pointszoznam meracích bodov pre výber v zariadeniach a ručných časoch
msky_search, msky_invalidzneplatnenie impulzov
msky_bibszoznam čísel pre šablóny ručných časov
Timer (Race timer)msky_mainnázov a typ udalosti pre časomieru
msky_contestsúťaže a ich štartové časy
Individual startsmsky_startsindividuálne štarty
Results presenter (small timer)msky_multirequest, msky_presentersprezentér výsledkov pod malým časovačom
Overlays (RaceView)msky_splits, msky_finishersmedzičasy a cieľ pre overlay, aj s webhookmi

Individual starts

  • Pole Start time field (seconds) určuje, v ktorom poli má udalosť v RaceResult štartové časy pre displej štartov - v sekundách dňa
  • Prázdne = predvolené Start.ToD.Decimal
  • Zmena sa do API msky_starts dostane až opätovným vytvorením API

Uploading impulses

  • Send impulses and manual times to RaceResult - zapína odosielanie. Vypnuté = impulzy sa ukladajú, ale čakajú (stav Held)
  • Notify about failed uploads - pri neúspešnom odoslaní sa zobrazí upozornenie
  • Do RaceResult ide jeden impulz za sekundu - limit RaceResult

API status

  • Tabuľka ukazuje každé API, jeho názov v RaceResult a stav - Loaded, Off alebo Not found
  • API, ktoré nástroj pred ním vytvoril pod starým názvom, je označené - opätovné vytvorenie ho premenuje
  • Pod tabuľkou sú meracie body a udalosť v RaceResult
  • Tlačidlo Reload zoznam API načíta znova - aplikácia si ho pamätá, takže ho použite po ručnej zmene API v RaceResult

Overlay webhooks

  • RaceResult posiela medzičasy a cieľ webhookmi do overlay a prvého v cieli do časomiery
  • Webhooky sa vytvoria pri vytvorení API so zakliknutými Overlays
  • Webhook key overuje webhooky - Regenerate ho vymení: do overlay potom nič nepríde, kým sa API nevytvorí znova
  • To add them by hand in RaceResult - adresy webhookov s názvami a poľami pre ručné pridanie
  • Field expressions for this event - polia pre Timing point, Split time a Finish time tejto udalosti, prázdne = predvolené. Do RaceResult sa dostanú vytvorením API

Odstránenie prepojenia

  • Tlačidlo Remove overlay connection z udalosti v RaceResult odstráni webhooky a API overlay - opäť cez prihlásenie
  • Ak sa do udalosti už nedá prihlásiť, zobrazí sa Forget the connection anyway, ktoré prepojenie zruší len v MSky Timing a vymení webhook key - webhooky, ktoré v RaceResult zostali, už nič nezapíšu