.SCORM
Brückt SCORM-LMS-API-Aufrufe (RAGAI.SCORM), mit Fallback auf eine Dummy-Implementierung außerhalb eines LMS.
Läuft der Bot nicht in einem SCORM-LMS (erkannt über runsinlms-URL-Parameter des Eltern-/Großeltern-Fensters),
liefert getApiHandle intern eine Fake-API zurück, die alle Werte nur in einem lokalen Objekt hält statt
an ein echtes LMS zu melden - Aufrufe schlagen also nie fehl, haben aber außerhalb eines LMS keine reale Wirkung.
Vor Aktionen, die auf ein echtes LMS angewiesen sind, sollte RAGAI.WAITFOR.scormInited() abgewartet werden.
Methoden
.runsInLms()
Prüft, ob der Bot aktuell eingebettet in einem LMS läuft.
Rückgabewert: boolean
true, wenn der Bot in einem LMS läuft.
.isFakeScorm()
Prüft, ob aktuell die Dummy-SCORM-API verwendet wird (kein echtes LMS gefunden).
Rückgabewert: boolean
true, wenn die Dummy-API aktiv ist.
.LMSSetValue(key, value?)
Setzt einen SCORM-Datenwert.
| Parameter | Typ | Beschreibung |
|---|---|---|
key | string | z.input<typeof scormSetValueSchema> | Der SCORM-Schlüssel, oder ein Objekt gemäß scormSetValueSchema. |
value | string | Der zu setzende Wert. |
Objekt-Form (validiert über scormSetValueSchema):
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
key | string | ✔ | Der SCORM-Schlüssel. |
value | string | ✔ | Der zu setzende Wert. |
Rückgabewert: void
.LMSFinish()
Beendet die SCORM-Sitzung.
Rückgabewert: string
"true" bei Erfolg.
.LMSIsInitialized()
Prüft, ob die SCORM-API initialisiert wurde.
Rückgabewert: string
"true", wenn initialisiert.
.LMSCommit()
Bestätigt (committet) alle gesetzten SCORM-Werte an das LMS.
Rückgabewert: string
"true" bei Erfolg.
.LMSInitialize()
Initialisiert die SCORM-API-Verbindung zum LMS.
Rückgabewert: string
"true" bei Erfolg.
.LMSGetValue(key)
Liest einen SCORM-Datenwert.
| Parameter | Typ | Beschreibung |
|---|---|---|
key | string | z.input<typeof scormKeySchema> | Der SCORM-Schlüssel, oder ein Objekt gemäß scormKeySchema. |
Objekt-Form (validiert über scormKeySchema):
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
key | string | ✔ | Der SCORM-Schlüssel. |
Rückgabewert: string | undefined
Der gespeicherte Wert, oder undefined.