Runtime error when I encounter a Convai Character with a character id on iOS

What do you need help with?

Bug report

Installation method

Unity Asset Store

Issue area

Build / Platform Compatibility

Impact

Blocker - I cannot continue

Unity version

Unity 6.5

Convai Unity SDK version

4.4.1

Target platform

iOS

Where does it happen?

Only after build

Short summary

Scene crashes as soon as the Convai character is detected.

What happened?

I built a custom scene and even tried this with the basic sample scene in the latest Convai update on the Unity Asset Store (4.4.1). I am using Unity 6.5. The project builds just fine. When I run it on my phone (iphone 17 pro max) it crashes. This happens only when there is a character ID on the convai character. If I remove the character ID from the inspector, the project runs, but of course I cannot interact with the character. In XCODE, I get a break like this when it crashes: “Thread 70: EXC_BAD_ACCESS (code=2, address=0x140000001b)” on the break line below:

0x1158989d0 <+13224>: sub x8, x29, #0xd8
0x1158989d4 <+13228>: ldur x7, [x8, #-0x100]
0x1158989d8 <+13232>: bl 0x114c463f4 ; quant_all_bands
→ 0x1158989dc <+13236>: add sp, sp, #0x50
0x1158989e0 <+13240>: sub x8, x29, #0x60

Screenshots, recording, logs, or minimal repro

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

Could you please download libraries for build target? And please share the log files.

I have the exact same issue. did you find a solution?

biography (1).txt (42.5 KB)

here’s the crash report from xcode

Which version of the Convai SDK are you using?

I use:

unity 6.0.4

convai 4.4.1

ios 26.6

xcode 26.0.1

Which phone are you using?

iPhone 15 pro.
also tested on iPad pro 13-inch M4 and got the same error.
also have an iphone 16 pro here that I can test on if that would help in any way.

Hi, could you please check the generated Xcode project and confirm the library ordering?

Go to:

TARGETS → UnityFramework → Build Phases → Link Binary With Libraries

or

UnityFramework → General → Frameworks and Libraries

Please verify that the libraries are ordered like this:

  1. “liblivekit_ffi.a”
  2. “Libraries/libiPhone-lib.a”

“liblivekit_ffi.a” should be linked before Unity’s “libiPhone-lib.a”.

Could you please confirm the current ordering or share a screenshot of this section?


looks like I’m missing 1. “Libraries/libiPhone-lib.a”

and under UnityFramework → Build Phases → Link Binary With Libraries I have nothing

  1. Go to Project Settings → Player → Configuration → Enable Mute Other Audio Sources and Prepare iOS for Recording.
  2. libiphone.a might not be there, so you can set the first order to liblivekit_ffi.a.

By making these two changes, you can create a new build and have a conversation with the character.

It works well now. Thank you very much for your help.

The only issue still is that the Hands Free mode always listens to itself and the conversation gets disrupted.

Do you have a solution for that? Or is there a quick way to have a functionality to touch and hold the phone’s touchscreen to speak?

For a quick fix, you can follow the steps.
Go to Convai Manager → Advanced Room Control → Barge In → Client Speech Detection and select Disable.

That one is by default Disabled.
At the end the following adjustment worked for me both on the PC and on the iPhone.

Thanks gain.