Dokumentáció / Integrációk és tartalomkészítés / A rendszer rétegeinek vezérlése saját weboldalról

A rendszer rétegeinek vezérlése saját weboldalról

Bevezetés és tájékozódás

Kapcsolja össze weboldala gombjait a rendszer rétegei közötti navigációval.

Mikor használja ezeket a függvényeket

Ezek a JavaScript-függvények akkor érhetők el a weboldal számára, ha az az eszközön a Weboldal alkalmazáson keresztül van megnyitva. A weboldal fejlesztője – vagy Ön, ha saját maga fejleszti az oldalt – egyedi oldalgombokhoz kapcsolhatja őket, így a látogatók megnyithatják az alkalmazásmenüt, vagy kampánylejátszásra válthatnak.

Ez akkor hasznos, ha a weboldalt teljes képernyőn, a rendszer vezérlői nélkül szeretné megjeleníteni, és a rétegek közötti navigációt saját felületébe építené. A példa alapértelmezett alkalmazásként megjelenített térképet és más alkalmazások menüjét mutatja.

Egyedi gombok beágyazott weboldalon

1 – Menü: a weboldal egyedi gombja megnyitja az alkalmazásmenüt az alkalmazásrétegben, így a látogató elhagyhatja a térképet, és másik alkalmazást választhat. showLayerBottom

2 – Hirdetések: a weboldal egyedi gombja a kampányokat tartalmazó megjelenítési rétegre vált. showLayerTop

A gombnevek és megjelenések példák. A weboldal fejlesztője vagy szállítója adja hozzá őket a beágyazott weboldalhoz. A megvalósítás részleteihez lásd az alábbiakat: navigációs függvények és kódpéldák.

A menü megnyitásához egynél több aktuálisan elérhető alkalmazás szükséges; a hirdetésekre váltáshoz engedélyezni kell a megjelenítési réteget. A tervezett navigációt mindig tesztelje a céleszközön.

Kinek szól az útmutató, és ki miért felelős

  • A platform szolgáltatója biztosítja a lejátszó navigációs függvényeit, és dokumentálja a használatukat.
  • Az ügyfél kiválasztja a Weboldal alkalmazásban megjelenített weboldalt, és egyezteti a szükséges vezérlőket annak szolgáltatójával.
  • A beágyazott weboldal szolgáltatója vagy fejlesztője módosítja magát a weboldalt – például gombokat ad hozzá, és összekapcsolja őket az itt ismertetett függvényekkel. Az útmutató műszaki utasításai és kódpéldái ennek a szolgáltatónak vagy fejlesztőnek szólnak. Ha saját maga fejleszti a weboldalt, ezt a szerepet is Ön tölti be.

Műszaki referencia

Műszaki útmutató weboldalfejlesztőknek

Kapcsolja saját gombjait a rendszer navigációs függvényeihez. Kezdje a közös hívási szabályokkal, majd folytassa az egyes függvényekkel és kódpéldákkal.

A lejátszó ezeket a függvényeket a Weboldal alkalmazásban megnyitott weboldalnak biztosítja. Meghívás előtt ellenőrizze a függvény elérhetőségét az alábbi példák szerint.

Közös hívási szabályok

  • Kérés: request egy üres JSON-objektumot tartalmazó karakterlánc. A request: '{}' alakot használja, ne magát a {} objektumot.
  • Siker: onSuccess a kérés elfogadását igazolja, nem a navigáció befejezését vagy egy adott kampány láthatóságát. A válasz nem tartalmaz alkalmazásadatokat; ne alapozzon döntést az alábbi értékére: response.
  • Hiba: kezelje ezt: onFailure(error_code, error_message). Az alább ismertetett elutasított kérések ezt a kódot adják vissza: -1. A hibaüzenetek a felület pontos értékei, ezért nem fordíthatók le.

onUp

Visszatérést kér a rendszer navigációján keresztül. A cél a webalkalmazás módjától és az elérhető navigációs útvonaltól függ. Ez nem a böngészési előzmények előző URL-címére való visszatérés, és nem egyenértékű ezzel: window.history.back(). Ha a visszatérés nem lehetséges, a függvény az alábbi hibát jelzi.

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);
        }
    });
}

Hiba: error_code -1, Disabled bottom layer. Single-app kiosk.

showLayerBottom

Az alkalmazásréteg alkalmazásmenüjét kéri. Ehhez az alkalmazáslistában egynél több, az ütemezett érvényességét is figyelembe véve aktuálisan elérhető elem szükséges. Ha csak egy vagy egyetlen elem sem érhető el, a függvény az alábbi hibát jelzi.

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);
        }
    });
}

Hiba: error_code -1, Single-app kiosk.

showLayerTop

A megjelenítési réteget kéri. Ezt a réteget az eszköz beállításaiban engedélyezni kell; ellenkező esetben a függvény az alábbi hibát jelzi. A kérés elfogadása nem igazolja egy adott kampány lejátszását vagy tartalmának elérhetőségét.

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);
        }
    });
}

Hiba: error_code -1, Top layer disabled.

Megvalósítási útmutató

Használjon ilyen összeállítást: onUp visszatéréshez a navigációs környezet alapján, showLayerBottom az alkalmazásmenühöz, valamint showLayerTop a megjelenítési tartalomhoz. Akadályozza meg a gyorsan ismétlődő hívásokat, például a gomb többszöri megnyomásakor. Nem létező függvény meghívásakor JavaScript-hiba keletkezik, még mielőtt az alábbi lefuthatna: onFailure , ezért a példák először ellenőrzik az elérhetőséget.

Nem találta meg, amit keresett?
Forduljon szoftverszolgáltatójához.