VimeoManagerService

Der VimeoManagerService ermöglicht dir die Steuerung eines eingebetteten Vimeo-Players. Du kannst Videos laden, abspielen, pausieren, die Lautstärke anpassen und Player-Farben konfigurieren.

Zugriff

const vimeo = RAGAI.VIMEO;

---

Methoden

play()

Startet oder setzt die Wiedergabe des aktuellen Videos fort.

Rückgabe: Promise<void>

await RAGAI.VIMEO.play();

---

pause()

Pausiert die Wiedergabe des aktuellen Videos.

Rückgabe: Promise<void>

await RAGAI.VIMEO.pause();

---

currentPlayPosition()

Gibt die aktuelle Wiedergabeposition in Sekunden zurück.

Rückgabe: Promise<number> – Die aktuelle Position in Sekunden.

const position = await RAGAI.VIMEO.currentPlayPosition();
console.log("Aktuelle Position:", position, "Sekunden");

---

seekTo(hours, minutes, seconds)

Springt zu einer bestimmten Position im Video.

Parameter:

Parameter	Typ	Pflicht	Beschreibung
hours	number	Ja	Stunden
minutes	number	Ja	Minuten
seconds	number	Ja	Sekunden

Rückgabe: Promise<void>

// Zu Minute 5:00 springen
await RAGAI.VIMEO.seekTo(0, 5, 0);

// Zu 1 Stunde, 10 Minuten, 30 Sekunden springen
await RAGAI.VIMEO.seekTo(1, 10, 30);

---

setVolume(percentageVolume)

Setzt die Lautstärke des Players.

Parameter:

Parameter	Typ	Pflicht	Beschreibung
percentageVolume	number	Ja	Lautstärke in Prozent (0–100)

Rückgabe: Promise<number> – Die tatsächlich gesetzte Lautstärke.

const lautstaerke = await RAGAI.VIMEO.setVolume(75);
console.log("Lautstärke gesetzt auf:", lautstaerke);

---

setPlaybackRate(playbackRate)

Setzt die Wiedergabegeschwindigkeit.

Parameter:

Parameter	Typ	Pflicht	Beschreibung
playbackRate	number	Ja	Geschwindigkeit (z. B. 0.5, 1, 1.5, 2)

Rückgabe: Promise<void>

// Halbe Geschwindigkeit
await RAGAI.VIMEO.setPlaybackRate(0.5);

// Doppelte Geschwindigkeit
await RAGAI.VIMEO.setPlaybackRate(2);

---

getColors()

Gibt die aktuellen Player-Farben zurück.

Rückgabe: Promise – Die aktuelle Farbkonfiguration.

const farben = await RAGAI.VIMEO.getColors();
console.log("Aktuelle Farben:", farben);

---

setColors(colors)

Setzt die Player-Farben. Erwartet ein Array mit Farbwerten.

Parameter:

Parameter	Typ	Pflicht	Beschreibung
colors	array	Ja	Array mit Farbwerten (Hex-Codes)

Rückgabe: Promise

await RAGAI.VIMEO.setColors(["#00adef", "#ffffff", "#000000"]);

---

loadVideo(id?, url?, object?)

Lädt ein neues Video in den Player. Du kannst das Video per ID, URL oder als Objekt referenzieren.

Parameter:

Parameter	Typ	Pflicht	Beschreibung
id	string	Nein	Vimeo-Video-ID
url	string	Nein	Vimeo-Video-URL
object	object	Nein	Video-Konfigurationsobjekt

Rückgabe: Promise

// Per Video-ID laden
await RAGAI.VIMEO.loadVideo("123456789");

// Per URL laden
await RAGAI.VIMEO.loadVideo(null, "https://vimeo.com/123456789");

// Per Konfigurationsobjekt laden
await RAGAI.VIMEO.loadVideo(null, null, { id: "123456789", autoplay: true });

---

Vollständiges Beispiel

async function vimeoWorkflow() {
  // 1. Video laden
  await RAGAI.VIMEO.loadVideo("123456789");
  RAGAI.MSG.botMessage("Vimeo-Video wird geladen...");

  // 2. Player anpassen
  await RAGAI.VIMEO.setVolume(60);
  await RAGAI.VIMEO.setPlaybackRate(1);
  await RAGAI.VIMEO.setColors(["#1abc9c", "#2c3e50"]);

  // 3. Wiedergabe starten
  await RAGAI.VIMEO.play();
}

async function vimeoNavigation() {
  // Aktuelle Position abrufen
  const pos = await RAGAI.VIMEO.currentPlayPosition();
  RAGAI.MSG.botMessage("Aktuelle Position: " + Math.floor(pos) + " Sekunden");

  // 30 Sekunden vorspulen
  const neueSekunden = pos + 30;
  const stunden = Math.floor(neueSekunden / 3600);
  const minuten = Math.floor((neueSekunden % 3600) / 60);
  const sekunden = Math.floor(neueSekunden % 60);
  await RAGAI.VIMEO.seekTo(stunden, minuten, sekunden);
}

---

Tipps

• Die Vimeo-Video-ID findest du in der Vimeo-URL, z. B. https://vimeo.com/123456789 → ID ist 123456789.
• Verwende getColors() und setColors(), um den Player an das Design deines Bots anzupassen.
• Mit currentPlayPosition() kannst du den Fortschritt des Nutzers tracken.