Controlar las capas del sistema desde su sitio web

Referencia técnica

Guía técnica para desarrolladores web

Conecte sus botones con las funciones de navegación del sistema. Empiece por las convenciones comunes de llamada y continúe con las funciones y los ejemplos.

El reproductor ofrece estas funciones a una web abierta en la aplicación Sitio web. Compruebe que la función está disponible antes de llamarla, como muestran los ejemplos siguientes.

Funciones de navegación disponibles

onUp

Solicita volver mediante la navegación del sistema. El destino depende del modo de la aplicación web y de la ruta disponible. No vuelve a la URL anterior del historial del navegador ni equivale a window.history.back(). Si no es posible volver, la función comunica el error siguiente.

if (typeof window.onUp !== 'function') {
    console.warn("La función de navegación del reproductor no está disponible.");
} else {
    window.onUp({
        request: '{}',
        onSuccess: function () {
            console.log("Se ha aceptado la solicitud de navegación.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

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

showLayerBottom

Solicita el menú de la capa de aplicaciones. Debe haber más de un elemento disponible en la lista, teniendo en cuenta su vigencia programada. Si solo hay uno o ninguno, la función comunica el error siguiente.

if (typeof window.showLayerBottom !== 'function') {
    console.warn("La función de navegación del reproductor no está disponible.");
} else {
    window.showLayerBottom({
        request: '{}',
        onSuccess: function () {
            console.log("Se ha aceptado la solicitud de navegación.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Error: error_code -1, Single-app kiosk.

showLayerTop

Solicita la capa de presentación. Debe estar habilitada en la configuración del dispositivo; de lo contrario, la función comunica el error siguiente. Aceptar la solicitud no confirma que se haya reproducido una campaña concreta ni que su contenido esté disponible.

if (typeof window.showLayerTop !== 'function') {
    console.warn("La función de navegación del reproductor no está disponible.");
} else {
    window.showLayerTop({
        request: '{}',
        onSuccess: function () {
            console.log("Se ha aceptado la solicitud de navegación.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Error: error_code -1, Top layer disabled.