Custom Scene Setup

Add required Convai scene objects

• In Unity top menu, go to GameObject → Convai → Setup Required Components or Right-click in the Hierarchy → Convai → Setup Required Components

• Confirm and proceed in the popup.

• Expected result: These objects exist in your scene:

  • [Convai Service Bootstrap]

  • [Convai Composition Root]

  • [Convai Room Manager]

Create or select your Player object

• Select your existing player GameObject, or create an empty one.

• Add Convai Player Component.

• Set Player Name.

• Expected result: The scene has exactly one configured Convai Player.

Add Convai Character components

For each character GameObject you want to make conversational:

• Add Convai Character component

• Set Character ID

Get your Character ID from Convai

• In Convai dashboard, open your character and copy its ID.

Validate your scene setup

• Use one of the validation options:

  • Top menu: GameObject → Convai → Validate Scene Setup

  • Hierarchy right-click: Convai → Validate Scene Setup

• Expected result: A success message like:

  • “Scene setup is correct!” and the number of Convai Characters found.

Run a conversation test

• Press Play

• Speak using microphone or use Chat UI if present

• Expected result: Characters respond. Microphone conversation is hands-free (no push-to-talk required).