Avatar Information

Overview

Every avatar is backed by a structured configuration manifest containing asset URLs, Draco compression hashes, material parameters, and version tags.

Data Schema Reference

interface AsiystAvatarManifest {
  id: string;              // avt_01h8x9a2b
  name: string;            // "Nova Assistant"
  projectId: string;       // proj_9f8a2b3c4d
  version: number;         // 3
  modelUrl: string;        // "https://cdn.asiyst.com/avatars/avt_.../model.glb"
  dracoCompressed: boolean;// true
  trianglesCount: number;  // 14200
  scale: number;           // 1.0
  anchorPosition: "bottom-right" | "bottom-left" | "top-right" | "top-left";
  states: {
    idle: string;          // "animation_idle_loop"
    walking: string;       // "animation_walk"
    talking: string;       // "animation_talk"
    thinking: string;      // "animation_think"
  };
}

Model File Specifications

• Format: glTF 2.0 Binary (.glb)

• Polygon Limit: Max 50,000 triangles (recommended: 10,000–25,000)

• Texture Maps: Albedo, Normal, Roughness/Metallic (max 2048x2048 PNG/WebP)

Immutable Release Versioning

Every published avatar iteration increments the version counter. If an updated model introduces unintended visual bugs, roll back instantly to any prior release version in the dashboard.