Skip to main content
Du siehst gerade die Entwicklerdokumentation
Diese Dokumentation richtet sich an Entwickler, die mit der Base44-Entwicklerplattform arbeiten.
Erstelle einen Actor, um Backend-Logik für eine Live-Session auszuführen. Mehrere Clients teilen sich diese Session, etwa einen Chatraum oder ein Multiplayer-Spiel. Ein Actor verarbeitet Client-Verbindungen, Nachrichten und Verbindungsabbrüche in deinem Backend.

Actor-Dateien

Erstelle Actors als TypeScript-Dateien im Actors-Verzeichnis deines Projekts. Jeder Actor liegt in einem eigenen Unterverzeichnis unter base44/actors/ mit einer Datei entry.ts:
base44
actors
chatRoom
entry.ts
Der Ordnername wird zum Actor-Namen im SDK. Er bestimmt, wie Clients den Actor aufrufen, zum Beispiel base44.actors.chatRoom. Exportiere die Actor-Klasse als Default-Export aus der Datei entry.ts. Du kannst weitere .ts-, .js-, .json- und .jsonc-Dateien in das Actor-Verzeichnis legen und sie aus entry.ts importieren.

entry.ts

Die Codedatei enthält deine Actor-Klasse. Importiere Actor aus base44:runtime/actors und exportiere eine Klasse, die Actor erweitert, als Default-Export. Übergib die Generics Incoming und Outgoing, um die Nachrichten zu typisieren, die der Actor empfängt und sendet. Implementiere die folgenden Klassenmethoden. Die Methode handleStart() ist optional:
  • handleStart(): Lade gespeicherte Session-Daten aus dem Speicher in Klassenfelder. Base44 ruft diesen Handler bei jeder Aktivierung der Session auf. So ist dein wiederhergestellter Zustand bereit, bevor Base44 eine Verbindung verarbeitet. Ein vollständiges Speicherbeispiel findest du unter Session-Daten persistieren.
  • handleConnect(): Sende den aktuellen Session-Zustand an den verbindenden Client. Wie du Verbindungen ablehnst oder Clients identifizierst, erfährst du unter Client-Verbindungen verwalten.
  • handleMessage(): Aktualisiere den Session-Zustand, persistiere ihn und sende die Änderung per Broadcast.
  • handleClose(): Entferne jeglichen Zustand, der an diese Verbindung gebunden ist. Wenn es keinen Verbindungszustand zu löschen gibt, schreibe einen leeren Rumpf.
  • handleTick(): Führe Code in jedem Tick-Intervall aus. Wenn der Actor keine Ticks verwendet, schreibe einen leeren Rumpf. Wie du Ticks einrichtest, erfährst du unter Ticks ausführen. Wie du einen einmaligen Wake planst, erfährst du unter Wakes planen.
Das folgende Beispiel zeigt einen vereinfachten ChatRoom-Actor:

Siehe auch

Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der englischen Version.