.ADOBECONNECT

Mit dem AdobeconnectManagerService (RAGAI.ADOBECONNECT) kannst du auf Adobe Connect-Sitzungsinformationen zugreifen, wenn der Bot in einem Adobe Connect-Raum als Pod eingebettet ist. Du kannst Nutzerdaten, Teilnehmerlisten, Rollen und Raum-Informationen abfragen sowie Sync-Nachrichten an andere Pods senden.

Voraussetzung

Diese API funktioniert nur, wenn der Bot in einem Adobe Connect-Raum eingebettet ist. Außerhalb von Adobe Connect liefern die Methoden keine Ergebnisse.

---

Nutzer-Informationen

.myUser()

Gibt das vollständige Nutzerobjekt des aktuellen Teilnehmers zurück.

Rückgabewert: Promise<AdobeConnectUser> — { id: string, name: string, fullName: string, role: string }

const user = await RAGAI.ADOBECONNECT.myUser();
console.log(user.name, user.role); // z. B. "Max", "presenter"

.myUserName()

Gibt den Kurznamen des aktuellen Nutzers zurück.

Rückgabewert: Promise<string>

const name = await RAGAI.ADOBECONNECT.myUserName();
await RAGAI.MSG.botMessage(`Hallo ${name}!`);

.myUserFullName()

Gibt den vollständigen Namen des aktuellen Nutzers zurück.

Rückgabewert: Promise<string>

const vollName = await RAGAI.ADOBECONNECT.myUserFullName();
console.log("Voller Name:", vollName);

.myUserId()

Gibt die Adobe Connect-ID des aktuellen Nutzers zurück.

Rückgabewert: Promise<string>

const id = await RAGAI.ADOBECONNECT.myUserId();

.myUserRole()

Gibt die Rolle des aktuellen Nutzers zurück ("viewer", "presenter" oder "owner").

Rückgabewert: Promise<string>

const rolle = await RAGAI.ADOBECONNECT.myUserRole();
if (rolle === "owner") {
  await RAGAI.MSG.botMessage("Du bist Host dieses Meetings.");
}

---

Teilnehmerlisten

.getUserList()

Gibt die Liste aller Teilnehmer im Raum zurück.

Rückgabewert: Promise<AdobeConnectUser[]>

const teilnehmer = await RAGAI.ADOBECONNECT.getUserList();
teilnehmer.forEach(t => console.log(t.name, t.role));

.getUserCount()

Gibt die Gesamtanzahl aller Teilnehmer zurück.

Rückgabewert: Promise<number>

const anzahl = await RAGAI.ADOBECONNECT.getUserCount();
await RAGAI.MSG.botMessage(`Es sind ${anzahl} Teilnehmer im Raum.`);

.getParticipants()

Gibt nur die Teilnehmer mit der Rolle "viewer" zurück.

Rückgabewert: Promise<AdobeConnectUser[]>

const zuschauer = await RAGAI.ADOBECONNECT.getParticipants();

.getParticipantsCount()

Gibt die Anzahl der Teilnehmer (Viewer) zurück.

Rückgabewert: Promise<number>

const anzahl = await RAGAI.ADOBECONNECT.getParticipantsCount();

.getPresenters()

Gibt nur die Teilnehmer mit der Rolle "presenter" zurück.

Rückgabewert: Promise<AdobeConnectUser[]>

const presenter = await RAGAI.ADOBECONNECT.getPresenters();

.getPresentersCount()

Gibt die Anzahl der Presenter zurück.

Rückgabewert: Promise<number>

const anzahl = await RAGAI.ADOBECONNECT.getPresentersCount();

.getHosts()

Gibt nur die Teilnehmer mit der Rolle "owner" (Host) zurück.

Rückgabewert: Promise<AdobeConnectUser[]>

const hosts = await RAGAI.ADOBECONNECT.getHosts();

.getHostsCount()

Gibt die Anzahl der Hosts zurück.

Rückgabewert: Promise<number>

const anzahl = await RAGAI.ADOBECONNECT.getHostsCount();

---

Raum-Informationen

.selectedLayout()

Gibt den Namen des aktuell ausgewählten Layouts zurück.

Rückgabewert: Promise<string>

const layout = await RAGAI.ADOBECONNECT.selectedLayout();
console.log("Aktuelles Layout:", layout);

.isRecording()

Prüft, ob die Sitzung gerade aufgezeichnet wird.

Rückgabewert: Promise<boolean>

const aufnahme = await RAGAI.ADOBECONNECT.isRecording();
if (aufnahme) {
  await RAGAI.MSG.botMessage("Diese Sitzung wird aufgezeichnet.");
}

.getRecordingPlayState()

Gibt den aktuellen Wiedergabestatus der Aufnahme zurück.

Rückgabewert: Promise<boolean>

const playState = await RAGAI.ADOBECONNECT.getRecordingPlayState();

.isAddin()

Prüft, ob der Raum als Addin ausgeführt wird.

Rückgabewert: Promise<boolean>

const addin = await RAGAI.ADOBECONNECT.isAddin();

.getRoomUrl()

Gibt die URL des Adobe Connect-Raums zurück.

Rückgabewert: Promise<string>

const url = await RAGAI.ADOBECONNECT.getRoomUrl();
console.log("Raum-URL:", url);

.getPodTitle()

Gibt den Titel des aktuellen Pods zurück.

Rückgabewert: Promise<string>

const titel = await RAGAI.ADOBECONNECT.getPodTitle();

.getRoomSCOID()

Gibt die SCO-ID des Raums zurück.

Rückgabewert: Promise<string>

const scoId = await RAGAI.ADOBECONNECT.getRoomSCOID();

---

Kommunikation

.dispatchSyncMessage(name, value)

Sendet eine Sync-Nachricht an andere Pods im Adobe Connect-Raum. Damit kannst du Daten zwischen verschiedenen Pods austauschen.

Parameter	Typ	Beschreibung
name	string	Name / Typ der Nachricht
value	unknown	Der zu sendende Wert (wird serialisiert)

// Quiz-Ergebnis an andere Pods senden
RAGAI.ADOBECONNECT.dispatchSyncMessage("quiz-ergebnis", {
  nutzer: await RAGAI.ADOBECONNECT.myUserName(),
  punkte: RAGAI.SCORE.get()
});

---

AdobeConnectUser-Typ

type AdobeConnectUser = {
  id: string;       // Adobe Connect User-ID
  name: string;     // Kurzname
  fullName: string;  // Vollständiger Name
  role: string;      // "viewer", "presenter" oder "owner"
};

---

Vollständiges Beispiel

Ein Bot in Adobe Connect, der Teilnehmer begrüßt und rollenabhängig reagiert:

await RAGAI.WAITFOR.initialIdle();

const name = await RAGAI.ADOBECONNECT.myUserName();
const rolle = await RAGAI.ADOBECONNECT.myUserRole();
const anzahl = await RAGAI.ADOBECONNECT.getUserCount();

await RAGAI.MSG.botMessage(
  `Willkommen ${name}! Du bist als **${rolle}** eingeloggt. Es sind ${anzahl} Personen im Raum.`
);

if (rolle === "owner") {
  await RAGAI.MSG.botMessage("Als Host kannst du das Quiz starten, sobald alle bereit sind.");
}