Multi-character sessions

Find guides for running several Convai characters in one Unity scene, choosing who the player talks to, and testing the shared room.

A multi-character session is a Unity scene where two or more ConvaiCharacter components are active at once, sharing one room with Convai. The player addresses one character at a time, and the SDK works out which — no mode to switch on, no component to add, and no field to fill. Use these pages to add a second character to a working scene, understand how the room decides who is being addressed, and identify each character correctly once more than one shares the room.

How multi-character sessions work Understand how the room forms around the active characters in a scene, and how it decides who the player is addressing.

Build your first multi-character session Add a second character to a working scene and confirm the room addresses whichever one the player looks at.

Character identity Give every character in a room its own Character ID, and understand what happens when two characters share one.

Multi-Character Sample Import the shipped sample scene and see several characters, interaction targeting, and a transcript UI working together.

Two questions a multi-character scene raises

Adding a second character to a scene raises two questions that a single-character scene never asks: who is the player talking to, and can the player talk right now. Each has its own feature area.

Conversation targeting How the SDK decides which character the player is addressing, and how to script or tune that decision.

Conversation availability Whether the addressed character can hear the player yet, and how to gate your own UI on that state.

Next steps

Start with Build your first multi-character session to add a second character to a scene and confirm the room reaches it, then read Character identity before assigning Character IDs to more than one character.

How multi-character sessions work