Import and run sample scenes

Import the bundled sample scenes and verify the SDK is installed and connected correctly before building your own scene.

The Convai SDK for Unity ships with two sample scenes. Running one is the fastest way to confirm your installation, API key, and audio setup are working before you build your own scene.

Sample	Description
Basic Sample	Basic conversation with a robot character
LipSync Sample	High-quality character with real-time lip sync

The steps for locating the samples differ depending on how you installed the SDK.

Package Manager

1

Open Package Manager

In the Unity Editor, open Window > Package Manager. In the top-left dropdown, select In Project, then select Convai SDK for Unity from the list.

2

Import a sample

In the detail panel on the right, click the Samples tab. Click Import next to the sample you want to run.

Unity copies the sample assets into Assets/Samples/Convai SDK for Unity/<version>/. A new folder appears under Assets/Samples/ in the Project window.

3

Open the scene

In the Project window, navigate to the imported sample folder and open its .unity scene file.

Asset Store

Once the scene is open:

1

Enter Play Mode

Press Play. The Unity Console logs the following lines as the SDK initializes:

• [ConvaiRuntime] Started successfully — SDK initialized all internal services

• [RoomConnectionRuntimeAdapter] Character <character-id> connected successfully (mode=create). — character connected to Convai

Speak into your microphone. The character responds with voice and text output.

If no response appears and the Console shows warnings, check Validate your setup for a diagnostic checklist.

Sample render pipeline notes

Sample scenes are built with the Universal Render Pipeline (URP). If your project uses a different render pipeline, materials may appear pink after import. Convert the materials to match your active render pipeline using Edit > Rendering > Materials, then select the appropriate conversion option for your pipeline.

Next steps

Now that you have confirmed the SDK is working, learn what each scene component does before building your own setup.

Scene components reference