Setting Up Local Scenarios in CenarioVR in Headsets

To make scenarios available locally in CenarioVR, follow these steps:

1. Publish the desired scenario(s) from CenarioVR as either CenarioVR Live (private), HTML or xAPI.
2. Copy the published Zip file(s) on the device for each of the scenarios in the appropriate location on your device:For Android Devices including the Meta Quest series:
             • For Android Devices including the Meta Quest series:  /Download/CVRLocal
             •  For Windows Connected Devices:              C:/Users/<username>/AppData/LocalLow/Trivantis/CenarioVR/localscenarios‍
3. Create a file named “AppConfig.json” in the same directory as the zipped scenarios that contains the following text:
   ‍
   {
         "localMode": false,
         "xapiConfig": {
         "enable": false,
         "endpoint": "",
         "lrsUser": "",
       "lrsPassword": "",
         "email": null
       }
   }
4. When CenarioVR is launched, it will recognize the configuration and the zip files in the directory. The application will then need system file privileges to read this content, and will prompt to allow access to the content. In order to do this, it will display the system settings dialog. To return to CenarioVR after setting the privilege, hit the home button to resume.
5. CenarioVR will then Unzip the contents to subdirectories in the CenarioVR data folder. Depending on how much will need to be unzipped, you may see a progress dialog when you start the application as the contents are unzipped. 
6. Within the CenarioVR interface, in the scenario type dropdown, select "Local Scenarios"
7. If valid scenarios are available in the local path, they will be listed on the scenarios page.
8. The scenario will report analytics depending on the manner of publish:
             •  HTML - The scenario will run locally and will not report analytics
             •  xAPI - The scenario will report xAPI analytics to the LRS specified in the “External LRS” settings for the publish, or the endpoint described in the configuration file below.
             •  CenarioVR Live (private) - The scenario will report results directly to CenarioVR

Other publish options are not supported.

Enabling “Local Scenarios Only” Mode

Local mode allows the CenarioVR app to run exclusively with local scenarios on the device. This bypasses the authentication (Login Screen) and directly launches the user into the scenarios page with only local scenarios listed.

To enable Local mode, follow these steps:

• Open the AppConfig.json file.
• Set the value of "localMode" to true in the AppConfig.json file. 
• If the local scenarios need to report to a custom xAPI endpoint, other than one that is specified in the publish itself, provide username, password and endpoint parameters under “xapiConfig”.

Note: If the local scenario is configured to report xAPI analytics, and the user has not provided their login credentials to the App by logging in, the user will be prompted to enter their email ID before entering the scenario. To avoid this prompt during runtime, you can set the "email" parameter under "xapiConfig" in the AppConfig.json file.

Important Notes:

• Local scenarios will only appear in the scenarios page list when directories containing valid offline scenarios are present in the specified folder.
• Only local scenarios will be available in Local mode.
• Deleting Zip files in the specified folder will delete the files from the “Local Scenarios” section of the CenarioVR app, so you can completely control the scenarios on the device by adding and removing files.