Page Comparison

Getting Started

• Card : Quick Start

• Card: Interacting with the CVT

• Card : Adding Your Own Content to the Collab Viewer .

• Networking Requirements

By the end of this guide you will have a clear idea of how to start understanding of the workflow for creating a new project with the Collab Viewer Template using the Cavrnus platform. This page will walk you through how to configure a new Collab Viewer Template project, package the project for synchronized copresence, and navigate the interactive options within the scene, facilitating the connection of multiple participants through a remote network to the same collaborative Space.

the Space.

Set up the Project

The workflow for using the Collab Viewer Template with the Cavrnus platform is similar to the usage pattern of standard CVT:

1. Download the CMC-CVT sample template project from the Cavrnus Web Console.

   1. The This template includes the same content as the AEC Collab Viewer template for Unreal Engine 5.2.

   2. The Cavrnus Metaverse Connector has been added to power advanced functionality.

2. Create a new level using Build your project from this template by adding your own custom content and UI configuration.

   1. The downloadable template is preconfigured with the plugin. Replacing the scene with your content is the fastest path to a collaborative session since the Cavrnus plugin is already pre-configured.

   2. You can also start with an existing project and bring the template content into that, just as with standard CVT. However, this requires more advanced configuration which is covered later in this Knowledge Base.

3. Add content based on the layers of interaction.

   1. Cavrnus gives additional model import options at runtime. You can improve performance by designing your baseline level to include only the models that every variation might have.

   2. Additional models can be added to the project using the standard CVT model library approach, keeping in mind that user-specific models can be later added using either Datasmith or Holos.

Package the Project

1. The Cavrnus platform does not require any special configuration to package the project to a distributable executable file (*.exe). It only requires activation of the Cavrnus plugin (already done from step 1).

   1. Simply follow the Epic standard workflow for Packaging Projects using the Unreal Editor built-in tools built to create an executable file package.

2. Share the executable package with all of the users who will join your collaborative session.

   1. Each person who who joins your collaborative Space will need to run a duplicate application of your project.

   2. While it is possible for each user to package their own build and still connect within the Space, there will be fewer chances for errors if one member of the team packages the project and distributes copies of the executable.

   3. There are no configuration requires to package the project beyond activation of the Cavrnus plugin (already done from step 1). Simply follow the Epic standard workflow for Packaging Projects.

   4. As with a standard Collab Viewer project, each person who joins the Space will need all of the files in the executable folder.

Connect to a Space

1. A CVT project powered by Cavrnus does not require a user instance to act as a server.

   1. Each instance connects to the Cavrnus platform, and collaboration takes places within distinct Spaces.

   2. Changes made in one Space do not cross over to affect other Spaces.

   3. You can create as many Spaces as you like, and load the same executable project into each Space with it’s own unique configuration. Each Space has its own Journal which tracks the history of changes made in that Space.

2. The first differences most users will notice is the user login screen, which prompts the user to login to your domain with a unique ID and password.

3. Make sure your team members have access to your domain by creating user profiles in the Administration page of the Web Console.

   1. See Creating and Managing Users.

4. To connect your team members in a collaborative session, you first create a Space for everyone to join, and then assign roles for each user within that Space.

   1. See Creating and Managing Spaces.

5. After logging in to your distributed application, users will can find the Space you’ve invited them to in the Cavrnus Lobby.

Navigating a

Navigate the Collaborative Space

1. Once the team is in the Space, you will see the other users logged into the Space as separate avatars.

   1. You may also see a User List on the right side of the screen. This will display each user’s thumbnail image, audio, and screen-sharing controls.

   2. You can toggle this on and off using the F10 key.

2. From here, the standard CVT controls should look familiar, and will continue to operate the same way with additional Cavrnus functionality on top.

Making Changes to a Collaborative Space

1. One key difference when using the Cavrnus platform is the persistent tracking of states within a unique Space.

   1. Every change you make is logged to the Journal in real-time. There is no need to click a “Save” button.

   2. Changes are persistently available even after all members leave the Space. When a team member loads the project back into that Space, they will find everything exactly where it was left when the last changes were made.

   3. With Cavrnus, you can have an unlimited number of Spaces, so multiple configurations can be stored and reviewed.

   4. Just as before, you can store a state using the default Collab Viewer Template interface. This will move everything to the stored states and update the Journal.

2. Objects can also be added and removed from the scene to customize the Space.

   1. Add new models to the scene using the Holos format. Holos added this way are pushed to other users and are visible only in the Space in which they were added.

   2. In the same way, boards can be added for display purposes. (See Boards).

3. The state of all of the objects in the Space can be managed using the the Cavrnus object list.

Desktop and VR Controls

1. The same desktop controls and VR controls natively available in the Collab Viewer Template are also available when using Cavrnus platform.

   1. The Space Bar opens the Iteraction Menu providing various tools to measure, move, and alter the material of an object.

   2. Additional tools are also available, such as scaling and rotating objects, datasmith, and others. More information can be found on the next few pages of this knowlege base.

2. Just as in standard CVT, you can use the top right menu to switch between movement modes: fly, walk, orbit, and VR.

   1. In Walk mode, Cavrnus provides a checkbox option to dynamically set the avatar as a Third Person player character.

   2. Checking this box from any mode will automatically set the movement mode to Walk.

The avatars are slightly different for each user:

• Each avatar is accompanied by the display name its user entered in the welcome menu.

• Each avatar is assigned a random color.

• Users in the Walk and VR modes have an avatar that resembles a human shape as on the right in the image above. Users in other navigation modes are represented by a camera as on the left in the image above.

• All avatars move and rotate around the scene as their corresponding user moves and looks around, so that you can see where other users are focusing their attention.

4 - On Your Own

Now that you understand how to run the Collab Viewer Template and connect with others, you're ready to get started using the same runtime experience to review your own content. Continue on with the instructions in the Adding Your Own Content to the Collab Viewer Template guide for instructions on getting your own content added to the Project and set up to work in the same runtime experience.