Bloquear recursos pagos

Venda o app inteiro com Paywall.gate, ou alguns recursos com Paywall.start e uma verificação por recurso. Esta página lista cada chamada e constante pública da biblioteca, e como funcionam os testes.

App inteiro ou alguns recursos

Ambos recebem o mesmo array que você retornaria de getInitialView(): uma view, ou uma view e seu delegate.

Bloquear um recurso

Com start, verifique onde cada recurso pago começa: um botão, um item de menu, uma página.

function onHistory() as Void {
    if (Paywall.unlocked()) {
        showHistory();
    } else {
        Paywall.open();
    }
}

• Um cadeado abre tudo. Uma compra libera todos os recursos pagos do app. Há um preço por app.
• Num glance, chame só active(), unlocked() e trialLeft(). A tela de compra é só do app.
• Agradecimentos que devem aparecer só para compradores, e não durante o teste, verificam Paywall.active().

Referência

Tudo aqui fica em module Paywall (Pay.mc e o PayScope.mc que você usa), salvo indicação contrária na tabela.

Chamadas que você faz

Chamado pela própria biblioteca

A biblioteca chama estas sozinha. Não as chame do seu código.

Constantes

Variáveis do módulo

O estado da própria tela de compra. Leia se precisar; nunca os defina.

Classes

PaywallConfig

Mostradores e campos de dados

Mostradores e campos de dados usam lib/watch/face, cujo module Paywall tem chamadas próprias. active(), unlocked() e trialLeft() funcionam como acima.

A configuração completa está em Mostradores e campos de dados.

Testes

• Defina TRIAL_DAYS em PaywallConfig, igual ao teste grátis do seu painel. Omita para não ter teste: aí "Teste encerrado" nunca aparece.
• O teste começa na primeira abertura. Paywall.unlocked() é true até ele terminar.
• Reinstalar nunca o reinicia. Nosso servidor conta o período de teste desde a primeira vez que viu aquele relógio, e a contagem dele substitui a do relógio na primeira resposta.
• Atrasar a hora não estica o prazo. O servidor envia o tempo restante, não uma data, e o relógio nunca conta mais dias que TRIAL_DAYS.
• O título da tela de compra mostra "Faltam 7 dias", depois "Último dia", depois "Teste encerrado".

Um teste que seu app conta

Para um teste por uso em vez de dias, omita TRIAL_DAYS, mantenha seu próprio contador no armazenamento (e através de "Excluir dados") e verifique active():

// 20 free sessions, then Premium
if (Paywall.active() || sessionsUsed < 20) {
    startSession();
} else {
    Paywall.open();
}

O que a biblioteca guarda

• Apps: "pa" (a resposta), "pp" (quando "pago" foi confirmado pela última vez), "ts" (o fim do teste) e "te" ("Teste encerrado" exibido).
• Mostradores e campos de dados: "pa", "pp", "ts" e "pg", mais a propriedade unlock para o link nas configurações.
• Use outros nomes para suas próprias chaves.