Configuration
Configure the player with AI_PLAYER.setConfig(json) before init(). All options are optional.
The v2 SDK accepts the same base configuration options as the previous SDK (see the setConfig reference), plus the v2-specific options below.
v2-specific options
| Option | Type | Description |
|---|---|---|
continuousBackground | Boolean | (Beta) When enabled, the avatar's background continues seamlessly from the idle motion into speech instead of restarting from the first frame, so there is no visible jump when speech begins. (default: false) |
enableEarlyStart | Boolean | (Beta) Loads the first part of the idle background first and starts earlier, reducing time-to-first-render. (default: false) |
AI_PLAYER.setConfig({
continuousBackground: false,
enableEarlyStart: false,
});
Automatic mobile optimization
On mobile devices the player automatically shortens the idle background download so the avatar appears faster and uses less memory. This is applied automatically based on the device — there is no option to set. Desktop behavior is unchanged.
Beta
continuousBackground and enableEarlyStart are in beta and disabled by default. Enable them
per integration after testing.