Документација / Интеграции и создавање содржини / Управување со системските слоеви од Вашата веб-страница

Управување со системските слоеви од Вашата веб-страница

Вовед и основни насоки

Поврзете ги копчињата на Вашата веб-страница со навигацијата меѓу слоевите на системот.

Кога да ги користите овие функции

Овие JavaScript-функции ѝ се достапни на Вашата веб-страница кога таа е отворена на уредот преку апликацијата Веб-страница. Развивачот на Вашата веб-страница — или Вие, ако самите ја развивате — може да ги поврзе со сопствени копчиња во страницата, за посетителите да го отвораат менито со апликации или да преминуваат на репродукција на кампањи.

Ова е корисно кога сакате да ја прикажувате веб-страницата на цел екран без системските контроли и да ја вклопите навигацијата меѓу слоевите во сопствениот дизајн. Примерот прикажува мапа како стандардна апликација, покрај мени со други апликации.

Сопствени копчиња во вградена веб-страница

1 — Мени: сопствено копче на веб-страницата го отвора менито со апликации во Апликацискиот слој, овозможувајќи им на посетителите да ја напуштат мапата и да изберат друга апликација. showLayerBottom

2 — Реклами: сопствено копче на веб-страницата префрла на Презентацискиот слој со кампањи. showLayerTop

Имињата и изгледот на копчињата се примери. Развивачот или добавувачот на веб-страницата ги додава во вградената страница. За подробности за имплементацијата, видете ги функциите за навигација и примерите со код подолу.

За отворање на менито мора во моментот да бидат достапни повеќе од една апликација; за преминување на реклами мора да биде вклучен Презентацискиот слој. Секогаш тестирајте ја предвидената навигација на целниот уред.

За кого е наменето упатството и кој за што е одговорен

  • Добавувачот на платформата ги обезбедува функциите за навигација на плеерот и документира како се користат.
  • Клиентот ја избира веб-страницата што се прикажува во апликацијата Веб-страница и ги договара потребните контроли со нејзиниот добавувач.
  • Добавувачот или развивачот на вградената веб-страница ја менува самата веб-страница — на пример, додава копчиња и ги поврзува со функциите опишани овде. Техничките упатства и примерите со код во овој водич се наменети за тој добавувач или развивач. Ако самите ја развивате веб-страницата, ја преземате и оваа улога.

Техничка референца

Технички водич за развивачи на веб-страници

Поврзете ги сопствените копчиња со функциите за навигација на системот. Започнете со заедничките правила за повикување, а потоа разгледајте ги поединечните функции и примерите со код.

Плеерот ѝ ги обезбедува овие функции на веб-страница отворена во апликацијата Веб-страница. Пред да повикате функција, проверете дали е достапна, како што е прикажано во примерите подолу.

Заеднички правила за повикување

  • Барање: request е низа знаци што содржи празен JSON-објект. Користете request: '{}', а не самиот објект {}.
  • Успех: onSuccess потврдува дека барањето е прифатено, а не дека навигацијата завршила или дека се прикажува конкретна кампања. Одговорот не содржи податоци за апликацијата; не засновајте одлуки врз вредноста на response.
  • Неуспех: обработете onFailure(error_code, error_message). Одбиените барања опишани подолу го враќаат кодот -1. Пораките за грешки се точни вредности од интерфејсот и не смеат да се преведуваат.

onUp

Бара враќање преку навигацијата на системот. Одредиштето зависи од режимот на веб-апликацијата и од достапната патека за навигација. Ова не е враќање на претходната URL-адреса во историјата на прелистувачот и не е исто што и window.history.back(). Ако враќањето не е достапно, функцијата ја пријавува грешката прикажана подолу.

if (typeof window.onUp !== 'function') {
    console.warn("Функцијата за навигација на плеерот не е достапна.");
} else {
    window.onUp({
        request: '{}',
        onSuccess: function () {
            console.log("Барањето за навигација е прифатено.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Грешка: error_code -1, Disabled bottom layer. Single-app kiosk.

showLayerBottom

Бара отворање на менито со апликации во Апликацискиот слој. За тоа е потребно во списокот да има повеќе од една достапна ставка во моментот, земајќи го предвид нивниот распоред на важност. Ако е достапна само една ставка или ниту една, функцијата ја пријавува грешката прикажана подолу.

if (typeof window.showLayerBottom !== 'function') {
    console.warn("Функцијата за навигација на плеерот не е достапна.");
} else {
    window.showLayerBottom({
        request: '{}',
        onSuccess: function () {
            console.log("Барањето за навигација е прифатено.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Грешка: error_code -1, Single-app kiosk.

showLayerTop

Бара преминување на Презентацискиот слој. Овој слој мора да биде вклучен во поставките на уредот; во спротивно, функцијата ја пријавува грешката прикажана подолу. Прифаќањето на барањето не потврдува дека одредена кампања се репродуцирала или дека нејзината содржина е достапна.

if (typeof window.showLayerTop !== 'function') {
    console.warn("Функцијата за навигација на плеерот не е достапна.");
} else {
    window.showLayerTop({
        request: '{}',
        onSuccess: function () {
            console.log("Барањето за навигација е прифатено.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Грешка: error_code -1, Top layer disabled.

Насоки за имплементација

Користете onUp за враќање според контекстот на навигацијата, showLayerBottom за менито со апликации и showLayerTop за презентациска содржина. Спречете брзи последователни повици, на пример од повеќекратно притискање на копче. Повикувањето функција што недостига предизвикува JavaScript-грешка пред да може да се изврши onFailure, па затоа примерите прво ја проверуваат достапноста.

Не го најдовте тоа што го баравте?
Контактирајте го давателот на софтверот.