Deutsch (DE-CH-AT)English (United Kingdom)

 

Information / Hilfe. Das sollten Sie wissen.

Dokumentation der Bibliothek o2c-utils.js

Eleco bietet die hier beschrieben zentralen Hilfsfunktionen an, damit Sie auf Ihrer Webseite möglichst einfach den o2c-Player einsetzen können und zugleich von künftigen Weiterentwicklungen (z.B. Unterstützung anderer Betriebssysteme und Browsertypen) profitieren können, ohne Ihre Webseite anzupassen.

Voraussetzung für den Einsatz dieser Bibliothek ist ein Verweis auf die Script Datei auf Ihrer Webseite (vor der ersten Verwendung einer hier beschriebenen Funktion). Dieser Verweis sieht so aus:

<script type="text/javascript" src="http://www.o2c.de/utilities/o2c-utils.js"></script>

Funktionsbeschreibung

o2cIsInternetExplorer

Beispiel: if (o2cIsInternetExplorer()) ...

Liefert true, wenn der Browser ein Internet-Explorer ist (bzw. die ActiveX Variante des o2c-Players benutzt.)

o2cIsAnyPluginAvailable

Beispiel: if (!o2cIsAnyPluginAvailable()) alert("Sorry");

Liefert true, wenn der Browser (gegebenfalls nach entsprechender Plugin/ActiveX Installtion) o2c-Objekte anzeigen können wird. Liefert false, wenn für diesen Browser kein o2c-Plugin existiert.

Falls kein lokales Plugin/ActiveX installierbar ist, können Sie den cloud player Service verwenden.

o2cHavePluginVersion

Beispiel: if (o2cHavePluginVersion('2.0.0.68')) ....

Liefert true, wenn die angegebene Plugin-Version bereits installiert ist. Falls nicht, wird hierbei kein automatisches Update ausgelöst. Diese Funktion funktioniert nicht für die ActiveX Variante (wenn o2cIsInternetExplorer() true liefert). Sie können eine existierende Instanz des o2c Players mit Hilfe der Funktion VersionString nach ihrer Version fragen.

o2cRegisterEvent(id, Event, func);

Beispiel: o2cRegisterEvent('thePlayer', 'Click', 'onClick');

Meldet einen Event-Handler an. Diese Funktion muss für alle gewünschten Events aufgerufen werden, bevor das eigentliche o2c-Objekt eingefügt wird (o2cInsertObject).
Die Parameter sind:

'id' Die HTML-id des o2c-Objektes (muss mit dem ersten Argument des o2cInsertObject Aufrufes übereinstimmen).
'Event' Der Name des o2c Events (Click, SubObjectPicked, AnimationDone, AnimationStarted, ObjectLoaded, ThumbnailDone, TextureChanged, MaterialChanged, ObjectMove, ObjectMoving, MouseReleased, ClickWithKeys, MouseDown, MaterialDrageMove, ActivationStateChanged).
'func'Die aufzurufende Event-Handler Funktion. Die Argumente müssen zum Event passen.

o2cInsertObject(id, vers, width, height, params, alternateImage);
Erzeugt einen o2c Player und liefert das JavaScript Objekt dazu zurück.
Die Argumente sind:

'id'Die HTML id des o2c Objekets (Sie können getElementById() mit dieser ID benutzen, um einen Verweis auf den o2c Player zu bekommen).
'vers'Die minimal benötige Player Version. Falls ein installiertes Plugin/ActiveX zu alt ist, wird ein Update veranlasst.
'width'Die Breite des Player-Fensters.
'height'Die Höhe des Player-Fensters.
'params'Ein String mit allen einzustellenden Parametern, typischerweise nur die URL des darzustellenden Objektes.
'alternateImage'Ein(optionales) Bild, das dargestellt wird, falls kein o2c Player oder cloud player verfügbar ist.

Diese Funktion liefert die JavaScript Referenz auf den o2c Player zurück, wenn ein Player mit der angeforderten Version (oder neuer) verfügbar ist. Falls nicht wird die Installation eines Players (oder ein Update) gestartet und null zurückgeliefert.

Example- Simple use of a single o2c object

<script type="text/javascript" src="http://www.o2c.de/utilities/o2c-utils.js"></script>
<script type="text/javascript">
o2c = o2cInsertObject('o2c_id1', '2.0.0.68', 300, 400,
    'Zoom="1.129477"; ' +
    'PanX="109.219025"; ' +
    'PanY="109.512207"; ' +
    'ObjectURL="objects/engine.o2c"');
</script>

Example - o2c object with on click alert

<script type="text/javascript" src="http://www.o2c.de/utilities/o2c-utils.js"></script>
<script type="text/javascript">
function objectClicked(autoAnimIndex)
{
    alert("Object clicked");
}

o2cRegisterEvent('o2c_id1', 'Click', 'objectClicked');

o2c = o2cInsertObject('o2c_id1', '2.0.0.68', 300, 400,
    'Zoom="1.129477"; ' +
    'PanX="109.219025"; ' +
    'PanY="109.512207"; ' +
    'ObjectURL="objects/engine.o2c"');

Über Information / Hilfe

Um die Benutzung und Integration unserer Produkte zu unterstützen, haben wir folgende Kompendien zusammengestellt. Falls Sie weitere Fragen haben, rufen Sie bitte unsere Servicenummer an oder schreiben Sie uns eine eMail. Wir werden gern Ihre Anfrage so schnell wie möglich beantworten.

Produkte

Lernen Sie die o2c-Produkte kennen.

Produkttour starten

o2c-Player

Laden Sie den o2c-Player herunter.

Produkttour starten

o2c-Tour

Lernen Sie o2c detailliert kennen.

o2c tour