Conversation targeting

Find guides for choosing a targeting mode, tuning it, and scripting which character the player is addressing in a Convai Unity SDK room.

Conversation targeting is how the Convai Unity SDK decides which character a player is talking to when a room holds more than one. ConvaiManager re-evaluates the decision continuously and moves the conversation to the character the player is addressing, without a component to add or a field that must be filled in.

How conversation targeting works Understand view-direction scoring, why the target only moves willingly, and why targeting lives on the manager rather than a component.

Choose a targeting mode Pick between Look At, Proximity, and Manual based on your camera and control scheme.

Tune conversation targeting Adjust range, look angle, switch margin, and switch delay to fit your scene.

Script the conversation target Move the conversation from code with TalkTo, and set which character a room opens on with SetInitialCharacter.

Write a custom targeting rule Replace the built-in modes entirely by implementing IConversationTargetProvider.

Conversation targeting reference Look up every public member of ConversationTargetingOptions and its defaults.

Troubleshoot conversation targeting Fix a target that will not switch, one that flickers, or one that never moves at all.

How targeting fits into a scene

Targeting only has something to decide once a scene registers more than one ConvaiCharacter with ConvaiManager — a room with one character has nothing to choose between. The setting lives under Convai Manager → Who The Player Talks To in the Inspector, and that section appears only once a second character is present. See How multi-character sessions work for how a room assembles its roster before targeting has anything to act on.

Next steps

Start with How conversation targeting works to understand the model, then Choose a targeting mode to pick the mode that fits your camera and controls.

Multi-character sessions