WebGL

User Setup

The VHToolkit WebGL demo is at https://vhtoolkitwww.ict.usc.edu/demo. It uses a subset of the overall integrated technologies and requires a decent graphics card.

Known Issues

• The first-time loading time may be quite high; subsequent loading times are considerably faster
• May not work properly on all mobile browsers

Developer Setup

Requirements

• Unity Editor, with the Web Build Support module installed

Build and Deploy

The WebGL version uses the Unity URP project. To deploy:

• Set the Unity build target to WebGL
• Click Publish to Play
• Access the demo through Unity Play

Considerations

For security reasons, browsers prevent many cross-domain requests. That means that the VHToolkit WebGL version cannot directly access 3rd party services (e.g., Azure, AWS, OpenAI). Instead, it uses internally developed proxies deployed to AWS Lambda. The Unity project and RIDE packages use C# directives to identify WebGL-specific paths. Search for "#if UNITY_WEBGL" for examples. See here for more information on Cross-origin resource sharing (CORS).

Note that WebGL is single-threaded.

Known Issues

• Not all generally integrated VHToolkit technologies are available for WebGL, since each technology requires a custom proxy development, deployment, and maintenance