3D Avatar Asset Implementation

Anforderungen an 3D-Modelle

• Format:
  Das Modell muss im GLB-Format vorliegen.

• Skeleton:
  Das Skeleton des Basis-Model-Mesh muss verknüpft sein. Alle 3D-Assets müssen exakt das gleiche Skeleton wie der Basis-Avatar verwenden. Und das Asset muss über den korrekten Anchor für die jeweiligen Kategorie mit dem Skeleton verknüpft sein.

• Dimensionen:
  Das Modell muss in seinen Abmessungen passen – es sollten definierte Grenzen eingehalten werden, sodass das Asset innerhalb der erlaubten Dimensionen bleibt.

• Materialien:

  • mat-primary: Wird für Klamotten verwendet; Standardfarbe ist schwarz (laut Farbpalette links oben), außer bei Haaren (dann braun).

  • mat-skin: Standard-Hautfarbe, typischerweise die fünfte Farbe in der Farbpalette.

Schritte zur Integration

1. Eindeutige Benennung:
   Definieren Sie einen eindeutigen Namen für das Asset. Es gilt dabei folgendes Benennungsschema einzuhalten:
   "aa-" + Bezeichnung Kategorie + Eindeutige individuelle Asset Bezeichnung
   z.B. aa-glasses-sunglass

2. 3D-Modell importieren:
   Importieren Sie das 3D-Modell (GLB) in das 2D3DAdLer Repo in das Verzeichnis "src/Assets/3dModels/sharedModels/avatar/ + jeweilige Kategorie"

3. Thumbnail integrieren:
   Importieren Sie das zugehörige Thumbnail (PNG) in das 2D3DAdLer Repo in das Verzeichnis "src/Assets/avatarEditorThumbnails + jeweilige Kategorie".

4. Asset als Type hinzufügen:
   Legen Sie in der Datei src/Components/Core/Domain/AvatarModels/AvatarModelTypes.ts einen neuen Typ für das Modell in der jeweiligen Kategorie an.
   z.B. "GlassesSunglass: "glasses-sunglass",

5. Übersetzung anpassen:
   Ergänzen Sie in der Lokalisierungsdatei src/localize/de/avatarEditor.json den entsprechenden deutschen Übersetzungsnamen für den neuen Typ (z. B. "glasses-sunglass": "Sonnenbrille",).

6. Überprüfung:
   Testen Sie in der Vorschau, ob:

   • Die Farbe des Modells und der Haut korrekt dargestellt wird und korrekt verändert werden kann

   • Die Animationen und Positionierung stimmen.

   • Das Asset in verschiedenen Konstellationen anderes Assets korrekt angezeigt wird.