Özellikler
Mini Oyunlar (MiniGames)
Sınıf seviyesine göre açılan, oyun başına seviye ilerlemesi olan mini oyunlar.
Erişim, günlük oyun oturumunun tamamlanmasına bağlıdır. Tüm endpointler
Bearer ister; yollar /api/mini-games/...
ile başlar.
Kavramlar
| Kavram | Açıklama |
|---|---|
| Katalog | Kullanıcının grade'i için mini oyun listesi ve her oyunun kullanıcı durumu. |
| Oynanabilirlik gate'i | isUnlocked, isDailySessionCompleted, isEnabledForGrade birlikte isPlayable'ı belirler. |
| Seviye ilerlemesi | Her oyunun kendi currentLevel/maxLevel ve bestScore değeri. |
Mini oyun kodları (miniGameCode)
GET /api/mini-games yalnız aktif mini oyunları döndürür. POST /api/mini-games/{miniGameCode}/complete isteğinde bu kodlardan biri kullanılır.
| miniGameCode | Katalog adı |
|---|---|
VisualMemory | Visual Memory |
ShortTermMemory | Short Term Memory |
PeripheralVision | Peripheral Vision |
SharpVision | Sharp Vision |
SynonymWords | Synonym Words |
AntonymWords | Antonym Words |
TreasureHunting | Treasure Hunting |
ShapeMatching | Shape Matching |
ShapeCounting | Shape Counting |
Katalogda pasif duran WordCatch, WordLearning ve
ShortStories listede dönmez. Ödül para birimi varsayılan yapılandırmada Credits'tir.
Akış
Listeyi ve durumu oku
GET /api/mini-games
Katalog + oynanabilirlik gate'i + kullanıcı level state'i döner.
isPlayable=false ise (ör. günlük oturum bitmemiş) oyun
başlatılmamalıdır.
Oyunu tamamla
POST /api/mini-games/{miniGameCode}/complete
İstek gövdesi{
"clientAttemptIdentifier": "<istemci deneme kimliği>",
"attemptedLevel": 3,
"score": 850,
"durationSeconds": 42
}
Backend; başarı eşiğini, seviye atlamayı (didLevelUp,
levelBefore/levelAfter) ve küçük bir Credits
ödülünü (rewardCreditAmount) belirler. Ödül, ödül akışıyla
(pending → claim) alınır.
clientAttemptIdentifier ile idempotenttir; aynı deneme tekrar
gönderilirse isIdempotentReplay: true döner.