I have a problem with external character

What do you need help with?

Documentation / Learning Resource issue

Installation method

Unity Asset Store

Issue area

Character Setup

Impact

Blocker - I cannot continue

Unity version

6.4

Convai Unity SDK version

4.4.0

Target platform

Windows

Where does it happen?

Sample scene

Short summary

I don’t know how to use external character

What happened?

Hello, I wanted to know how to use characters that don’t come from Convai, since it is no longer possible to add them via “Import character.” I’ve seen this method used in various YouTube tutorials. How do I go about using a Convai avatar—or at least one compatible with it—now? Furthermore, in the section about importing custom character, the documentation says that the character ID must be entered, but if my character is external to Convai, what ID should I use?

I checked the relevant documentation, resources, and similar forum posts before posting.

on

I confirm that I did not include API keys, tokens, passwords, secrets, private character data, private conversation logs, or customer data.

on

Convai is not dependent on a specific character type. You can use your own custom character, a Reallusion character, or even Unity primitive objects.

If you want lip sync to work, the character needs to support blendshapes. We currently support ARKit, CC4 Extended, and MHA style mappings.

In the tutorials, we usually use Reallusion characters. You can create your character in Reallusion Character Creator, export it to Unity, and then set up your scene similarly to the sample scene.

For an easier setup, you can use the existing Convai character GameObject from the sample scene, remove the sample character model under it, and add your own Reallusion character prefab instead. After that, update the blendshape references in the lip sync and facial animation components using Auto Find.

Okay, but since I’m working on a university project and don’t have much time, I’ve been stuck on this for four days no2. Is it possible to use a Convai character that’s already set up? I have the character ID, I’d just need the prefab to continue with the configuration.

You can use the character from our sample scene.

ok i found a character in the SDK folder but now what ID i have to use for this prefab?

ok but i have this problem. When i use the character from the sample scene, the character is not configurated from the Convai website and for example, my avatar must talk in italian not in english. I tried changing the character ID to Convai’s while leaving the rest of the scene unchanged, but it doesn’t work. So, my question is: if I use the character prefab from the SDK, I can’t customize its responses to my liking, because that has to be done via the Convai website?

You only need to change the Character ID. No other changes are required.

I did that, but it’s not responding anymore now; I didn’t touch any other parameters, just the ID.

Please share the logs.

[12:25:49.855][Warning][SDK]: [RoomAudioRuntimeAdapter] Client-side Silero VAD is enabled but its optional inference module is unavailable. Install com.unity.ai.inference 2.2.1 or newer; server interruption remains active.

UnityEngine.Debug:LogWarning (object)
Convai.Runtime.Logging.UnityConsoleSink:Write (Convai.Domain.Logging.LogEntry) (at Assets/Convai SDK For Unity/SDK/Runtime/Logging/UnityConsoleSink.cs:38)
Convai.Domain.Logging.LogSinkExtensions:WriteIfEnabled (Convai.Domain.Logging.ILogSink,Convai.Domain.Logging.LogEntry&) (at Assets/Convai SDK For Unity/SDK/Domain/Logging/ILogSink.cs:52)
Convai.Runtime.Logging.ConvaiLogger:DispatchToSinks (Convai.Domain.Logging.LogEntry&) (at Assets/Convai SDK For Unity/SDK/Runtime/Logging/ConvaiLogger.cs:264)
Convai.Runtime.Logging.ConvaiLogger:LogMessageUnchecked (string,Convai.Domain.Logging.LogLevel,Convai.Domain.Logging.LogCategory,System.Exception) (at Assets/Convai SDK For Unity/SDK/Runtime/Logging/ConvaiLogger.cs:198)
Convai.Runtime.Logging.ConvaiLogger:LogMessage (string,Convai.Domain.Logging.LogLevel,Convai.Domain.Logging.LogCategory,System.Exception) (at Assets/Convai SDK For Unity/SDK/Runtime/Logging/ConvaiLogger.cs:169)
Convai.Runtime.Logging.ConvaiLogger:Convai.Domain.Logging.ILogger.Warning (string,Convai.Domain.Logging.LogCategory) (at Assets/Convai SDK For Unity/SDK/Runtime/Logging/ConvaiLogger.cs:531)
Convai.Domain.Logging.TaggedLogger:Warning (string,Convai.Domain.Logging.LogCategory) (at Assets/Convai SDK For Unity/SDK/Domain/Logging/TaggedLogger.cs:52)
Convai.Runtime.Adapters.Networking.RoomAudioRuntimeAdapter:StartClientVoiceActivityDetection (Convai.Infrastructure.Networking.IMicrophoneSource) (at Assets/Convai SDK For Unity/SDK/Runtime/Adapters/Networking/RoomAudioRuntimeAdapter.cs:392)
Convai.Runtime.Adapters.Networking.RoomAudioRuntimeAdapter:TrackMicrophoneSource (Convai.Infrastructure.Networking.IMicrophoneSource) (at Assets/Convai SDK For Unity/SDK/Runtime/Adapters/Networking/RoomAudioRuntimeAdapter.cs:352)
Convai.Runtime.Adapters.Networking.RoomAudioRuntimeAdapter/d__24:MoveNext () (at Assets/Convai SDK For Unity/SDK/Runtime/Adapters/Networking/RoomAudioRuntimeAdapter.cs:217)
System.Runtime.CompilerServices.AsyncTaskMethodBuilder1<bool>:SetResult (bool) Convai.Runtime.Networking.Media.AudioTrackManager/<RepublishMicrophoneAsync>d__37:MoveNext () (at Assets/Convai SDK For Unity/SDK/Runtime/Networking/Media/AudioTrackManager.cs:182) System.Runtime.CompilerServices.AsyncTaskMethodBuilder1:SetResult (bool)
Convai.Runtime.Networking.Media.AudioTrackManager/d__40:MoveNext () (at Assets/Convai SDK For Unity/SDK/Runtime/Networking/Media/AudioTrackManager.cs:247)
System.Runtime.CompilerServices.AsyncTaskMethodBuilder1<Convai.Infrastructure.Networking.ILocalAudioTrack>:SetResult (Convai.Infrastructure.Networking.ILocalAudioTrack) Convai.Runtime.Networking.Media.AudioTrackManager/<AwaitScheduledTaskAsync>d__611<Convai.Infrastructure.Networking.ILocalAudioTrack>:MoveNext () (at Assets/Convai SDK For Unity/SDK/Runtime/Networking/Media/AudioTrackManager.cs:595)
System.Threading._ThreadPoolWaitCallback:PerformWaitCallback ()

Could you please share a screenshot?

Also, does it work in the default sample scene? Please undo your custom changes and test again with the default setup.

Make sure you paste the correct Character ID as well.

this is the default prefab, with the ID of “Camilla” character, it works perfectly, when i change the ID, it works but the only thing is that the character don’t reply.

360f1c86-c98a-11ef-82c5-42010a7be016 Could you please test this character?

“Yes, this works, and the prefab code works too. The problem is that I have to use a custom character, and when I use the character ID that I configured on Convai, it doesn’t reply to my question.” I have to use an italian character not english.

Could you please share your character ID?

6e98288e-8a97-11f1-a8e6-42010a7be02f

I can see that you have used your full Free plan quota.

The problem occurred even with lower usage values.

Could you please try using a different LLM?