The RIDE standalone application features a collection of example scenes that display key capabilities of the API.
Binaries for the RIDE standalone application are available for the following platforms:
Disclaimer: Some capabilities and features may not available on all platforms.
Note: Standalone RIDE applications are compiled with Unity version 2021.2.1f1. Differences may exist from a local development build on another version.
Matching User Type
The RIDE API Binary is best suited to the type of user described in the table below.
|Admin/Manager||RIDE platform standalone demonstrations, evaluation as-is; non-developer ||Non-development|
Table of system requirements for the Unity Player based upon user role.
|Admin/Manager||Refer to Unity documentation||Player|
Table of software requirements for the Unity Player based upon user role.
Obtaining the Standalone App
The process is simple to acquire the RIDE API binary:
- Submit a RIDE Binary Request through https://ride.ict.usc.edu/getting-started/obtain-ride/
- Once approved, click the provided download link to the appropriate platform binary for the RIDE distribution package.
Alternatively, if your RIDE Distribution Agreement includes the full RIDE SDK source, the LevelSelect scene, which serves as the basis for the RIDE standalone application, can be compiled locally. Refer to the Standalone Application Customization tutorial for instruction.
Using the Standalone App – PC
Instructions for launch and navigation of the RIDE standalone application.
- Download the package of your chosen platform to your local PC (5 GB or greater of free space recommended)
- Extract the compressed folder contents for your chosen platform.
- Inside the folder, run the RIDE executable (extension varies by platform)
- Main menu, select Demos to view the listing of available scenes.
- The listing is divided into Team Matches, Tutorial Examples and Advanced Integrations.
- Select a scene to view its details in the right panel.
- Capabilities entries all have tool-tips with more information.
- Project entries also have tool-tips and hotlink to that respective project’s Confluence documentation.
- Click Play to launch a selected scene.
- To exit a scene, press the Escape key to return to the main menu.
Scene Information and Instructions
Visit the Examples documentation for individual scene details and instruction. For instance, refer to the Team Match page for steps to create/join a match and a list of all dismounted avatar controls.
When in a particular scene, the following controls are commonly available:
- J key toggles mouse look and WASD “flying” camera
- ~ key toggles the console tool
- F12 toggles aim mode (First-person view input only)
Note, certain scenes may have varying controls and use the V key to toggle mouse look and WASD “flying” camera
Several scenes utilize a debug menu that appears in the upper-left corner by default.
- If enabled, C key or F11 toggles off/on this menu
- Specific scene functions always appear in the first menu
- Step to the next menu be either clicking the middle title bar or arrows (>>) at the top
- System statistics appear in subsequent menus
Command Line Arguments
Pass arguments through the command line at run-time by first calling up the console tool using the ~ key.
- -json “path/to/the/scenario.json”
- the json contains the terrain, the units, their positions, and their teams; it also allows for starting move behaviors
- -duration 10.0
- how long to run the simulation before quitting
- -timeScale 2.0
- how fast to run the simulation such that 2.0 is double speed and .5 is half time
- -isWaitAndQuit true
- quit the application after duration so you can run another one; otherwise, false means leave scenario running
- -logScenarioFile “path/to/scenarioLogs.json”
- the file to save all of the logs
- -updateLogRate 10.0
- how many times per second to write the positions of all units to the log file