Dokumentacija / Integracije i izrada sadržaja / Upravljanje slojevima sistema putem vaše web-stranice

Upravljanje slojevima sistema putem vaše web-stranice

Uvod i orijentacija

Povežite vlastitu dugmad na svojoj web-stranici s navigacijom između slojeva sistema.

Kada koristiti ove funkcije

Ove JavaScript funkcije dostupne su vašoj web-stranici otvorenoj na uređaju putem aplikacije Web stranica. Programer vašeg weba — ili vi, ako ga sami razvijate — može ih povezati s vlastitom dugmadi na stranici kako bi posjetioci mogli otvoriti meni aplikacija ili preći na reprodukciju kampanja.

Ova mogućnost je korisna ako želite prikazivati web preko cijelog ekrana bez kontrola sistema i uklopiti navigaciju između slojeva u vlastiti dizajn. Primjer prikazuje mapu kao zadanu aplikaciju uz meni drugih aplikacija.

Vlastita dugmad na ugrađenoj web-stranici

1 — Meni: vlastito dugme web-stranice otvara meni aplikacija u aplikacijskom sloju. Posjetilac tako s karte može prijeći na druge aplikacije. showLayerBottom

2 — Oglasi: vlastito dugme web-stranice prelazi na prezentacijski sloj s kampanjama. showLayerTop

Nazivi i izgled dugmadi služe kao primjer. U ugrađenu web-stranicu dodaje ih njen programer ili dobavljač. Način povezivanja opisuju navigacijske funkcije i primjeri koda u nastavku.

Otvaranje menija zahtijeva više od jedne trenutno dostupne aplikacije; prijelaz na oglase zahtijeva uključen prezentacijski sloj. Planiranu navigaciju uvijek provjerite na ciljnom uređaju.

Kome je vodič namijenjen i ko je za šta odgovoran

  • Pružalac platforme osigurava navigacijske funkcije plejera i dokumentaciju za njihovu upotrebu.
  • Korisnik platforme bira web koji se prikazuje u aplikaciji Web stranica i s njegovim pružaocem dogovara željene kontrole.
  • Pružalac ili programer ugrađenog weba mijenja sam web — naprimjer, dodaje dugmad i povezuje ih s opisanim funkcijama. Tehničke upute i primjeri koda u ovom vodiču namijenjeni su upravo njemu. Ako sami razvijate web, preuzimate i tu ulogu.

Tehnička dokumentacija

Tehničke upute za razvojne programere web-stranice

Povežite vlastitu dugmad s navigacijskim funkcijama sistema. Najprije proučite zajednička pravila pozivanja, a zatim pojedinačne funkcije i primjere koda.

Plejer pruža ove funkcije webu otvorenom u aplikaciji web-stranica. Prije pozivanja provjerite dostupnost funkcije, kao u primjerima u nastavku.

Zajednička pravila pozivanja

  • Zahtjev: request je tekstualni niz koji sadrži prazan JSON objekt. Upotrijebite request: '{}', a ne sam objekt {}.
  • Uspjeh: onSuccess potvrđuje prihvatanje zahtjeva, a ne završetak navigacije ili prikaz određene kampanje. Odgovor ne sadrži aplikacijske podatke; odluke nemojte zasnivati na vrijednosti response.
  • Greška: obradite onFailure(error_code, error_message). Niže opisani odbijeni zahtjevi vraćaju kod -1. Poruke o greškama tačne su vrijednosti interfejsa i ne prevode se.

onUp

Pokreće povratak unutar navigacije sistema. Odredište zavisi od načina rada web-aplikacije i dostupne navigacijske putanje. Nije riječ o povratku na prethodni URL u historiji preglednika niti o ekvivalentu funkcije window.history.back(). Ako povratak nije dostupan, funkcija vraća niže navedenu grešku.

if (typeof window.onUp !== 'function') {
    console.warn("Navigacijska funkcija plejera nije dostupna.");
} else {
    window.onUp({
        request: '{}',
        onSuccess: function () {
            console.log("Navigacijski zahtjev je prihvaćen.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Greška: error_code -1, Disabled bottom layer. Single-app kiosk.

showLayerBottom

Zahtijeva prelazak na meni aplikacija u aplikacijskom sloju. Potrebno je više od jedne trenutno dostupne stavke na listi aplikacija, uzimajući u obzir njihov raspored važenja. Ako je dostupna samo jedna stavka ili nijedna, funkcija vraća niže navedenu grešku.

if (typeof window.showLayerBottom !== 'function') {
    console.warn("Navigacijska funkcija plejera nije dostupna.");
} else {
    window.showLayerBottom({
        request: '{}',
        onSuccess: function () {
            console.log("Navigacijski zahtjev je prihvaćen.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Greška: error_code -1, Single-app kiosk.

showLayerTop

Zahtijeva prelazak na prezentacijski sloj. Taj sloj mora biti uključen u konfiguraciji uređaja; u suprotnom funkcija vraća niže navedenu grešku. Prihvatanje zahtjeva ne potvrđuje reprodukciju određene kampanje niti dostupnost njenog sadržaja.

if (typeof window.showLayerTop !== 'function') {
    console.warn("Navigacijska funkcija plejera nije dostupna.");
} else {
    window.showLayerTop({
        request: '{}',
        onSuccess: function () {
            console.log("Navigacijski zahtjev je prihvaćen.");
        },
        onFailure: function (error_code, error_message) {
            console.warn(error_code, error_message);
        }
    });
}

Greška: error_code -1, Top layer disabled.

Preporuke za implementaciju

Upotrijebite onUp za povratak zavisno od konteksta navigacije, showLayerBottom za meni aplikacija i showLayerTop za prezentacijski sadržaj. Spriječite brze ponovljene pozive, naprimjer višestrukim pritiskom na dugme. Pozivanje nepostojeće funkcije izaziva JavaScript grešku prije nego što se može pozvati onFailure, pa primjeri prvo provjeravaju dostupnost.

  • Web stranicaWeb stranica ugrađuje web-stranicu direktno u Aplikacijski sloj, naprimjer CNN, web lokalnih vatrogasaca, podstranicu za zapošljavanje ili vlastitu interaktivnu kartu trgovačkog centra.
  • Dva sloja ekrana: kampanje i aplikacijeSaznat ćete kako rade prezentacijski i aplikacijski sloj, kako ih koristiti zasebno ili zajedno te kako posjetioci prelaze između njih.

← Nazad na pregled – Integracije i izrada sadržaja

Niste pronašli ono što ste tražili?
Obratite se svom pružaocu softvera.