The AvatarKit client lifecycle from initialization and asset loading through rendering, interaction, and cleanup.
AvatarKit follows the same client lifecycle across integrations. What changes is who owns the connection and audio path, not how the Avatar is loaded and rendered.
Initialize
Initialize AvatarKit once when the application starts. This establishes shared configuration before any Avatar is loaded.Initialization automatically checks rendering support. Applications can also run the device-support check first to choose an alternative UI on unsupported devices. The check distinguishes rendering support from recommended performance on native platforms; see the platform reference for results and timing. Native initialization starts the check asynchronously, while Web initialization waits for it.On Web, rendering verification can select WebGL2 automatically when WebGPU is available but fails to render. A support check does not replace waiting for the avatar view’s first-render callback.
Load
Load the selected avatar-id before creating its view. AvatarKit downloads and caches the avatar assets; loading the same Avatar again can reuse that cache.See Avatar for the asset mental model.
Render
Mount the loaded Avatar into an Avatar view. The view owns the render surface and its controller, and can show idle animation before a conversation begins.Treat the view and its controller as one lifecycle unit. Recreate or release them together when the Avatar changes.new AvatarView(...) starts asynchronous renderer initialization. The constructor returning does not mean that the view can accept motion data yet. Set onFirstRendering immediately after construction and wait for that callback before starting a controller, creating an RTC player, or joining an RTC room.
const avatarView = new AvatarView(avatar, container)await new Promise<void>((resolve) => { avatarView.onFirstRendering = resolve})
Connect
Connect only after onFirstRendering has fired and the Avatar is ready to render. The selected integration determines the connection owner:
In Direct Mode, AvatarKit connects to Motion Server.
In the recommended integrations, the client joins the configured RTC room while the agent runtime owns the Motion Server session.
Follow the setup and Client pages for your path from Integrations. Do not reuse a Direct Mode connection sequence in another integration.
Interact
During a response, AvatarKit keeps avatar speech audio and motion data synchronized. Your UI can observe conversation state and control playback, including pause, resume, and interruption.See Audio for input timing and Client State & Events for observable state.
Cleanup
Release the Avatar view, controller, and any transport listeners when the screen or session ends. Cleanup behavior differs slightly by client platform; use the platform reference for the exact API:Web · iOS · Android · Flutter
Do not leave an old view or transport subscription alive after switching Avatars. Stale callbacks can update a view that is no longer visible.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Spatius","colors":{"primary":"#9399E3","light":"#9A9AC0","dark":"#9A9AC0"},"logo":{"light":"https://mintcdn.com/spatius/wOjIDpP8OnEpRngp/images/spatius-logo-wordmark-black.png?fit=max\u0026auto=format\u0026n=wOjIDpP8OnEpRngp\u0026q=85\u0026s=3a9b7965a4bcfae37a65eefa457011ba","dark":"https://mintcdn.com/spatius/wOjIDpP8OnEpRngp/images/spatius-logo-wordmark-white.png?fit=max\u0026auto=format\u0026n=wOjIDpP8OnEpRngp\u0026q=85\u0026s=432ca82121812857d15cb7a85a90de0a"},"favicon":{"light":"https://mintcdn.com/spatius/KgLGkQWTJjnB2fTn/images/spatius-logo-mark-black.svg?fit=max\u0026auto=format\u0026n=KgLGkQWTJjnB2fTn\u0026q=85\u0026s=b3a8b579d89d1a5e93f73c732d20404d","dark":"https://mintcdn.com/spatius/KgLGkQWTJjnB2fTn/images/spatius-logo-mark-white.svg?fit=max\u0026auto=format\u0026n=KgLGkQWTJjnB2fTn\u0026q=85\u0026s=6f430113e3cf1c19f51a0a54c202046a"},"navbar":{"links":[{"icon":"discord","href":"https://discord.com/invite/9HGhZfHZh9","label":"Community"}],"primary":{"type":"button","label":"Studio","href":"https://app.spatius.ai"}},"integrations":{"posthog":{"apiKey":"phc_BJpW8hXVP84eK4bnQsRevfNy7uDdD7PAmxafqxLBerfj","sessionRecording":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","grok","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spatius","hasAudioNarration":false,"actualSubdomain":"spatius","customDomains":["docs.spatius.ai"],"gitSource":{"type":"github","owner":"spatius-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afd52a2dd0acd4b075a59f8","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Guides","count":24},{"language":"default","tag":"SDK Reference","count":12},{"language":"default","tag":"API Reference","count":12},{"language":"default","tag":"Integrations","count":9},{"language":"default","tag":"Client SDKs","count":6},{"language":"default","tag":"Start Here","count":5},{"language":"default","tag":"Concepts","count":5},{"language":"default","tag":"Avatar API","count":5},{"language":"default","tag":"Agora ConvoAI","count":4},{"language":"default","tag":"Video API","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".docs-page,:root{--spatius-selection-background: rgba(147, 153, 227, 0.22);--spatius-selection-text: #11131f}html.dark,.dark,[data-theme=\"dark\"]{--spatius-selection-background: rgba(173, 175, 244, 0.28);--spatius-selection-text: #ffffff}::selection{color:var(--spatius-selection-text);background:var(--spatius-selection-background)}.spatius-comparison-recommended{display:inline-block;margin-top:0.35rem;padding:0.12rem 0.48rem;border-radius:999px;color:#5559a9;background:rgba(147, 153, 227, 0.18);font-size:0.72rem;font-weight:650;line-height:1.35;white-space:nowrap}html.dark .spatius-comparison-recommended,.dark .spatius-comparison-recommended,[data-theme=\"dark\"] .spatius-comparison-recommended{color:#c3c5ff;background:rgba(173, 175, 244, 0.16)}.spatius-diagram.spatius-flow-explorer{--spatius-tour-surface: transparent;--spatius-tour-box: var(--spatius-diagram-node);--spatius-tour-border: var(--spatius-diagram-stroke);--spatius-tour-ink: var(--spatius-diagram-ink);--spatius-tour-muted: var(--spatius-diagram-muted);--spatius-tour-focus: var(--spatius-diagram-brand);--spatius-tour-node: var(--spatius-diagram-stroke);--spatius-tour-network-line: var(--spatius-diagram-muted);--spatius-tour-network-surface: rgba(56, 189, 248, 0.16);--spatius-tour-owned: var(--spatius-diagram-owned);--spatius-tour-managed: var(--spatius-diagram-managed);--spatius-tour-flow: var(--spatius-diagram-ink);--spatius-tour-audio: #2563eb;--spatius-tour-motion: #946200;container:spatius-flow / inline-size;margin:0;overflow:visible}html.dark .spatius-flow-explorer,.dark .spatius-flow-explorer,[data-theme=\"dark\"] .spatius-flow-explorer{--spatius-tour-audio: #60a5fa;--spatius-tour-motion: #facc15;--spatius-tour-network-surface: rgba(125, 211, 252, 0.16)}.spatius-flow-controls{display:grid;gap:0.2rem;padding:0.55rem 0.8rem 0}.spatius-flow-source-row{display:flex;align-items:flex-end;justify-content:space-between;min-width:0;gap:1rem}.spatius-flow-latency{display:inline-flex;flex:0 0 auto;align-items:center;gap:0.32rem;padding:0.5rem 0 0.62rem;color:var(--spatius-tour-ink);font-size:0.8rem;font-weight:700;line-height:1.25;white-space:nowrap}.spatius-flow-latency-title{margin-right:0.08rem}.spatius-flow-latency-term{display:inline-flex;align-items:center;gap:0.32rem}.spatius-flow-latency-stage{display:inline-flex;width:1.14rem;height:1.14rem;align-items:center;justify-content:center;border:1.25px solid var(--spatius-tour-ink);border-radius:50%;font-size:0.76rem;font-weight:700;line-height:1}.spatius-flow-latency-stage.is-variable{border-style:dashed}.spatius-flow-latency-plus{color:var(--spatius-tour-muted);font-weight:600}.spatius-flow-segmented{display:inline-flex;min-width:0;gap:0.25rem;padding:0;border:0;border-bottom:1px solid var(--spatius-tour-border);border-radius:0;background:transparent}.spatius-flow-segmented:not(.spatius-flow-mode-options){justify-self:start}.spatius-flow-segmented button{appearance:none;position:relative;min-width:5rem;padding:0.5rem 0.72rem 0.62rem;border:0;border-radius:0;color:var(--spatius-tour-muted);background:transparent;cursor:pointer;font:inherit;font-size:0.76rem;font-weight:600;line-height:1.25;white-space:nowrap;transition:color 140ms ease}.spatius-flow-segmented button::after{position:absolute;right:50%;bottom:-1px;left:50%;height:2px;border-radius:999px;background:var(--spatius-tour-focus);content:\"\";transition:right 160ms ease, left 160ms ease}.spatius-flow-segmented button:hover:not(:disabled){color:var(--spatius-tour-ink)}.spatius-flow-segmented button:disabled{color:var(--spatius-tour-muted);cursor:not-allowed;opacity:0.42}.spatius-flow-segmented button:focus-visible{outline:3px solid var(--spatius-tour-focus);outline-offset:2px}.spatius-flow-segmented button[data-selected=\"true\"]{color:var(--spatius-tour-ink);background:transparent;box-shadow:none}.spatius-flow-segmented button[data-selected=\"true\"]::after{right:0.72rem;left:0.72rem}.spatius-flow-mode-options{display:grid;width:100%;gap:0;grid-template-columns:repeat(3, minmax(0, 1fr))}.spatius-flow-mode-options button{min-width:0}.spatius-flow-diagram-shell{position:relative}.spatius-flow-diagram{overflow:hidden}.spatius-tour-stage{display:block;width:100%;min-width:0;height:auto;color:var(--spatius-tour-ink)}.spatius-tour-stage-surface{fill:var(--spatius-tour-surface)}.spatius-flow-explorer .spatius-tour-stage-surface,.spatius-flow-explorer .spatius-tour-network{filter:none}.spatius-tour-network{fill:var(--spatius-tour-network-surface)}.spatius-tour-network-edge{stroke:var(--spatius-tour-network-line);stroke-width:2;stroke-dasharray:6 7}.spatius-tour-zone-label,.spatius-tour-network-label{fill:var(--spatius-tour-ink);font-size:21px;font-weight:600}.spatius-tour-network-label{fill:var(--spatius-tour-muted);font-size:11px}.spatius-tour-network-icon circle,.spatius-tour-network-icon path{fill:none;stroke:var(--spatius-tour-network-line);stroke-width:1.5}.spatius-tour-node rect{fill:var(--spatius-tour-box);stroke:var(--spatius-tour-border);stroke-width:3;transition:stroke 180ms ease, filter 180ms ease}.spatius-tour-node.is-owner rect{fill:var(--spatius-tour-owned)}.spatius-tour-node.is-service rect{fill:var(--spatius-tour-managed);stroke:var(--spatius-diagram-brand)}.spatius-tour-node.is-sdk rect{fill:var(--spatius-tour-box);stroke:var(--spatius-tour-border)}.spatius-tour-node.is-room rect{stroke:var(--spatius-tour-node);stroke-width:3}.spatius-tour-node.is-lit rect{animation:spatius-tour-node-pulse 260ms ease-out}.spatius-tour-node-label,.spatius-tour-owner-label{fill:var(--spatius-tour-ink);font-size:17px;font-weight:600}.spatius-tour-owner-label{font-size:15px}.spatius-tour-wire{fill:none;stroke:var(--spatius-tour-flow);stroke-width:2.5;stroke-linecap:round;stroke-linejoin:round;stroke-dasharray:none}.spatius-tour-wire.is-crossing{stroke-dasharray:7 8}.spatius-tour-footer-edge{stroke:var(--spatius-tour-border);stroke-width:1.5}.spatius-tour-legend-label{fill:var(--spatius-tour-ink);font-size:16px;font-weight:600}.spatius-tour-legend-orb.is-audio{color:var(--spatius-tour-audio)}.spatius-tour-legend-orb.is-motion{color:var(--spatius-tour-motion)}.spatius-tour-legend-orb-halo{fill:currentColor;opacity:0.3}.spatius-tour-legend-orb-core{fill:currentColor}.spatius-tour-arrow{fill:var(--spatius-tour-flow)}.spatius-tour-wire.is-active{animation:spatius-tour-wire-travel 248ms linear infinite}.spatius-tour-wire.is-active.is-crossing{animation-duration:1984ms}.spatius-tour-stage-number circle{fill:var(--spatius-tour-box);stroke:var(--spatius-tour-border);stroke-width:2}.spatius-tour-stage-number.is-variable circle{stroke-dasharray:4 3}.spatius-tour-stage-number text{fill:var(--spatius-tour-ink);font-size:12px;font-weight:700}.spatius-flow-status,.spatius-flow-seo-copy{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);clip-path:inset(50%);white-space:nowrap;border:0}.spatius-tour-packet{pointer-events:none}.spatius-tour-packet.is-audio{color:var(--spatius-tour-audio)}.spatius-tour-packet.is-motion{color:var(--spatius-tour-motion)}.spatius-tour-packet-core{fill:#ffffff}.spatius-tour-packet-halo{fill:currentColor;opacity:0.72}.spatius-tour-packet-glow{fill:currentColor;opacity:0.42;filter:url(#spatius-tour-packet-glow)}@keyframes spatius-tour-wire-travel{to{stroke-dashoffset:-30}}@keyframes spatius-tour-node-pulse{0%{filter:drop-shadow(0 0 0 transparent)}42%{filter:drop-shadow(0 0 12px color-mix(in srgb, var(--spatius-tour-node) 70%, transparent))}100%{filter:drop-shadow(0 0 0 transparent)}}@media (max-width: 720px){.spatius-flow-mode-options{grid-template-columns:minmax(0, 1fr)}}@media (max-width: 460px){.spatius-flow-controls{padding:0.65rem}.spatius-flow-source-row{align-items:stretch;flex-direction:column;gap:0}.spatius-flow-latency{align-self:flex-end}}@media (prefers-reduced-motion: reduce){.spatius-flow-segmented button,.spatius-flow-segmented button::after{transition:none}.spatius-tour-wire.is-active,.spatius-tour-node.is-lit rect{animation:none}.spatius-tour-packets{display:none}}.step-container{margin-bottom:0.25rem!important}.step-container+.step-container{margin-top:0.25rem!important}[class*=\"steps\"]{margin-top:1.5rem!important}[class*=\"steps\"] .step-container{margin-bottom:0.25rem!important}[class*=\"steps\"] .accordion-item{margin-bottom:0.25rem!important}.spatius-diagram{--spatius-diagram-ink: #171821;--spatius-diagram-box: rgba(248, 249, 255, 0.94);--spatius-diagram-managed: rgba(149, 153, 227, 0.1);--spatius-diagram-stroke: rgba(52, 55, 76, 0.38);--spatius-diagram-brand: #7478d9;--spatius-diagram-muted: rgba(60, 63, 82, 0.58);--spatius-diagram-blue: #7478e7;--spatius-diagram-livekit: rgb(31, 213, 249);--spatius-diagram-livekit-surface: rgba(31, 213, 249, 0.12);--spatius-diagram-red: #5fae88;--spatius-diagram-green: rgba(54, 105, 82, 0.82);--spatius-diagram-owned: rgba(54, 105, 82, 0.1);--spatius-diagram-node: rgba(246, 247, 253, 0.98);--spatius-diagram-white: #191a24;--spatius-diagram-muted-dark: rgba(64, 67, 86, 0.52);--spatius-diagram-glow: rgba(116, 120, 231, 0.28);--spatius-diagram-edge: rgba(255, 255, 255, 0.72);--spatius-diagram-warning: #d65f66;--spatius-diagram-warning-surface: rgba(214, 95, 102, 0.1);--spatius-diagram-warning-stroke: rgba(214, 95, 102, 0.48);width:100%;margin:0;overflow:visible;border-radius:6px;color:var(--spatius-diagram-ink)}.spatius-agora-diagram{--spatius-diagram-agora: rgb(91, 193, 251);--spatius-diagram-agora-surface: rgba(91, 193, 251, 0.12);--spatius-diagram-agora-stroke: rgba(91, 193, 251, 0.54)}.spatius-diagram svg{display:block;width:100%;max-width:100%;height:auto;color:var(--spatius-diagram-ink)}.spatius-diagram rect:not([fill=\"none\"]){filter:drop-shadow(0 18px 26px rgba(20, 22, 36, 0.1))}.spatius-diagram text{font-family:inherit;letter-spacing:0}.spatius-diagram-zone{fill:var(--spatius-diagram-managed);stroke-width:2.5}.spatius-diagram-orbit{fill:none;stroke:var(--spatius-diagram-brand);stroke-dasharray:2 10;stroke-linecap:round;stroke-width:2;opacity:0.55}.spatius-audio-bar{animation:spatius-audio-bar 1.08s ease-in-out infinite;fill:var(--spatius-diagram-brand);filter:drop-shadow(0 0 7px var(--spatius-diagram-glow));transform-box:fill-box;transform-origin:center}.spatius-audio-bar:nth-child(2){animation-delay:-0.86s}.spatius-audio-bar:nth-child(3){animation-delay:-0.62s}.spatius-audio-bar:nth-child(4){animation-delay:-0.44s}.spatius-audio-bar:nth-child(5){animation-delay:-0.18s}.spatius-audio-visualizer{opacity:0.96}.spatius-agent-pipeline,.spatius-agent-speech{pointer-events:none}.spatius-agent-pipeline{animation:spatius-agent-pipeline 9s ease-in-out infinite}.spatius-agent-speech{animation:spatius-agent-speech 9s ease-in-out infinite;opacity:0}.spatius-diagram-flow{filter:drop-shadow(0 0 5px var(--spatius-diagram-glow));stroke-dasharray:12 12;animation:spatius-diagram-flow 1.6s linear infinite}.spatius-audio-timing-diagram{--spatius-timing-good-distance: 108px;--spatius-timing-bad-distance: 108px;--spatius-diagram-warning: #c85b63;--spatius-diagram-warning-surface: rgba(200, 91, 99, 0.08);--spatius-diagram-warning-stroke: rgba(200, 91, 99, 0.42)}.spatius-audio-timing-diagram rect:not([fill=\"none\"]){filter:drop-shadow(0 12px 18px rgba(20, 22, 36, 0.08))}.spatius-timing-packet{filter:drop-shadow(0 0 8px var(--spatius-diagram-glow));transform-box:fill-box;transform-origin:center}.spatius-timing-packet-good{animation:spatius-timing-packet-good 1.45s ease-in-out infinite}.spatius-timing-packet-bad{animation:spatius-timing-packet-bad 4.2s ease-in-out infinite}.spatius-timing-delay-1{animation-delay:-0.48s}.spatius-timing-delay-2{animation-delay:-0.96s}.spatius-timing-window-pulse rect{animation:spatius-timing-window-pulse 2.2s ease-in-out infinite;transform-box:fill-box;transform-origin:center}.spatius-timing-window-pulse rect:nth-child(2){animation-delay:-1.45s}.spatius-timing-window-pulse rect:nth-child(3){animation-delay:-0.72s}.spatius-timing-blocker{animation:spatius-timing-blocker 2s ease-in-out infinite;filter:drop-shadow(0 0 6px rgba(200, 91, 99, 0.22));transform-box:fill-box;transform-origin:center}.spatius-timing-flow-bad{animation-duration:3.2s;filter:drop-shadow(0 0 4px rgba(200, 91, 99, 0.18))}@keyframes spatius-audio-bar{0%,100%{transform:scaleY(0.42)}45%{transform:scaleY(1)}70%{transform:scaleY(0.64)}}@keyframes spatius-diagram-flow{to{stroke-dashoffset:-24}}@keyframes spatius-timing-packet-good{0%{opacity:0;transform:translateX(0) scale(0.82)}15%,74%{opacity:1}100%{opacity:0;transform:translateX(var(--spatius-timing-good-distance)) scale(1)}}@keyframes spatius-timing-packet-bad{0%{opacity:0;transform:translateX(0) scale(0.82)}24%,70%{opacity:1}100%{opacity:0;transform:translateX(var(--spatius-timing-bad-distance)) scale(1)}}@keyframes spatius-timing-window-pulse{0%,100%{opacity:0.52;transform:scale(0.96)}45%{opacity:1;transform:scale(1.04)}}@keyframes spatius-timing-blocker{0%,100%{opacity:0.78;transform:scale(0.96)}50%{opacity:1;transform:scale(1.04)}}@keyframes spatius-agent-pipeline{0%,42%{opacity:1}48%,92%{opacity:0}98%,100%{opacity:1}}@keyframes spatius-agent-speech{0%,42%{opacity:0}48%,92%{opacity:1}98%,100%{opacity:0}}@media (prefers-reduced-motion: reduce){.spatius-diagram-flow{animation:none;stroke-dasharray:none}.spatius-audio-bar{animation:none}.spatius-agent-pipeline{animation:none;opacity:1}.spatius-agent-speech{animation:none;opacity:0}.spatius-timing-packet,.spatius-timing-window-pulse rect,.spatius-timing-blocker{animation:none}}html.dark .spatius-diagram,.dark .spatius-diagram,[data-theme=\"dark\"] .spatius-diagram{--spatius-diagram-ink: #f7f7fb;--spatius-diagram-box: rgba(31, 34, 48, 0.88);--spatius-diagram-managed: rgba(147, 153, 227, 0.16);--spatius-diagram-stroke: rgba(234, 235, 255, 0.24);--spatius-diagram-brand: #adaff4;--spatius-diagram-muted: rgba(232, 233, 246, 0.6);--spatius-diagram-blue: #9399e3;--spatius-diagram-livekit: rgb(31, 213, 249);--spatius-diagram-livekit-surface: rgba(31, 213, 249, 0.16);--spatius-diagram-red: #7bd4a8;--spatius-diagram-green: rgba(75, 126, 97, 0.78);--spatius-diagram-owned: rgba(75, 126, 97, 0.18);--spatius-diagram-node: rgba(43, 48, 67, 0.92);--spatius-diagram-white: #f7f7fb;--spatius-diagram-muted-dark: rgba(230, 230, 240, 0.5);--spatius-diagram-glow: rgba(147, 153, 227, 0.46);--spatius-diagram-edge: rgba(255, 255, 255, 0.2);--spatius-diagram-warning: #ff8a92;--spatius-diagram-warning-surface: rgba(255, 138, 146, 0.16);--spatius-diagram-warning-stroke: rgba(255, 138, 146, 0.58)}html.dark .spatius-agora-diagram,.dark .spatius-agora-diagram,[data-theme=\"dark\"] .spatius-agora-diagram{--spatius-diagram-agora-surface: rgba(91, 193, 251, 0.16);--spatius-diagram-agora-stroke: rgba(91, 193, 251, 0.62)}html.dark .spatius-audio-timing-diagram,.dark .spatius-audio-timing-diagram,[data-theme=\"dark\"] .spatius-audio-timing-diagram{--spatius-diagram-warning: #f27f88;--spatius-diagram-warning-surface: rgba(242, 127, 136, 0.13);--spatius-diagram-warning-stroke: rgba(242, 127, 136, 0.52)}.walkthrough-code pre{max-height:460px;overflow:auto;-webkit-overflow-scrolling:touch}.walkthrough-code [data-content-type=\"codeBlock\"]{max-height:460px;overflow:auto;-webkit-overflow-scrolling:touch}"}]}
{"page":{"pagePath":"concepts/lifecycle","slug":"/concepts/lifecycle","pageMetadata":{"title":"Client Lifecycle","sidebarTitle":"Client Lifecycle","description":"The AvatarKit client lifecycle from initialization and asset loading through rendering, interaction, and cleanup.","href":"/concepts/lifecycle"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The AvatarKit client lifecycle from initialization and asset loading through rendering, interaction, and cleanup.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Mermaid,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`AvatarKit follows the same client lifecycle across integrations. What changes is `,_jsx(_components.strong,{children:`who owns the connection and audio path`}),`, not how the Avatar is loaded and rendered.`]}),`\n`,_jsx(`div`,{style:{backgroundColor:`#ffffff`,border:`1px solid #e5e7eb`,borderRadius:12,padding:12},children:_jsx(Mermaid,{chart:`---\nconfig:\n \"look\": \"handDrawn\"\n \"theme\": \"base\"\n \"themeVariables\":\n \"background\": \"#ffffff\"\n \"textColor\": \"#111827\"\n \"lineColor\": \"#64748b\"\n \"primaryColor\": \"#e8f4fd\"\n \"primaryTextColor\": \"#111827\"\n \"primaryBorderColor\": \"#2196F3\"\n---\ngraph LR\n A[\"\u003cb>Initialize\u003c/b>\u003cbr/>configure AvatarKit\"]\n B[\"\u003cb>Load\u003c/b>\u003cbr/>download avatar assets\"]\n C[\"\u003cb>Render\u003c/b>\u003cbr/>mount the Avatar view\"]\n D[\"\u003cb>Connect\u003c/b>\u003cbr/>start or join the data path\"]\n E[\"\u003cb>Interact\u003c/b>\u003cbr/>play, pause, interrupt\"]\n F[\"\u003cb>Cleanup\u003c/b>\u003cbr/>release client resources\"]\n\n A --> B --> C --> D --> E --> F`,actions:false})}),`\n`,_jsx(Heading,{level:`2`,id:`initialize`,children:`Initialize`}),`\n`,_jsx(_components.p,{children:`Initialize AvatarKit once when the application starts. This establishes shared configuration before any Avatar is loaded.`}),`\n`,_jsx(_components.p,{children:`Initialization automatically checks rendering support. Applications can also run the device-support check first to choose an alternative UI on unsupported devices. The check distinguishes rendering support from recommended performance on native platforms; see the platform reference for results and timing. Native initialization starts the check asynchronously, while Web initialization waits for it.`}),`\n`,_jsx(_components.p,{children:`On Web, rendering verification can select WebGL2 automatically when WebGPU is available but fails to render. A support check does not replace waiting for the avatar view’s first-render callback.`}),`\n`,_jsx(Heading,{level:`2`,id:`load`,children:`Load`}),`\n`,_jsxs(_components.p,{children:[`Load the selected `,_jsx(_components.code,{children:`avatar-id`}),` before creating its view. AvatarKit downloads and caches the avatar assets; loading the same Avatar again can reuse that cache.`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/concepts/avatar`,children:`Avatar`}),` for the asset mental model.`]}),`\n`,_jsx(Heading,{level:`2`,id:`render`,children:`Render`}),`\n`,_jsx(_components.p,{children:`Mount the loaded Avatar into an Avatar view. The view owns the render surface and its controller, and can show idle animation before a conversation begins.`}),`\n`,_jsx(_components.p,{children:`Treat the view and its controller as one lifecycle unit. Recreate or release them together when the Avatar changes.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`new AvatarView(...)`}),` starts asynchronous renderer initialization. The constructor returning does not mean that the view can accept motion data yet. Set `,_jsx(_components.code,{children:`onFirstRendering`}),` immediately after construction and wait for that callback before starting a controller, creating an RTC player, or joining an RTC room.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` avatarView`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` AvatarView`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`avatar`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`container`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` Promise`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`void`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`>((`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`resolve`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` avatarView`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`onFirstRendering`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resolve`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`})`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`connect`,children:`Connect`}),`\n`,_jsxs(_components.p,{children:[`Connect only after `,_jsx(_components.code,{children:`onFirstRendering`}),` has fired and the Avatar is ready to render. The selected integration determines the connection owner:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`In Direct Mode, AvatarKit connects to Motion Server.`}),`\n`,_jsx(_components.li,{children:`In the recommended integrations, the client joins the configured RTC room while the agent runtime owns the Motion Server session.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Follow the setup and Client pages for your path from `,_jsx(_components.a,{href:`/integrations/overview`,children:`Integrations`}),`. Do not reuse a Direct Mode connection sequence in another integration.`]}),`\n`,_jsx(Heading,{level:`2`,id:`interact`,children:`Interact`}),`\n`,_jsx(_components.p,{children:`During a response, AvatarKit keeps avatar speech audio and motion data synchronized. Your UI can observe conversation state and control playback, including pause, resume, and interruption.`}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/concepts/audio`,children:`Audio`}),` for input timing and `,_jsx(_components.a,{href:`/concepts/state-events`,children:`Client State \u0026 Events`}),` for observable state.`]}),`\n`,_jsx(Heading,{level:`2`,id:`cleanup`,children:`Cleanup`}),`\n`,_jsx(_components.p,{children:`Release the Avatar view, controller, and any transport listeners when the screen or session ends. Cleanup behavior differs slightly by client platform; use the platform reference for the exact API:`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/sdk-reference/web-sdk/reference#avatarview`,children:`Web`}),` · `,_jsx(_components.a,{href:`/sdk-reference/ios-sdk/api-reference#avatarview`,children:`iOS`}),` · `,_jsx(_components.a,{href:`/sdk-reference/android-sdk/api-reference#avatarview`,children:`Android`}),` · `,_jsx(_components.a,{href:`/sdk-reference/flutter-sdk/api-reference#render-and-control-playback`,children:`Flutter`})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Do not leave an old view or transport subscription alive after switching Avatars. Stale callbacks can update a view that is no longer visible.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Client Lifecycle","sidebarTitle":"Client Lifecycle","description":"The AvatarKit client lifecycle from initialization and asset loading through rendering, interaction, and cleanup.","href":"/concepts/lifecycle"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Initialize","slug":"initialize","depth":2,"children":[]},{"title":"Load","slug":"load","depth":2,"children":[]},{"title":"Render","slug":"render","depth":2,"children":[]},{"title":"Connect","slug":"connect","depth":2,"children":[]},{"title":"Interact","slug":"interact","depth":2,"children":[]},{"title":"Cleanup","slug":"cleanup","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/spatius/842af4b2cdb9f6f1/ga4.js"],"subdomain":"spatius","siteName":"Spatius","title":"Client Lifecycle - Spatius","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T07:24:26.127Z","originalFileLocation":"concepts/lifecycle.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The AvatarKit client lifecycle from initialization and asset loading through rendering, interaction, and cleanup.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Spatius\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Client Lifecycle - Spatius\">\u003cmeta data-mint-head property=\"og:description\" content=\"The AvatarKit client lifecycle from initialization and asset loading through rendering, interaction, and cleanup.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Spatius\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spatius.ai/concepts/lifecycle\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spatius.mintlify.site/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Client+Lifecycle\u0026amp;description=The+AvatarKit+client+lifecycle+from+initialization+and+asset+loading+through+rendering%2C+interaction%2C+and+cleanup.\u0026amp;theme=3c6d6186e4656af8ad36b894\u0026amp;signature=69aa4d11dd77260a5d28b66cb7b8f6c75405a1ff237e2cdf52d0bedd990017be\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Client Lifecycle - Spatius\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The AvatarKit client lifecycle from initialization and asset loading through rendering, interaction, and cleanup.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spatius.mintlify.site/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Client+Lifecycle\u0026amp;description=The+AvatarKit+client+lifecycle+from+initialization+and+asset+loading+through+rendering%2C+interaction%2C+and+cleanup.\u0026amp;theme=3c6d6186e4656af8ad36b894\u0026amp;signature=69aa4d11dd77260a5d28b66cb7b8f6c75405a1ff237e2cdf52d0bedd990017be\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/spatius/w2LH48fbTgqvj-Bh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Spatius\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9399E3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.spatius.ai/concepts/lifecycle\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/concepts/lifecycle.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.spatius.ai/#organization\",\"name\":\"Spatius\",\"url\":\"https://docs.spatius.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spatius/wOjIDpP8OnEpRngp/images/spatius-logo-wordmark-black.png?fit=max\u0026auto=format\u0026n=wOjIDpP8OnEpRngp\u0026q=85\u0026s=3a9b7965a4bcfae37a65eefa457011ba\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.spatius.ai#website\",\"name\":\"Spatius\",\"url\":\"https://docs.spatius.ai\",\"publisher\":{\"@id\":\"https://docs.spatius.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.spatius.ai/concepts/lifecycle#webpage\",\"url\":\"https://docs.spatius.ai/concepts/lifecycle\",\"name\":\"Client Lifecycle\",\"description\":\"The AvatarKit client lifecycle from initialization and asset loading through rendering, interaction, and cleanup.\",\"dateModified\":\"2026-11-18T07:24:26.127Z\",\"isPartOf\":{\"@id\":\"https://docs.spatius.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spatius.ai/concepts/lifecycle#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spatius.ai/concepts/lifecycle#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Concepts\",\"item\":\"https://docs.spatius.ai/concepts/avatar\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Client Lifecycle\",\"item\":\"https://docs.spatius.ai/concepts/lifecycle\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.spatius.ai/concepts/lifecycle#article\",\"headline\":\"Client Lifecycle\",\"name\":\"Client Lifecycle\",\"description\":\"The AvatarKit client lifecycle from initialization and asset loading through rendering, interaction, and cleanup.\",\"url\":\"https://docs.spatius.ai/concepts/lifecycle\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spatius.ai/concepts/lifecycle#webpage\"},\"dateModified\":\"2026-11-18T07:24:26.127Z\",\"publisher\":{\"@id\":\"https://docs.spatius.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.spatius.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Spatius\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Spatius\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/concepts/lifecycle.md","siteName":"Spatius","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Start Here","icon":"rocket","pages":[{"title":"Welcome to Spatius","sidebarTitle":"Welcome","href":"/getting-started"},{"title":"How It Works","sidebarTitle":"How It Works","href":"/concepts/how-it-works"}]},{"group":"Quickstarts","icon":"bolt","pages":[{"title":"Web Quickstart","sidebarTitle":"Web","href":"/quickstarts/web-sdk"},{"title":"iOS Quickstart","sidebarTitle":"iOS","href":"/quickstarts/ios-sdk"},{"title":"Android Quickstart","sidebarTitle":"Android","href":"/quickstarts/android-sdk"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"Integrations","sidebarTitle":"Overview","href":"/integrations/overview"},{"group":"LiveKit Agents","tag":"Recommended","pages":[{"title":"LiveKit Agents Integration","sidebarTitle":"Overview","href":"/livekit-agents/overview"},{"title":"Set Up LiveKit Agents Integration","sidebarTitle":"Agent setup","href":"/livekit-agents/server"},{"title":"LiveKit Agents Integration Client","sidebarTitle":"Client","href":"/livekit-agents/client"}]},{"group":"Agora ConvoAI","tag":"Recommended","pages":[{"title":"Agora Convo AI Integration","sidebarTitle":"Overview","href":"/agora-convoai/overview"},{"group":"Agent setup","pages":[{"title":"Agora Convo AI Agent","sidebarTitle":"Convo AI Agent","href":"/agora-convoai/convo-ai-agent"},{"title":"TEN Framework Extension","sidebarTitle":"TEN Extension","href":"/agora-convoai/ten-extension"}]},{"title":"Agora Convo AI Client","sidebarTitle":"Client","href":"/agora-convoai/client"}]},{"group":"Direct Mode","pages":[{"title":"Direct Mode Client","sidebarTitle":"Client","href":"/direct-mode/client"}]}]},{"group":"Concepts","icon":"lightbulb","pages":[{"title":"Avatar","sidebarTitle":"Avatar","href":"/concepts/avatar"},{"title":"Avatar Background","sidebarTitle":"Background","href":"/concepts/avatar-background"},{"title":"Audio","sidebarTitle":"Audio","description":"How avatar speech audio is formatted, sent, finalized, and interrupted for synchronized Avatar playback.","href":"/concepts/audio"},{"title":"Client Lifecycle","sidebarTitle":"Client Lifecycle","href":"/concepts/lifecycle"},{"title":"Client State \u0026 Events","sidebarTitle":"Client State \u0026 Events","description":"The two client state dimensions to observe: Avatar conversation playback and Direct Mode connectivity.","href":"/concepts/state-events"}]},{"group":"Pricing","icon":"credit-card","pages":[{"title":"Custom Avatar Creation Pricing","sidebarTitle":"Custom Avatar Creation","href":"/pricing/custom-avatar-creation"},{"title":"Realtime Avatar Pricing","sidebarTitle":"Realtime Avatar","href":"/pricing/realtime-avatar"},{"title":"Video Generation Pricing","sidebarTitle":"Video Generation","href":"/pricing/video-generation"}]},{"group":"Examples \u0026 Support","icon":"book","pages":[{"title":"Demo Projects","sidebarTitle":"Demo Projects","href":"/resources/demo-projects"},{"title":"FAQ","href":"/resources/faq"}]}]},{"tab":"SDK Reference","pages":[{"title":"SDK Reference","href":"/reference/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]}]},"basePath":"","title":"Client Lifecycle - Spatius","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}