Vientimuoto

Vienti, joka kuuluu Deskami Plusiin, kirjoittaa saman minuutti minuutilta etenevän kirjanpidon, jota Deskami säilyttää Macillasi. Mitään ei lisätä, arvioida eikä täydennetä. Tämä sivu kuvaa, mitä tiedostossa on.

Käytännöt

Tyhjä solu CSV:ssä tai null JSONissa tarkoittaa ei mitattu. 0 tarkoittaa mitattu, ja tulos oli nolla.
Sarakkeiden nimet ovat kaikilla kielillä englanniksi ja kiinteät; ne muuttuvat vain silloin, kun export_version vaihtuu.
Tiedostot ovat UTF-8-muodossa. CSV on pilkuin eroteltu, ja siinä on otsikkorivi.
Ajat ovat UTC-aikaa ISO 8601 -muodossa, esimerkiksi 2026-09-28T07:41:00Z. Päivämäärät ovat muotoa YYYY-MM-DD: kalenteripäivä, jolle minuutti kirjattiin.
Desimaalierottimena on piste, eikä tuhaterotinta käytetä koskaan. Totuusarvot ovat true ja false.
Jokaisesta minuutista, jolloin Deskami kirjasi jotain, on yksi rivi, eikä riviä ole minuuteista, joina se ei kirjannut mitään.

Minuuttisarakkeet

CSV:ssä on nämä sarakkeet tässä järjestyksessä; JSONissa samat kentät muodostavat kunkin minuutin. Sulkeissa oleva nimi on sarake raakatietokantatiedostossa.

minute_utc – aika. Minuutin alku UTC-aikana. (minute_utc, Unix-sekunteina)
local_day – päivämäärä. Kalenteripäivä, johon minuutti kuuluu, sen aikavyöhykkeen mukaan, jolla Mac oli sillä hetkellä. Se lukitaan kirjoitettaessa; myöhempi aikavyöhykkeen vaihto ei siirrä sitä. (day_key)
setup_id – kokonaisluku. Käytössä ollut kokoonpano: kamera ja näyttöjen asettelu yhdessä. JSONissa kokoonpanot on lueteltu kohdassa setups. (profile_id)
seconds_at_desk – 0–60. Sekunnit, joina kamera näki sinut tämän minuutin aikana. Kun camera_off on false, 0 tarkoittaa, että kamera oli päällä eikä nähnyt sinua. (present_s)
posture_deviation – luku, 0 tai enemmän. Kuinka paljon pääsi ja olkapääsi olivat oman vertailukohtasi alapuolella minuutin keskiarvona, ilmaistuna sillä hetkellä voimassa olleen muistutuskynnyksen monikertana: 0 vertailukohdassa, 1 kynnyksen kohdalla. Tyhjä, kun ryhtiä ei mitattu. (posture_dev)
posture_peak – luku, 0 tai enemmän. Saman mittarin suurin arvo minuutin sisällä. (posture_peak)
distance_deviation – luku, 0 tai enemmän. Kuinka paljon lähempänä näyttöä kasvosi olivat kuin vertailukohdassa, samalla asteikolla, luettuna silmiesi välisestä etäisyydestä kuvassa. (distance_dev)
blinks – kokonaisluku. Räpäytykset, jotka laskettiin silmien ollessa mitattavissa. Tyhjä, kun ne eivät olleet. (blinks)
incomplete_blinks – kokonaisluku. Räpäytykset, joissa silmä ei kapeimmillaankaan käynyt tarpeeksi lähellä kiinni. Tyhjä, kun arviointi ei ollut mahdollista. (incomplete_blinks)
head_pitch_degrees – luku. Pään keskimääräinen kallistus eteen tai taakse asteina kameran ilmoittamana: suhteessa kameraan, ei vertailukohtaasi. (head_pitch)
confidence – 0–1. Kasvojen havaitsemisen keskimääräinen varmuus. (confidence)
light – 0–1. Kasvojen alueen keskimääräinen kirkkaus, 0 on tumma ja 1 kirkas. Ei huoneen valoisuus. (light)
eyes_measured – totuusarvo. Silmät voitiin mitata ainakin kerran tämän minuutin aikana. Kun arvo on false, blinks, incomplete_blinks ja eye_observed_seconds ovat tyhjiä. (eye_valid)
eye_observed_seconds – 0–60. Sekunnit, joina silmiä todella seurattiin. Räpäytykset minuutissa ovat blinks × 60 ÷ eye_observed_seconds. (eye_observed_s)
look_aways – kokonaisluku. Loppuun asti tehdyt katseet kauas, 20-20-20-tapa. Tyhjä, kun kauas katsomista ei mitattu. (gaze_breaks)
camera_off – totuusarvo. Kamera oli pois päältä tämän minuutin ajan: sammutit sen, toinen sovellus käytti sitä tai käyttöoikeus poistettiin. Kamerasarakkeet ovat silloin tyhjiä; sovellus- ja aktiivisuussarakkeet voivat silti olla täytettyjä. (camera_off)
declared_break – totuusarvo. Kerroit Deskamille olevasi tauolla. Minuutti lasketaan poissaoloksi pöydän äärestä riippumatta siitä, mitä kamera näki. (declared_break)
front_app – teksti. Minuutin suurimman osan edessä olleen sovelluksen pakettitunniste (bundle identifier), esimerkiksi com.apple.Safari. Tyhjä, kun tuo lukema oli pois päältä, näyttö oli lukittu tai mitään ei ollut edessä. Ei koskaan ikkunan otsikko. (app_id)
app_switches – kokonaisluku. Kuinka monta kertaa edessä oleva sovellus vaihtui tämän minuutin aikana. (app_switches)
active_seconds – 0–60. Sekunnit, joina näppäimistöön tai hiireen oli koskettu edeltävien 15 sekunnin aikana. Vain viimeisestä tapahtumasta kulunut aika luetaan, ei koskaan näppäimiä. Tyhjä, kun tuo lukema oli pois päältä. (active_s)
call_seconds – 0–60. Sekunnit, joina puhelusovellus oli edessä tai yhdellä sovelluksella oli mikrofoni ja kaiutin auki yhtä aikaa. Tyhjä, kun tätä ei mitattu, myös jokaisen minuutin kohdalla, joka kirjattiin ennen kuin Deskami alkoi mitata tätä. (meeting_s)

JSON

JSON-tiedosto on yksi objekti. Se alkaa otsakkeella: export_version, app_version, exported_at, time_zone (viennin hetkellä), database_schema_version, range (kind, from, to) ja setups (id, camera_name, created_at).

Sen jälkeen tulee days, yksi objekti jokaista aikavälin kirjattua päivää kohden. Jokaisella päivällä on oma koosteensa, minuuttinsa ja muistutuksensa:

local_day ja minutes_at_desk eli seconds_at_desk-arvojen summa jaettuna 60:llä.
breaks: vähintään 5 minuutin ja alle 2 tunnin jaksot poissa pöydän äärestä kahden pöydän ääressä vietetyn jakson välissä. Aikaa, jolloin kamera oli pois päältä, ei lasketa kumpaankaan.
posture_fine_minutes (posture_deviation alle 1) ja posture_attention_minutes (1 tai enemmän).
blink_rate: räpäytykset minuutissa ajalta, jona silmiä seurattiin; null, jos seurantaa oli alle minuutti.
incomplete_blink_ratio: null, kun arvioitavia räpäytyksiä oli liian vähän.
reminders_by_signal: näytetyt muistutukset signaaleittain laskettuina.
minutes: yllä kuvatut minuuttisarakkeet, yksi objekti minuuttia kohden.
reminders: yksi objekti muistutusta kohden, kentät time_utc, local_day, setup_id, signal (posture, distance, blink, incompleteBlink tai gaze), build_up_seconds (aika kynnyksen yläpuolella ennen muistutusta), recover_seconds (aika takaisin kynnyksen alle; null, jos mittaus loppui ensin), asked (näytettiinkö kysymys vertailukohdastasi) ja answer (null, jos kysymystä ei esitetty, muuten true tai false).

PDF

PDF ei ole taulukko: se on itse kooste – päivän kooste, viikko tai kuukausi – tulostettuna yhdelle sivulle täsmälleen sellaisena kuin se näkyy näytöllä. Jokainen sen luku on sama kuin näytöllä.

Raakatiedosto

Asetukset › Yleiset › Tiedot › Näytä Finderissa tuo esiin tiedoston history.sqlite, jonka vieressä ovat history.sqlite-wal ja history.sqlite-shm. Kun Deskami on käynnissä, uusimmat minuutit voivat olla vielä -wal-tiedostossa; kopioi kaikki kolme tiedostoa tai lopeta Deskami ensin. Jos poistat ne Deskamin ollessa käynnissä, se aloittaa muutamassa sekunnissa uuden, tyhjän kirjanpidon. Vienti kirjoittaa aina täydellisen tilannekuvan. Se, mitä tietokanta sisältää, on lueteltu tietosuojasivulla.