This guide will show you how to integrate the Convai and NVIDIA Omniverse using the Convai Extension plugin.
To install the Convai Omniverse Extension, follow these steps:
Download the latest version of the extension.
Extract the zip file into your chosen directory.
Open the Omniverse app of your choice (e.g Code) and from the Window
menu click Extensions
.
Click the green plus icon in the Edit column and add the absolute path to the exts
folder found in the repository directory.
Select the Third Party
tab and search for Convai
in the top left search bar, make sure to check Enabled.
The Convai window should appear, drag it and dock it in any suitable area of the UI.
If the Convai window does not appear, go to the Window
menu and select Convai
from the list.
To add your API Key and Character ID, follow these steps:
Sign up at Convai.
On the website click the gear icon in the top-right corner of the playground then copy and paste the API key into the Convai API Key
field in the Convai extension window.
Go to the Dashboard and on the left panel and either create a new character or select a sample one.
Copy the Character ID and paste it in the Character ID
field in the extension window.
Click Start Talking
to initiate the conversation
Click Stop
when done talking for the character to respond.
Open your chosen Omniverse app (e.g., Code).
Go to File->Open
and navigate to the repo directory.
Navigate to <repo directory>/ConvaiDemoStage/ConvaiDemo.usd
and click `open it.
Click Start Talking
in the Convai
window to talk to the character then click Stop
to send the request.
Actions can be used to trigger events with the same name as the action in the Action graph
. They can be used to run animations based on the action received. To try out actions:
Add a few comma-separated actions to Comma seperated actions
field (e.g jump, kick, dance, etc.).
The character will select one of the actions based on the conversation and run any event with the same name as the action in the Action Graph
.
The demo stage includes only talk and idle animations. However, it is possible to add more animations and trigger them using the action selected by the character. More on that in the future.
In the Extensions
tab, click the gear icon in the top right.
Click the play
button from the Toolbar
menu on the left.