Skip to main content
Use this guide when your Flutter app already has avatar speech audio and needs AvatarKit to send that audio to Motion Server, receive motion data, and render the avatar locally on iOS or Android.

Flutter Direct Mode demo

Flutter reference implementation for the Direct Mode path.

​
SDK package setup

Add the package to your pubspec.yaml:
pubspec.yaml
dependencies:
  spatius: ^1.2.0
Install dependencies: 
flutter pub get

​
Integration flow

1

Create credentials

Create an App ID and Avatar ID in Spatius Studio, then mint a Session Token from your backend. See Credentials.
2

Initialize AvatarKit

Initialize the Flutter package with your App ID, Avatar ID, Session Token, and selected region.
3

Send avatar speech audio

Send PCM16 mono avatar speech audio to AvatarKit. Motion Server returns motion data, and AvatarKit renders the avatar locally through the native platform renderer. For audio source and timing guidance, see Audio.

​
Next steps

Flutter SDK reference

Package install, initialization, and core API shape.

Browse all demos

Every runnable demo by platform and integration path.