Dokumentacija / Integracije i izrada sadržaja / Upravljanje slojevima sistema sa sopstvenog veb-sajta

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.

Sopstvena dugmad na ugrađenom veb-sajtu

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: request je string koji sadrži prazan JSON objekat. Koristite request: '{}', a ne sam objekat {} .
  • Uspeh: onSuccess potvrđ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 vrednosti response.
  • 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.

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.

Smernice za implementaciju

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.

Niste pronašli ono što tražite?
Obratite se svom dobavljaču softvera.