Pakopaneeli – ohjeet ohjaajalle
================================

Pakopaneeli on pakohuoneen ohjausohjelma. Pääsivulla näkyy pelaajille aika,
vinkki ja video. Ohjaussivulta ohjaaja käynnistää pelin, lähettää vinkkejä
ja toistaa ääniä sekä videoita.


Asennus zip-tiedostosta
-----------------------

1. Lataa pakopaneeliApp-<versio>.zip GitHubin Releases-sivulta (esim. pakopaneeliApp-3.0.3.zip)
   ja pura se kansioon, esimerkiksi Työpöydälle. Älä käynnistä tiedostoja suoraan zipistä.
2. Pura-kansiossa pitää olla ainakin:
     pakopaneeli-server.exe
     pakopaneeli.ico
     install-service.bat
     OHJEET.txt
3. Kaksoisklikkaa install-service.bat.
   Asennus kopioi ohjelman kansioon:

     C:\Users\<käyttäjä>\AppData\Roaming\Pakopaneeli

   ja luo Käynnistä-valikkoon sekä Windowsin käynnistykseen
   pikakuvakkeen "Pakopaneeli". Ohjelma käynnistyy jatkossa automaattisesti
   kun kirjaudut Windowsiin. Käynnistä heti: Käynnistä-valikko → Pakopaneeli.
4. Jos Windows varoittaa tuntemattomasta julkaisijasta, valitse
   "Lisätietoja" ja "Suorita silti".
5. Asennuksen jälkeen voit poistaa zipin ja purkamasi kansion.

Päivitys: pura uusi zip ja aja install-service.bat uudelleen.
Se korvaa vanhan pakopaneeli-server.exe-tiedoston (tai legacy metka-server.exe).

Ilman asennusskriptiä voit myös kaksoisklikata pakopaneeli-server.exe
purkamassasi kansiossa (ohjelma ei tällöin käynnisty automaattisesti
kirjautumisen yhteydessä).


Käynnistys
----------

1. Käynnistä Pakopaneeli (Käynnistä-valikko).
2. Avaa selaimessa kaksi sivua:

   Pääsivu (pelaajien näyttö):   http://localhost:5000/
   Ohjaussivu:                   http://localhost:5000/control

Jos ohjelma pyörii toisella koneella, vaihda "localhost" sen koneen
nimeen tai IP-osoitteeseen.

Pääsivulla paina ensin "Paina tästä aloittaaksesi". Tämä avaa äänen ja
videon toiston selaimessa. Ilman tätä klikkausta video ei välttämättä
käynnisty.


Ajanotto
--------

Aloita / Jatka     Käynnistää tai jatkaa laskuria.
Ajan pysäytys      Pysäyttää laskurin.
Nollaa             Palauttaa ajan alkuarvoon ja tyhjentää vinkin.
Lisää minuutti (+) Lisää minuutin jäljellä olevaan aikaan.
Vähennä minuutti (-) Vähentää minuutin. Painike ei ole käytössä, jos
                   aikaa on alle minuutti.
Piilota aika       Piilottaa kellon pääsivulta (logo suurenee).
Näytä aika         Palauttaa kellon näkyviin.

Muuta aloitus aikaa
  Kirjoita minuutit kenttään ja paina "Muuta aloitus aikaa".
  Oletusaika on 90 minuuttia. Aikaa ei voi muuttaa pelin ollessa
  käynnissä tai tauolla.


Vinkit
------

Kirjoita vinkki kenttään "Syötä vinkki tähän" ja paina "Lähetä vinkki".
Vinkki näkyy pääsivulla kellon alla. Nollaus tyhjentää vinkin.


Äänimerkit
----------

Laita .mp3-tiedostot kansioon:

  C:\Users\<käyttäjä>\Music\Pakopaneeli

Käynnistä palvelin uudelleen tai avaa ohjaussivu uudelleen, jotta uudet
tiedostot näkyvät. Jokaisesta tiedostosta tulee painike. Painallus
toistaa äänen pääsivulla. Uusi painallus pysäyttää sen.


Videot
------

Video peittää pääsivun koko näytön. Laskuri jatkaa taustalla. Videon
käynnistys pysäyttää mahdollisen äänimerkin.

Tuetut tiedostomuodot: mp4, webm, ogg.

Valmiit videot kansiosta
  Laita videotiedostot kansioon:

    C:\Users\<käyttäjä>\Videos\Pakopaneeli

  Palvelin luo kansion tarvittaessa. Tiedostot näkyvät ohjaussivulla
  painikkeina. Painallus aloittaa videon pääsivulla. Sama painike
  pysäyttää sen.

Valitse tiedosto
  Valitse video koneen levyltä. Tiedosto ladataan Videos\Pakopaneeli -kansioon
  ja toisto alkaa pääsivulla. Lataus voi kestää isolla tiedostolla.
  Enimmäiskoko on 1 Gt. Pysäytys: paina videotiedoston nimeä.

Pysäytys
  Paina soivan videon nimeä. Video sulkeutuu myös, kun tiedosto päättyy.

Huomioita
  - Pääsivulla pitää olla klikattu "Paina tästä aloittaaksesi".


Vianetsintä
-----------

Pääsivu ei näytä videota
  Varmista, että pääsivulla on painettu "Paina tästä aloittaaksesi"
  ja että sekä pääsivu että ohjaussivu ovat auki samaan palvelimeen.

Videopainikkeita ei näy
  Tarkista, että tiedostot ovat kansiossa Videos\Pakopaneeli ja että
  pääte on .mp4, .webm tai .ogg. Päivitä ohjaussivu.

Äänipainikkeita ei näy
  Tarkista kansio Music\Pakopaneeli ja että tiedostot ovat .mp3.

Lataus epäonnistui
  Käytä vain mp4-, webm- tai ogg-tiedostoja. Tiedosto ei saa olla
  yli 1 Gt.
