Ayar dosyası (JSON)

Studio'nun indirdiği dosya, cihazın GET ile döndürdüğü ve CFG ile kabul ettiği ayarlarla aynı biçimdedir.

{
  "version": 1,
  "name": "Refix",
  "character": "fire",
  "menuSlots": ["pomodoro", "clock", "balance"],
  "quote": "Bugün harika kod yazacağız!",
  "talk": "medium",
  "control": "hybrid",
  "sulk": true
}

Alanlar

Alan	Tür	Kural
`version`	sayı	Şimdilik `1`. Dosya biçiminin sürümüdür
`name`	metin	En fazla 48 bayt (UTF-8)
`character`	metin	`fire`, `water`, `earth` ya da `air`
`menuSlots`	dizi	Tam 3 eleman; her biri `pomodoro`, `clock`, `tracker`, `pingpong`, `balance` ya da `rhythm`. Tekrar edebilir. Oyunlar klasörü ve Ayarlar menüde hep vardır, slota konmaz
`quote`	metin	En fazla 128 bayt; boş olabilir
`talk`	metin	İsteğe bağlı (1.2.1+): `off`, `low`, `medium`, `high` — Konuşkanlık
`control`	metin	İsteğe bağlı (1.2.1+): `tilt`, `turn`, `hybrid` — sağ / sol eğerek mi, çevirerek mi
`sulk`	true / false	İsteğe bağlı (1.2.1+): cevapsız kalınca küsebilir mi

talk, control ve sulk dosyada yoksa cihazdaki değerler değişmez. 1.2.0 ve öncesi bu alanları yok sayar. name yalnızca konuşmalarda kullanılır; logo ve firmware adı her zaman Refix'tir.

Bayt mı, karakter mi?

Sınırlar bayt cinsindendir. İngilizce harfler ve rakamlar 1 bayt, Türkçe harfler (ç, ğ, ı, ö, ş, ü ve büyükleri) 2 bayt, çoğu emoji 4 bayt tutar. Örneğin “Çağrı” 5 harftir ama 8 bayttır.

Örnekler

Damla karakteri, iki oyun ve saat:

{"version":1,"name":"Damla","character":"water","menuSlots":["pingpong","balance","clock"],"quote":""}

Yalnızca pomodoro:

{"version":1,"name":"Odak","character":"earth","menuSlots":["pomodoro","pomodoro","pomodoro"],"quote":"Yavaş ama durmadan."}

Doğrulama hataları

Geçersiz bir dosya yüklediğinde Studio hatalı alanları tek tek listeler, örneğin:

“menuSlots” tam 3 eleman içermeli (şu an 2).
“character” bilinmiyor: “curious”. Geçerli değerler: fire, water, earth, air.
“name” en fazla 48 bayt olabilir (şu an 52).

Eski Studio sürümlerinin dosyalarındaki eyeStyle alanı artık kullanılmıyor. Böyle bir dosyayı yüklemek için eyeStyle yerine character alanını ekle.