@onirix/embed-sdk
v1.14.0
Published
Onirix helper library for iframe event communication.
Downloads
1,647
Readme
Onirix Embed SDK
Take control of your Onirix augmented reality experiences. Responds to user interaction and acts on the 3D content of the scene.
This library acts as a wrapper of window.postMessage for simplifying communication with Onirix AR experiences. Not only can you use it in the online code editor of Onirix Studio projects, you can also connect to your scene loaded in an iFrame.
Take Onirix experiences to the next level.
Full documentation available at Onirix Docs.
Install
npm install @onirix/embed-sdk
Or include the dependency within the HTML head tag:
<head>
<script src="https://unpkg.com/@onirix/[email protected]/dist/ox-embed-sdk.esm.js">
</head>
Or as ESM modules:
import OnirixEmbedSDK from "https://unpkg.com/@onirix/[email protected]/dist/ox-embed-sdk.esm.js";
Usage
Just create an instance of our EmbedSDK and execute the connect method. From that moment on you will be able to subscribe to the events that occur in the scene and you will be able to execute actions on the elements of the experience.
const embedSDK = new OnirixEmbedSDK();
await embedSDK.connect();
embedSDK.subscribe(OnirixEmbedSDK.Events.ELEMENT_CLICK, (params) => {
console.log('somebodey clicks me!', params);
});
embedSDK.enable(elementOid);
If you have embedded an Onirix Studio experience in your application through an iframe, you must pass the Html element of the iFrame to the EmbedSDK constructor.
const iframeElement = document.getElementById("<iframe_element_id>");
const embedSDK = new OnirixEmbedSDK(iframeElement);
Make sure that the iFrame is already loaded before instantiating the EmbedSDK.
See the complete list of events and actions in our documentation.
Author
👤 Onirix
- Website: www.onirix.com
- Twitter: @onirix
- Github: @onirix-ar
- LinkedIn: @onirixar