Controlar as camadas do sistema a partir do seu website

Referência técnica

Guia técnico para programadores web

Ligue os seus botões às funções de navegação do sistema. Comece pelas convenções comuns de chamada e avance para as funções e os exemplos de código.

O leitor fornece estas funções a um website aberto na aplicação Website. Verifique se a função está disponível antes de a chamar, como mostram os exemplos abaixo.

Funções de navegação disponíveis

onUp

Pede um regresso através da navegação do sistema. O destino depende do modo da aplicação web e do percurso disponível. Não é um regresso ao URL anterior do histórico do navegador nem equivale a window.history.back(). Se não for possível regressar, a função comunica o erro abaixo.

if (typeof window.onUp !== 'function') {
    console.warn("A função de navegação do leitor não está disponível.");
} else {
    window.onUp({
        request: '{}',
        onSuccess: function () {
            console.log("O pedido de navegação foi aceite.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Erro: error_code -1, Disabled bottom layer. Single-app kiosk.

showLayerBottom

Pede o menu da camada de aplicações. Tem de existir mais de um item atualmente disponível na lista, tendo em conta a validade agendada. Se existir apenas um ou nenhum, a função comunica o erro abaixo.

if (typeof window.showLayerBottom !== 'function') {
    console.warn("A função de navegação do leitor não está disponível.");
} else {
    window.showLayerBottom({
        request: '{}',
        onSuccess: function () {
            console.log("O pedido de navegação foi aceite.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Erro: error_code -1, Single-app kiosk.

showLayerTop

Pede a camada de apresentação. Esta tem de estar ativada na configuração do dispositivo; caso contrário, a função comunica o erro abaixo. A aceitação do pedido não confirma que uma campanha específica tenha sido reproduzida nem que os conteúdos estejam disponíveis.

if (typeof window.showLayerTop !== 'function') {
    console.warn("A função de navegação do leitor não está disponível.");
} else {
    window.showLayerTop({
        request: '{}',
        onSuccess: function () {
            console.log("O pedido de navegação foi aceite.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Erro: error_code -1, Top layer disabled.