Hello Community,
I have seen several users ask for a way to either:
- Merge multiple experiences into a single one
- be able to display an experience within another experience
- or be able to launch another experience from within an experience
When using Player 8, while an experience(XP) is running, the XP could use our Share & Deploy API to launch another XP. If the target XP has already been deployed to the device, the launch can happen pretty quick. Lets explore using this option.
How to setup in Composer
You can use the following URL in API Explorer to deploy an experience to a Player:
https://api.intuiface.com/sharedeploy/v2/experiences/pushThenPlayExperience?experienceID=xxxx&playerID=xxxxx
- Change the method to POST
- Include x-api-key in the header, the value for this would be an Intuiface Credential key with a Share and Deploy scope
- Content-Type: application/json
- experienceID: is the ID of the XP you are looking to launch/open
- playerID: is the ID of the Player device you want to deploy the experience to.
You can get the experienceID and playerID from the Share and Deploy console.
When you submit this request it will happen immediately, as long as the Player is online and has an internet connection.
Lets make it easier!
This is a fine option if you already know the experienceID and playerID that you want to use. But what if you want to have a list of your published XPs with the option to select and launch them.
I have created a Design Accelerator (DA) that will add a scene to an experience. In this scene you will see a list of experiences on your account and have the option to select one and launch it.
The DA adds API Explorer interface assets that utilize the Share and Deploy API to get the list of experiences and the ability to download and launch an experience.
For these API calls to work you need to provide an Intuiface Credential Key that has the scope for Share and Deploy. This credential key should be added to the Share and Deploy Credential Key global variable.
The DA also adds the Web Trigger interface asset, this is used to get the Player ID, which is required to launch an experience on the Player device.
Once the DA has been added to the experience and the credential key has been added, when you go to the scene it will pull a list of experiences that were published by the account that provided the credential key.
You can then select an experience and click Open Experience button. This will send a POST request to the Share and Deploy API to download/push and launch the experience. If the experience has already been downloaded it will launch the experience without downloading again. When the new experience is launched the previous experience is closed.
Note: If the experience needs to be downloaded it will obviously take more time to launch the experience.
How to get access to this Design Accelerator
Click this link to download the Design Accelerator:
Experience Catalog.zip (64.0 KB)
To use the DA you need to copy the extracted folder to the Intuiface Design Accelerators folder. The default location is:
C:\Users\[username]\Documents\Intuiface\Additional content\Design Accelerators\x.x
Once added click the Design Accelerator button:
You will find the Experience Catalog DA under the Experience Launcher group.
If there are any questions please let me know.
Thanks,
Ryan