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

Upravljanje slojevima sustava putem vaše web-stranice

Uvod i orijentacija

Povežite vlastite gumbe na svojoj web-stranici s navigacijom između slojeva sustava.

Kada koristiti ove funkcije

Ove JavaScript funkcije dostupne su vašoj web-stranici otvorenoj na uređaju putem aplikacije Web stranica. Razvojni programer vašeg weba — ili vi, ako ga sami razvijate — može ih povezati s vlastitim gumbima na stranici kako bi posjetitelji mogli otvoriti izbornik aplikacija ili prijeći na reprodukciju kampanja.

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

Vlastiti gumbi na ugrađenoj web-stranici

1 — Izbornik: vlastiti gumb web-stranice otvara izbornik aplikacija u aplikacijskom sloju. Posjetitelj tako s karte može prijeći na druge aplikacije. showLayerBottom

2 — Oglasi: vlastiti gumb web-stranice prelazi na prezentacijski sloj s kampanjama. showLayerTop

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

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

Kome je vodič namijenjen i tko je za što odgovoran

  • Pružatelj platforme osigurava navigacijske funkcije reproduktora i dokumentaciju za njihovu upotrebu.
  • Korisnik platforme odabire web koji se prikazuje u aplikaciji Web stranica i s njegovim pružateljem dogovara željene kontrole.
  • Pružatelj ili razvojni programer ugrađenog weba mijenja sam web — primjerice, dodaje gumbe 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 vlastite gumbe s navigacijskim funkcijama sustava. Najprije proučite zajednička pravila pozivanja, a zatim pojedine funkcije i primjere koda.

Reproduktor 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 tekstni niz koji sadrži prazan JSON objekt. Upotrijebite request: '{}', a ne sam objekt {}.
  • Uspjeh: onSuccess potvrđuje prihvaćanje zahtjeva, a ne dovršetak navigacije ili prikaz određene kampanje. Odgovor ne sadrži aplikacijske podatke; odluke nemojte temeljiti na vrijednosti response.
  • Pogreška: obradite onFailure(error_code, error_message). Niže opisani odbijeni zahtjevi vraćaju kod -1. Poruke o pogreškama točne su vrijednosti sučelja i ne prevode se.

onUp

Pokreće povratak unutar navigacije sustava. Odredište ovisi o načinu rada web-aplikacije i dostupnom navigacijskom putu. Nije riječ o povratku na prethodni URL u povijesti preglednika niti o ekvivalentu funkcije window.history.back(). Ako povratak nije dostupan, funkcija vraća niže navedenu pogrešku.

if (typeof window.onUp !== 'function') {
    console.warn("Navigacijska funkcija reproduktora 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);
        }
    });
}

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

showLayerBottom

Zahtijeva prijelaz na izbornik aplikacija u aplikacijskom sloju. Potrebno je više od jedne trenutačno dostupne stavke na popisu aplikacija, uzimajući u obzir njihov raspored valjanosti. Ako je dostupna samo jedna stavka ili nijedna, funkcija vraća niže navedenu pogrešku.

if (typeof window.showLayerBottom !== 'function') {
    console.warn("Navigacijska funkcija reproduktora 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);
        }
    });
}

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

showLayerTop

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

if (typeof window.showLayerTop !== 'function') {
    console.warn("Navigacijska funkcija reproduktora 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);
        }
    });
}

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

Preporuke za implementaciju

Upotrijebite onUp za povratak ovisno o kontekstu navigacije, showLayerBottom za izbornik aplikacija i showLayerTop za prezentacijski sadržaj. Spriječite brze ponovljene pozive, primjerice višestrukim pritiskom na gumb. Pozivanje nepostojeće funkcije uzrokuje JavaScript pogrešku prije nego što se može pozvati onFailure, pa primjeri najprije provjeravaju dostupnost.

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

← Natrag na pregled – Integracije i izrada sadržaja

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