Skip to content

Configurazione dell'accesso

Usa la proprietà access per controllare a quali superfici di gioco possono accedere gli utenti e il motivo per cui vengono bloccati quando non possono farlo.

Esempio base

js
MindtrainingPlatform.init('mindtraining', {
  access: {
    games: {
      crossword: {
        default: {
          playToday: true,
          playArchive: false,
          saveState: true,
          blockedReason: 'subscription_required',
        },
      },
      sudoku: {
        default: {
          playToday: true,
          playArchive: true,
          saveState: true,
        },
      },
    },
  },
})

Proprietà della policy di accesso

Ogni voce di gioco ha una policy default e una mappa variants opzionale per le override per variante.

ProprietàTipoPredefinitoDescrizione
playTodaybooleantrueConsente di giocare il gioco di oggi
playArchivebooleantrueConsente di consultare l'archivio
saveStatebooleantrueConsente di salvare e riprendere la progressione
blockedReasonstringMotivo mostrato quando l'accesso viene negato (vedi sotto)
blockedReasonsobjectMotivi di blocco per superficie (sovrascrive blockedReason)
meterLimitobjectLimita il numero di avvii in una finestra temporale mobile
levelLimitobjectLimita l'accesso oltre un certo livello di difficoltà

Motivi di blocco

ValoreSignificato
"login_required"L'utente deve effettuare il login
"subscription_required"L'utente deve avere un abbonamento attivo
"variant_locked"Questa variante è bloccata
"host_rule"Bloccato da una regola di business del sito

Motivi di blocco per superficie

Se hai bisogno di messaggi diversi per il gioco di oggi e per l'archivio, usa blockedReasons:

js
crossword: {
  default: {
    playToday: true,
    playArchive: false,
    blockedReasons: {
      archive: 'subscription_required',
    },
  },
}

Meter limit (paywall misurato)

Consenti un numero limitato di avvii gratuiti in una finestra temporale mobile:

js
crossword: {
  default: {
    playToday: true,
    playArchive: true,
    meterLimit: {
      maxStarts: 5,      // massimo numero di avvii consentiti
      intervalDays: 30,  // finestra mobile in giorni
    },
    blockedReason: 'subscription_required',
  },
}

Cosa sono le varianti?

Una variant è una versione dello stesso tipo di gioco con categorie o caratteristiche di contenuto diverse: stesse regole, sapore differente. Per esempio, crossword può avere varianti come mini (griglia più piccola), kids (vocabolario semplice) o sports (definizioni a tema sportivo). Ogni variante condivide lo stesso motore di gioco, ma viene trattata come una superficie di accesso distinta.

Le varianti sono identificate da uno string ID configurato lato piattaforma. Quando non esiste una policy specifica per la variante, si applica la policy default.

Override a livello di variante

Applica una policy diversa a una variante specifica mantenendo default per tutto il resto:

js
crossword: {
  default: {
    playToday: true,
    playArchive: false,
    blockedReason: 'subscription_required',
  },
  variants: {
    mini: {
      // Il mini crossword è gratuito: override del default
      playToday: true,
      playArchive: true,
    },
    kids: {
      // La variante kids richiede login ma non abbonamento
      playToday: true,
      playArchive: false,
      blockedReason: 'login_required',
    },
  },
}

Tipi di gioco supportati

  • connect4
    Abbina parole a 4 personaggi o oggetti; ogni elemento è mostrato come immagine con una parola sotto.

  • crossmath
    Griglia stile cruciverba in cui le celle vengono riempite con espressioni matematiche invece che con lettere.

  • crossword
    Classico cruciverba con definizioni per parole che si incrociano.

  • crossword_mini
    Cruciverba più corto e veloce.

  • difference
    Gioco delle differenze: trova 8 differenze tra due immagini simili.

  • memory
    Gioco di abbinamento carte: gira le carte per trovare le coppie.

  • number
    Puzzle numerico (per esempio sequenze, logica o aritmetica).

  • puzzle
    Puzzle generico (jigsaw, logica o simile).

  • quiz
    Quiz di conoscenza con domande e risposte.

  • self_defined
    Cruciverba in cui ogni cella contiene la propria definizione o indizio.

  • seven_letters
    Gioco in stile Spelling Bee: forma parole da un set di 7 lettere, con una lettera centrale obbligatoria.

  • sudoku
    Puzzle su griglia 9×9: riempi ogni riga, colonna e box 3×3 con cifre da 1 a 9.

  • tiles
    Gioco di tessere da abbinare: trova coppie o gruppi su un tabellone con molti elementi.

  • timeline
    Ordina eventi, date o elementi nella corretta sequenza cronologica.

  • word
    Indovina una parola nascosta in un numero limitato di tentativi.

  • word_links
    Collega parole che appartengono alla stessa famiglia o categoria.

  • word_search
    Trova parole nascoste in una griglia di lettere (orizzontale, verticale o diagonale).

Client integration documentation maintained in-repo.