Overview

An App Config file defines the launch method and required values to communicate with and retrieve authored training content. An App Config is normally stored in the Assets > Config folder in the Project. That is not a required location so they can be stored elsewhere.

It is possible to have multiple app configs in a Unity project. However, only one will be used at any given time.

Create an App Config

Right click on the folder in which you want to config to be stored
Expand the menu: Create > Motive
Select App Config

Launch Methods

App configs can be set up in one of two ways. These are defined by their Launch method. There are two options for the Launch Method: Storyflow Api and Launch Server.

Storyflow Api

This option will retrieve training content directly from Storyflow. This is usually the best option for testing and development. It is also a good option when not integrating with an learning management system (LMS).

Name	Description

Name	Description
Launch Method	The target from where to retrieve authored training content.
Config Name	A string. This value is found in the project view on Storyflow. It is related to a specific Storyflow Project.
App Id	A string. This value related to the workspace which contains a specific Storyflow Project. It is used, in part, for authentication. It can also be found in the project view on Storyflow.
Api Key	A string. A value specific to a Storyflow project. It is used for authentication purposes and can be found in the project view on Storyflow.
User Domain	Leave this blank.

The image below shows where these values can be found in Storyflow. If the Project view is collapsed, it can be expanded to view the values:

Launch Server

This option should be used when Motive systems have been installed in your company’s cloud or on company internal networks. This option is most often used when Motive systems are integrated to work with your company LMS or LXP:

Name	Description

Name	Description
Launch Method	The target from where to retrieve authored training content.
Launch Server Url	The url of the Launch server from which to retrieve uploaded training content.
Client Id	A string. This value can be found on the Launch Server Settings page. It is used for authentication.
Client Secret	A string. This value can be found on the Launch Server Settings page. It is used for authentication.

Using an App Config to Retrieve Authored Training Content

Only one App Config can be used at a time. It must be added in the appropriate place in the Unity project.

In the Hierarchy, find VR App - XAPI
Expand it and select Setup:

Setup will contain an App Setup Script. That script will contain a field called App Config. Either drag your App Config into it or select it using the menu system.

When the Unity project runs, it will now download any training content from the location specified in the App Config. For example, if it is using Storyflow Api, it will automatically download and make available any training content authored in the Storyflow project defined in the Config.

App Configs