Core concepts

Find explanations for how the Convai Unity SDK works at runtime — connection management, session state, turn-taking, and event-driven scene responses.

The Core Concepts section explains the systems that run beneath every Convai character in your scene — the runtime layers that manage connections, the session state machine that governs each character's lifecycle, the turn-taking system that controls who speaks and when, and the event components that let your scene react to what happens at runtime.

Start with Runtime architecture if you are new to the SDK internals. Read the other pages when you need to configure a specific system or understand why the SDK behaves a certain way.

Runtime architecture Runtime layers, interface inventory, and what you can replace.

Session lifecycle State machine, per-character sessions, persistence, and reconnection.

Turn-taking modes Hands-free vs. push-to-talk — every field and policy explained.

Event system Relay components, payload types, and subscription patterns.