Upravljanje slojevima sistema sa sopstvenog veb-sajta
Uvod i snalaženje
Povežite dugmad na svom veb-sajtu sa navigacijom između slojeva sistema.
Kada koristiti ove funkcije
Ove JavaScript funkcije dostupne su vašem veb-sajtu kada je na uređaju otvoren kroz aplikaciju Veb-sajt. Programer vašeg veb-sajta — ili vi, ako sami razvijate sajt — može da ih poveže sa sopstvenim dugmadima na stranici i omogući posetiocima da otvore meni aplikacija ili pređu na reprodukciju kampanja.
Ovo je korisno kada želite da prikažete veb-sajt preko celog ekrana bez kontrola sistema i ugradite navigaciju između slojeva u sopstveni dizajn. Primer prikazuje mapu kao podrazumevanu aplikaciju uz meni drugih aplikacija.

1 — Meni: sopstveno dugme na veb-sajtu otvara meni aplikacija u aplikacionom sloju i omogućava posetiocima da napuste mapu i izaberu drugu aplikaciju. showLayerBottom
2 — Reklame: sopstveno dugme na veb-sajtu prelazi na prezentacioni sloj sa kampanjama. showLayerTop
Nazivi i izgled dugmadi služe kao primer. Programer ili dobavljač veb-sajta dodaje ih u ugrađeni veb-sajt. Detalje implementacije pogledajte u odeljku navigacione funkcije i primeri koda ispod.
Za otvaranje menija potrebno je više od jedne trenutno dostupne aplikacije; za prelazak na reklame potrebno je da prezentacioni sloj bude uključen. Uvek proverite nameravanu navigaciju na ciljnom uređaju.
Kome je vodič namenjen i ko je odgovoran
- Dobavljač platforme obezbeđuje navigacione funkcije plejera i dokumentuje njihovo korišćenje.
- Korisnik bira veb-sajt prikazan u aplikaciji Veb-sajt , a potrebne kontrole dogovara sa njenim dobavljačem.
- Dobavljač ili programer ugrađenog veb-sajta menja sam veb-sajt — na primer, dodaje dugmad i povezuje ih sa ovde opisanim funkcijama. Tehnička uputstva i primeri koda u ovom vodiču namenjeni su tom dobavljaču ili programeru. Ako sami razvijate veb-sajt, preuzimate i ovu ulogu.
Tehnička referenca
Tehnički vodič za veb-programere
Povežite sopstvenu dugmad sa navigacionim funkcijama sistema. Počnite zajedničkim pravilima pozivanja, a zatim pratite pojedinačne funkcije i primere koda.
Plejer obezbeđuje ove funkcije veb-sajtu otvorenom u aplikaciji Veb-sajt. Pre pozivanja proverite da li je funkcija dostupna, kao što je prikazano u primerima ispod.
Zajednička pravila pozivanja
- Zahtev:
requestje string koji sadrži prazan JSON objekat. Koristiterequest: '{}', a ne sam objekat{}. - Uspeh:
onSuccesspotvrđuje da je zahtev prihvaćen, a ne da je navigacija završena ili da je konkretna kampanja vidljiva. Odgovor ne sadrži podatke aplikacije; nemojte zasnivati odluke na vrednostiresponse. - Neuspeh: obradite
onFailure(error_code, error_message). Ovde opisani odbijeni zahtevi vraćaju kod-1. Poruke o greškama predstavljaju tačne vrednosti interfejsa i ne smeju da se prevode.
Dostupne navigacione funkcije
onUp
Zahteva povratak kroz navigaciju sistema. Odredište zavisi od režima veb-aplikacije i dostupne navigacione putanje. Ovo nije povratak na prethodni URL iz istorije pregledača i nije ekvivalent funkciji window.history.back(). Ako povratak nije dostupan, funkcija prijavljuje grešku prikazanu ispod.
if (typeof window.onUp !== 'function') {
console.warn("The player navigation function is unavailable.");
} else {
window.onUp({
request: '{}',
onSuccess: function () {
console.log("The navigation request was accepted.");
},
onFailure: function (error_code, error_message) {
console.warn(error_code, error_message);
}
});
}Greška: error_code -1, Disabled bottom layer. Single-app kiosk.
showLayerBottom
Zahteva meni aplikacija u aplikacionom sloju. Potrebno je više od jedne trenutno dostupne stavke na listi aplikacija, uz uvažavanje njihove zakazane dostupnosti. Ako je dostupna samo jedna stavka ili nijedna, funkcija prijavljuje grešku prikazanu ispod.
if (typeof window.showLayerBottom !== 'function') {
console.warn("The player navigation function is unavailable.");
} else {
window.showLayerBottom({
request: '{}',
onSuccess: function () {
console.log("The navigation request was accepted.");
},
onFailure: function (error_code, error_message) {
console.warn(error_code, error_message);
}
});
}Greška: error_code -1, Single-app kiosk.
showLayerTop
Zahteva prezentacioni sloj. Ovaj sloj mora da bude omogućen u konfiguraciji uređaja; u suprotnom funkcija prijavljuje grešku prikazanu ispod. Prihvatanje zahteva ne potvrđuje da se konkretna kampanja reprodukovala ili da je njen sadržaj dostupan.
if (typeof window.showLayerTop !== 'function') {
console.warn("The player navigation function is unavailable.");
} else {
window.showLayerTop({
request: '{}',
onSuccess: function () {
console.log("The navigation request was accepted.");
},
onFailure: function (error_code, error_message) {
console.warn(error_code, error_message);
}
});
}Greška: error_code -1, Top layer disabled.
Koristite onUp za povratak na osnovu navigacionog konteksta, showLayerBottom za meni aplikacija i showLayerTop za prezentacioni sadržaj. Sprečite brzo ponavljanje poziva, na primer usled višestrukih pritisaka dugmeta. Pozivanje funkcije koja nije dostupna izaziva JavaScript grešku pre nego što onFailure može da se izvrši, pa primeri najpre proveravaju dostupnost.
Povezane teme i sledeći koraci
← Nazad na pregled – Integracije i izrada sadržaja
Obratite se svom dobavljaču softvera.
