VideoAvatarManagerService

Der VideoAvatarManagerService ermöglicht dir die Steuerung des Video-Avatar-Hintergrundbildes. Du kannst Hintergrundbilder setzen, entfernen und auf Änderungen reagieren.

Zugriff

const avatar = RAGAI.VIDEO_AVATAR;

---

Methoden

setBackgroundImage(source)

Setzt das Hintergrundbild des Video-Avatars. Du kannst entweder eine Skill-ID oder eine direkte URL übergeben.

Parameter:

Parameter	Typ	Pflicht	Beschreibung
source	string	Ja	Skill-ID eines Bild-Skills oder eine direkte Bild-URL

Rückgabe: Promise<void>

// Hintergrundbild per Skill-ID setzen
await RAGAI.VIDEO_AVATAR.setBackgroundImage("skill-12345");

// Hintergrundbild per URL setzen
await RAGAI.VIDEO_AVATAR.setBackgroundImage("https://example.com/hintergrund.jpg");

---

unsetImage()

Entfernt das aktuelle Hintergrundbild des Video-Avatars.

Rückgabe: Promise<void>

await RAGAI.VIDEO_AVATAR.unsetImage();

---

getBackgroundImage()

Gibt die aktuelle Hintergrundbild-Quelle zurück.

Rückgabe: Promise<string> – Die Skill-ID oder URL des aktuellen Hintergrundbildes.

const aktuellesBild = await RAGAI.VIDEO_AVATAR.getBackgroundImage();
console.log("Aktuelles Hintergrundbild:", aktuellesBild);

---

Events

onBackgroundUpdate

Wird ausgelöst, wenn das Hintergrundbild aktualisiert wird.

RAGAI.VIDEO_AVATAR.onBackgroundUpdate(() => {
  console.log("Hintergrundbild wurde aktualisiert.");
});

onBackgroundDelete

Wird ausgelöst, wenn das Hintergrundbild entfernt wird.

RAGAI.VIDEO_AVATAR.onBackgroundDelete(() => {
  console.log("Hintergrundbild wurde entfernt.");
});

---

Vollständiges Beispiel

async function avatarHintergrundVerwalten() {
  // Event-Listener registrieren
  RAGAI.VIDEO_AVATAR.onBackgroundUpdate(() => {
    RAGAI.MSG.botMessage("Das Hintergrundbild wurde geändert.");
  });

  RAGAI.VIDEO_AVATAR.onBackgroundDelete(() => {
    RAGAI.MSG.botMessage("Das Hintergrundbild wurde entfernt.");
  });

  // Aktuelles Bild prüfen
  const aktuell = await RAGAI.VIDEO_AVATAR.getBackgroundImage();

  if (aktuell) {
    // Bild ersetzen
    await RAGAI.VIDEO_AVATAR.setBackgroundImage("https://example.com/neuer-hintergrund.jpg");
  } else {
    // Neues Bild setzen
    await RAGAI.VIDEO_AVATAR.setBackgroundImage("skill-67890");
  }
}

// Hintergrundbild zurücksetzen
async function hintergrundZuruecksetzen() {
  await RAGAI.VIDEO_AVATAR.unsetImage();
  RAGAI.MSG.botMessage("Hintergrundbild wurde zurückgesetzt.");
}