Live Session Management
Users are provided the ability to manage live sessions by having the ability to have session ownership, decide when and how to end and merge changes of a live session, and even concurrent live sessions are possible on a given base file.
Users can create, join, leave and end sessions at will. However, only the session owner (creator) may end a given session with options to merge the session changes.
New Session
Users can create a Live Session of their own on any USD file that has write permissions. Here are the steps:
Create a new Live Session from the app.
The top right corner of any Omniverse Application, left click the green live button to join or create the Default Live Session. Or right click the LIVE button in either (1) the main window, or in (2) the Layer window.
From the drop-down menu, select the “New Session” option to open the Create
New Session window.
Note
Auto Authoring mode is experimental and it is Off by default.
![Create a new session in Create](../_images/live_create_new_session.png)
Similar dialogs will appear in the connectors that support the Live workflow. The following example is from the Maya Legacy connector.
![Create a new session in maya](../_images/live_maya_create_new_session.png)
Join Session
Quick join
A left click on Live Session entry points automatically joins the Default Session. If a default session does not exist one is created for you.
Join a Named Live Session
Users can Join any existing session for a USD file, regardless of if anyone is currently in it. To join a named session, right click on Live Session entry points to launch a dialog and choose a Live Session to join.
If a session already exists, then the system will default to the “Join” option. Useful information about the session is displayed:
The most recent session is selected by default
A list of session participants is displayed
Each participant’s application is displayed
The participant who started the session is designated as (Owner)
![../_images/live_createapp_participants_list.png](../_images/live_createapp_participants_list.png)
Connectors have a similar dialog to Create, the following example is from the Maya Legacy connector:
![../_images/live_maya_join_session.png](../_images/live_maya_join_session.png)
Join by link
Collaborators can also join a with a link another user has provided.
Join by pasting an omniverse share link directly into the Join by Link dialog from the Live menu.
Join by pasting it into the USD Composer content browser and pressing return.
Join by clicking on an Omniverse share link and walking through the launcher to your preferred Omniverse application.
![../_images/live_composer_join_link.png](../_images/live_composer_join_link.png)
Exit a Live session
Depending on your role in the Live session, different options are presented to exit a live session.
Leave a Session
The act of leaving a session does not commit the work to the base file, and leaves the data in the live session. Users can continue to come and go and work.
In Create, there are two options to leave a session:
Left Click the LIVE button or Lightning bolt ⚡ to leave the session on a given layer.
Right Click the Live button ⚡ dropdown button to see a list of options. Select the Leave Session
The other participants will remain in Session after you leave. Note that there are other options available in the dropdown menu.
![Create live UI](../_images/live_create_live_ui.png)
Connectors have teh same visual langauge to Create app. To leave a session using a connector, the same icons and language is used.
![Create leave session options](../_images/live_right_click_leave_session_options.png)
Maya connector Live Session Leave confirmation dialog:
![Maya leave session options](../_images/live_leave_session.png)
End a Session
Ending a Live session is useful when work is finished and users want to commit their changes to the base file.
Note
Comiting changes to the original file is a destructive operation
Once the owner chooses to end the session, they will be presented with 2 options:
Merge changes and add a checkpoint description
Discard changes and end the session.
Merge Options
When End and Merge is selected, a session end message will display the following options:
Merge to corresponding layer: Merge changes to root layer and clears data from .live layer.
Merge to a new layer: Merge changes to a new layer and clears data from .live layer. Note that when merge to new layer is chosen, the new layer will guide you through saving it to a location on Nucleus and then insert it into the USD layer stack. However, the main USD file needs to be manually saved as an explicit step. This gives the user a chance to confirm or deny the changes.
Pick an existing layer to merge to: Merge changes to a selected layer and clears data from .live layer.
Do Not Merge: Leaves data where it is; does not clear data from .live layer.
![Live Mode Merge options in Create](../_images/live_create_merge_options.png)
Note
Not all merge options are available in all connectors or all touch points in the applications.
Connector Merge Examples
![Live Mode Merge options in Maya](../_images/live_merge_options.gif)
If you are not the session owner and attempt to end a session, the system will display the following warning:
![Permission denied dialog warning](../_images/live_leave_session_not_owner_warning.png)