Încorporarea playerului krpano în pagina site-ului este cât mai automatizată și simplificată
• adăugarea unui script la codul paginii și
• O linie de cod cu parametri de încorporare.
Funcțiile script includ definiția motorului de tip care va fi utilizat (flash sau HTML5) și limitări de funcționalitate de prelucrare (acestea sunt legate de sistemul de operare, browser-ul și metodele de introducere) Ca regulă, script-ul și jucătorul se află în același JS-fișier, cel mai adesea este numit tour.js. În ansamblul krpano, acesta este stocat separat în fișierul embedpano.js.
Funcțiile scriptului embedpano.js
- Inițiați playerul și încorporați-l într-o pagină web;
- Detectarea automată a tipului de motor (bliț sau html5);
- Fixați funcționalitatea roții mouse-ului în legătură cu defilare, zoom, suport Mac OS, touchpad și normalizarea vitezei de rotație);
- Fixați limitele playerului flash atunci când utilizați straturi de opacitate și suprapunere, dacă wmode = transparent / opac;
- Conectați capacitatea de a comuta la modul ecran complet pentru bliț;
- Încorporați codul în codul playerului tur virtual.
Inserați scriptul
Embedding-ul se ocupă oriunde în codul paginii web:
sau, atunci când scriptul este combinat cu html5-player, deci:
Încărcarea playerului
Pentru a încorpora playerul în locul dorit în codul paginii web, un element
În interiorul acestui element, trebuie să înregistrați un apel la metoda embedpano (), care va crea playerul:
Funcția de încorporare acceptă un obiect cu parametrii de încorporare ca argument.
Opțiunile de încorporare
Metoda embedpano () necesită doar un obiect la intrare, prin care toți parametrii sunt transmiși în ordine aleatorie sub forma parametrului: valoare.
Toți parametrii, cu excepția țintă, pot fi omise, iar valorile implicite vor fi înlocuite cu acestea:
Numele și calea fișierului flash player. Valoarea implicită este "krpano.swf", adesea este folosită în loc de "tour.swf"
Numele și calea fișierului playerului este html5. În mod implicit, va fi utilizat parametrul SWF, în care extensia va fi modificată în .js. Acest parametru este ignorat când player-ul este încorporat în scriptul de încorporare.
Numele fișierului cu specificația inițială xml și calea către el. Numele implicit este același ca și pentru jucători. Cel mai adesea, în loc este folosit "tour.xml".
Identificatorul elementului de marcare în care va fi încorporat playerul. Dacă parametrul nu este setat, va apărea o eroare "alert ()".
Culoarea fundalului jucătorului în format html. Implicit este negru (# 000000).
Definiți parametrul modului fereastră pentru playerul flash. Parametri posibili:
• fereastră - valoarea implicită, un compromis între capabilități și viteză. În multe browsere și sisteme, elementele de marcare nu se pot suprapune ferestrei playerului;
• Opac - permite suprapunerea ferestrei playerului (funcționează mai lent);
• transparent - în plus față de suprapunere vă permite să faceți vizibile elementele de marcare în spatele ferestrei playerului (funcționează chiar mai lent);
• direct - cel mai bun mod de performanță, folosind accelerația hardware. Nu există suprapunere, compatibilitate limitată cu sistemele vechi și browserele.
Notă pentru html5: Parametrul wmode = transparent va fi procesat de motorul player-ului, ceea ce îl va face translucid. Suprapunerea ferestrei player-ului este întotdeauna disponibilă.
Stabilește prioritatea utilizării pentru motorul html5.
• auto - selectează html5 numai dacă flashul nu este acceptat;
• Preferați - dacă este posibil, utilizați html5, blițul va fi utilizat numai dacă html5 nu este suportat;
• modul de preferință de rezervă - flash, în care html5 este considerat drept opțiune de rezervă;
• numai - utilizați întotdeauna html5. Dacă nu este acceptată, va apărea o eroare;
• întotdeauna - utilizați întotdeauna html5, indiferent de disponibilitatea suportului. Folosit numai pentru depanare și testare;
• niciodată - nu utilizați html5.
De asemenea, se introduc setările de extensie necesare testării:
Stabilesc tehnologia de randare. exemple:
În mod implicit, tehnologia WebGL este selectată, cu excepția următoarelor cazuri:
• iOS nu este disponibil, deci tehnologia implicită este css3d;
• Browser-ele pentru Android bazate pe webview și pe support-ul webgl pot avea probleme de performanță și redare pe diferite dispozitive, astfel că tehnologia implicită este css3d;
• În Android Firefox până la versiunea 22, datorită performanței scăzute, css3d este utilizat în mod implicit. În versiunile 22 și ulterioare, WebGL este utilizat în mod implicit.
Treceți un obiect cu parametrii krpano, vă permite să setați parametrii inițiali ai krpano. De asemenea, puteți seta orice parametri ai playerului. Parametrii vor fi setați sau suprascriși după încărcarea și procesarea principalului xml.
Calea de bază pentru fișierul swf, pe care apoi o puteți utiliza pentru a rezolva căile relative. Poate fi folosit atât în flash cât și în html5 pentru a rezolva căile relative în xml.
Instalarea determină dacă mesajele de eroare ale player-ului vor fi trimise în consola browserului.
Specifică ordinea în care este utilizată rotița mouse-ului. Dacă este setat la adevărat, evenimentele cauzate de rotița mouse-ului vor fi procesate în player, altfel ele vor fi ignorate de către player și procesate de browser (pentru a derula pagina).
Notă pentru playerul flash. Această funcție necesită interfața externă externă a playerului flash (Interfață externă). Când este deconectat, apelul onready va funcționa numai după modificarea setărilor de securitate ale playerului flash. Citiți mai multe.
Permite utilizarea unei funcții arbitrare de tratare a erorilor. Această funcție va fi apelată cu un parametru ca un șir cu un mesaj de eroare.
Când este setat la true, toți parametrii de la link vor fi transferați în player. De asemenea, toate setările de la link pot fi transferate în playerul html5. Acest lucru face posibilă comutarea între motoarele flash și html5 cu referințe diferite.
Opțiunile de pornire
Există un grup de parametri care definesc încorporarea și nu sunt transferați la player.
Vă permite să specificați un nume arbitrar pentru fișierul de pornire. Dacă parametrul este omis, valoarea implicită este numele fișierului swf.
Pentru depanarea pe dispozitive mobile există un simulator special, stocat în folderul krpano / examples / iphone-ipad-simulator
Terminarea jucătorului
Pentru a șterge o instanță a playerului, trebuie să utilizați funcția removepano (). Această funcție șterge toate setările mouse-ului, elemente DOM și evenimente HTML5. Ca parametru, funcția primește ID-ul instanței playerului.
Note despre utilizarea pe dispozitive mobile
Notă: target-densitydpi = device-dpi este recunoscută numai de dispozitivele Android și poate provoca avertismente în console în alte browsere (iOS, Chrome (sic!)). Acest avertisment poate fi ignorat.
Toți parametrii opționali sunt omise, astfel încât valorile implicite vor fi utilizate: «krpano.swf», «krpano.xml», «krpanoSWFObject» și 100% din dimensiunea.
2. Setări avansate pentru primul exemplu.
3. Setarea priorității pentru motorul html5.
5. Utilizarea selectivă a html5: preferați numai pe dispozitivele Android și touch cu IE10.