Skip to content

Configuração de acesso

Use a propriedade access para controlar quais superfícies de jogo os utilizadores podem aceder e por que motivo ficam bloqueados quando não o podem fazer.

Exemplo básico

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,
        },
      },
    },
  },
})

Propriedades da política de acesso

Cada entrada de jogo tem uma política default e um mapa variants opcional para sobrescritas por variante.

PropriedadeTipoPredefinidoDescrição
playTodaybooleantruePermite jogar o jogo de hoje
playArchivebooleantruePermite navegar no arquivo
saveStatebooleantruePermite guardar e retomar o progresso
blockedReasonstringMotivo apresentado quando o acesso é negado (ver abaixo)
blockedReasonsobjectMotivos de bloqueio por superfície (sobrescreve blockedReason)
meterLimitobjectLimita o número de inícios de jogo numa janela móvel
levelLimitobjectLimita o acesso acima de um determinado nível de dificuldade

Motivos de bloqueio

ValorSignificado
"login_required"O utilizador tem de iniciar sessão para aceder
"subscription_required"O utilizador tem de ter uma subscrição ativa
"variant_locked"Esta variante do jogo está bloqueada
"host_rule"Bloqueado por uma regra de negócio do site

Motivos de bloqueio por superfície

Se precisar de mensagens diferentes para o jogo de hoje e para o arquivo, use blockedReasons:

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

Meter limit (paywall medido)

Permita um número limitado de inícios gratuitos dentro de uma janela móvel:

js
crossword: {
  default: {
    playToday: true,
    playArchive: true,
    meterLimit: {
      maxStarts: 5,      // número máximo de inícios permitidos
      intervalDays: 30,  // janela móvel em dias
    },
    blockedReason: 'subscription_required',
  },
}

O que são variantes?

Uma variant é uma versão do mesmo tipo de jogo com categorias de conteúdo ou características diferentes: mesmas regras, contexto diferente. Por exemplo, crossword pode ter variantes como mini (grelha mais pequena), kids (vocabulário simples) ou sports (pistas com tema desportivo). Cada variante partilha o mesmo motor de jogo, mas é tratada como uma superfície de acesso separada.

As variantes são identificadas por um string ID configurado do lado da plataforma. Quando não existe uma política específica para a variante, aplica-se a política default.

Sobrescritas ao nível da variante

Aplique uma política diferente a uma variante específica, mantendo default para tudo o resto:

js
crossword: {
  default: {
    playToday: true,
    playArchive: false,
    blockedReason: 'subscription_required',
  },
  variants: {
    mini: {
      // O mini crossword é gratuito: sobrescreve o default
      playToday: true,
      playArchive: true,
    },
    kids: {
      // A variante kids exige login, mas não subscrição
      playToday: true,
      playArchive: false,
      blockedReason: 'login_required',
    },
  },
}

Tipos de jogo suportados

  • connect4
    Relaciona palavras com 4 personagens ou objetos; cada elemento é apresentado como imagem com uma palavra por baixo.

  • crossmath
    Grelha em estilo palavras cruzadas em que as células são preenchidas com expressões matemáticas em vez de letras.

  • crossword
    Palavras cruzadas clássicas com pistas para palavras que se cruzam.

  • crossword_mini
    Versão mais curta e rápida de palavras cruzadas.

  • difference
    Jogo das diferenças: encontra 8 diferenças entre duas imagens semelhantes.

  • memory
    Jogo da memória: vira cartas para encontrar pares.

  • number
    Puzzle baseado em números (por exemplo, sequências, lógica ou aritmética).

  • puzzle
    Puzzle genérico (quebra-cabeças, lógica ou semelhante).

  • quiz
    Quiz de conhecimento com perguntas e respostas.

  • self_defined
    Palavras cruzadas em que cada célula contém a sua própria definição ou pista.

  • seven_letters
    Jogo ao estilo Spelling Bee: forma palavras a partir de um conjunto de 7 letras, com uma letra central obrigatória.

  • sudoku
    Puzzle em grelha 9×9: preenche cada linha, coluna e caixa 3×3 com dígitos de 1 a 9.

  • tiles
    Jogo de emparelhar peças: encontra pares ou grupos num tabuleiro com muitos elementos.

  • timeline
    Ordena eventos, datas ou itens na sequência cronológica correta.

  • word
    Adivinha uma palavra escondida num número limitado de tentativas.

  • word_links
    Liga palavras que pertencem à mesma família ou categoria.

  • word_search
    Encontra palavras escondidas numa grelha de letras (horizontal, vertical ou diagonal).

Client integration documentation maintained in-repo.