Setup

Begin by opening the tutorial folder in your code editor of choice. We will begin by installing the prerequisite packages for our application. Open a new terminal window, navigate to your tutorial directory (<PackageRoot>/tutorials/server_tutorial), then run the following command to install the packages:

npm install

Once the packages have been installed, open up the paths.js file. This file contains three paths that you will need to set to be relevant to your system. It is recommended to use absolute paths in all cases.

  • licenseFile should point to a file containing your HOOPS Communicator license string. This should be a plain text file containing only the license file, not a header file containing the license. If needed, you can view your license string on the HOOPS Communicator downloads page of the Developer Zone.

  • executablePath should point to the ts3d_sc_server executable included in the HOOPS Communicator Package. For example, <PackageRoot>/server/bin/win64

  • The modelDirectory path should point to the models subdirectory in the server_tutorial directory of the HOOPS Communicator Package

Finally, copy the following HOOPS Communicator JavaScript files from <PackageRoot>/web_viewer/src/js to <PackageRoot>/tutorials/server_tutorial/public/js.

  • hoops_web_viewer.mjs

  • engine-esm.js

  • engine-esm.wasm

The ts3d_sc_server executable will launch a Stream Cache Server that the server we are building will monitor.