Configuração de orientação de tela: Modo paisagem e retrato)

A SDK Tap on Phone oferece controle sobre a orientação da tela durante as transações. A aplicação pode ser configurada para funcionar apenas em modo retrato (padrão) ou habilitando modo paisagem, que será automaticamente ajustado conforme as capacidades do dispositivo.

Como configurar

  1. Prepare a Configuração (ConfigBuilder), ao inicializar a SDK, use o método isEnableLandscape() no ConfigBuilder:
val config = ConfigBuilder(context)
    .initClient(clientID, clientSecret)
    .setCPF("12345678900")  // ou .setCNPJ("...")
    .isEnableLandscape(true)  // Habilita tentativa de modo paisagem
    .loadWhiteLabel("seu_arquivo.json")  // Opcional
  1. Inicialize a SDK, passe a configuração preparada para o método initialize():
TapOnPhone.initialize(
    context = this,
    config = config,
    onInitializeSuccess = {
        // Prosseguir com pagamento
    },
    onInitializeFailure = { error ->
        // Tratar erro
    }
)

Comportamento automático

A SDK aplica as seguintes regras automaticamente durante a inicialização:

CenárioResultado
isEnableLandscape(false) ou não configuradoForça modo Retrato
isEnableLandscape(true) + Tablet (≥ 600dp)Usa modo Paisagem
isEnableLandscape(true) + Smartphone (< 600dp)Força modo Retrato (proteção)

Observações

  • A orientação é resolvida uma única vez durante a inicialização;
  • Smartphones (< 600dp) sempre forçam retrato, mesmo com isEnableLandscape(true), para proteger a experiência do usuário;
  • Tablets (≥ 600dp) podem usar paisagem se habilitado;
  • Configuração padrão é retrato, recomendado para a maioria dos casos.


Did this page help you?