Contrôler les couches du système depuis votre site web

Référence technique

Guide technique pour les développeurs web

Reliez vos boutons aux fonctions de navigation du système. Commencez par les conventions d’appel communes, puis consultez les fonctions et exemples de code.

Le lecteur fournit ces fonctions à un site ouvert dans l’application Site web. Vérifiez qu’une fonction est disponible avant de l’appeler, comme dans les exemples ci-dessous.

Fonctions de navigation disponibles

onUp

Demande un retour via la navigation du système. La destination dépend du mode de l’application web et du parcours disponible. Ce n’est pas un retour à l’URL précédente de l’historique du navigateur et cela n’équivaut pas à window.history.back(). Si le retour est impossible, la fonction signale l’erreur ci-dessous.

if (typeof window.onUp !== 'function') {
    console.warn("La fonction de navigation du lecteur est indisponible.");
} else {
    window.onUp({
        request: '{}',
        onSuccess: function () {
            console.log("La requête de navigation a été acceptée.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

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

showLayerBottom

Demande le menu de la couche applications. La liste doit contenir plusieurs éléments actuellement disponibles, compte tenu de leur validité planifiée. Si un seul élément ou aucun n’est disponible, la fonction signale l’erreur ci-dessous.

if (typeof window.showLayerBottom !== 'function') {
    console.warn("La fonction de navigation du lecteur est indisponible.");
} else {
    window.showLayerBottom({
        request: '{}',
        onSuccess: function () {
            console.log("La requête de navigation a été acceptée.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Erreur : error_code -1, Single-app kiosk.

showLayerTop

Demande la couche présentation. Celle-ci doit être activée dans la configuration de l’appareil ; sinon, la fonction signale l’erreur ci-dessous. L’acceptation ne confirme pas qu’une campagne précise a été diffusée ni que son contenu est disponible.

if (typeof window.showLayerTop !== 'function') {
    console.warn("La fonction de navigation du lecteur est indisponible.");
} else {
    window.showLayerTop({
        request: '{}',
        onSuccess: function () {
            console.log("La requête de navigation a été acceptée.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Erreur : error_code -1, Top layer disabled.