Ugrás a fő tartalomhoz
Ön a fejlesztői dokumentációt nézi
Ez a dokumentáció a Base44 fejlesztői platformmal dolgozó fejlesztőknek szól.
Az actor egy hosszan futó backend-folyamat, amelyhez egyszerre több kliens csatlakozik. Actorokkal olyan élő munkamenet-példányokat építhet, amelyek a következő funkciókat támogatják:
  • Valós idejű üzenetküldés: Üzenetek küldése és fogadása a kliensekkel WebSocketen keresztül.
  • Tartós tárolás: A munkamenet állapotának megőrzése a tétlen időszakok között.
  • Ütemezett munka: Logika futtatása meghatározott időközönként vagy adott időpontban.
Actorokat akkor használjon, ha olyan funkciókat épít, ahol több kliensnek valós idejű frissítésekre és interakcióra van szüksége, például egy csevegőszobát vagy egy többjátékos játékot.

Actorok

Az Actor az az osztály, amelyet a backendben kiterjeszt. Az actorosztály egy élő munkamenet viselkedését határozza meg. Actorokkal a következőket teheti:
  • Kapcsolatok kezelése: Egy munkamenethez csatlakozó kliens elfogadása vagy elutasítása, és a csatlakozó azonosítása.
  • Üzenetek kezelése: Üzenet fogadása egy klienstől, a munkamenet-állapot frissítése, és válasz egy kliensnek vagy szétküldés mindenkinek.
  • Munka ütemezése: Logika futtatása időközönként vagy ütemezett időpontban.

Munkamenetek

A munkamenet egy actor futó példánya, amelyet az actor neve és egy Ön által választott munkamenet-azonosító azonosít.
Minden munkamenet önállóan kezeli a saját állapotát, tárolóját és klienskapcsolatait.

Kapcsolatok

A kapcsolat egy kliens munkamenethez vezető WebSocketje. Minden csatlakozó kliens egyedi kapcsolatot kap. Az actor ezzel a kapcsolattal azonosítja a csatlakozót, kezeli a klienskapcsolatokat és küld üzeneteket. További információ: kapcsolatok. Mintafolyamatért lásd: kliensek kapcsolatainak kezelése.

Aktív és tétlen munkamenetek

Egy munkamenet mindig a következő állapotok egyikében van:
  • Aktív: A munkamenet élő, és eseményeket dolgoz fel. Egy munkamenet akkor válik aktívvá, amikor egy kliens csatlakozik, amikor egy kliens üzenetet küld egy tétlen munkamenetnek, vagy amikor elérkezik egy ütemezett ébresztési idő.
  • Tétlen: A munkamenet nem dolgoz fel eseményeket. Egy munkamenet röviddel azután válik tétlenné, hogy befejezte az utolsó üzenetet, és minden ütemezett munka leállt. A munkamenet megtartja a tárolt adatait, az ütemezett időpontokat és a nyitott kapcsolatokat, amíg újra aktívvá nem válik.
Amikor egy munkamenet tétlenné válik, a nyitott kapcsolattal rendelkező kliensek csatlakozva maradnak. A következő üzenetük vagy egy ütemezett ébresztés újra aktiválja a munkamenetet.

Kliens

A JavaScript SDK base44.actors moduljával csatlakoztathat egy klienst egy actor-munkamenethez, és cserélhet üzeneteket. Az actors SDK a következő funkciókat támogatja:
  • Connect: WebSocket-kapcsolat megnyitása egy munkamenethez.
  • Subscribe: Üzenetek fogadása az actortól.
  • Send: Üzenetek küldése az actornak.
  • Close: Az actorhoz vezető WebSocket-kapcsolat lezárása.
  • Call methods: Az actor egyik hívható metódusának futtatása egy munkamenetben csatlakozás nélkül, egy oldalról vagy szerverkódból.
További információ: kliens csatlakoztatása egy munkamenethez.

Hogyan működnek együtt az actorok és a kliensek

A következő diagram a kliens és az actor közötti általános interakciót mutatja:
  1. A kliens WebSocketen keresztül csatlakozik az actorhoz.
  2. A munkamenet aktiválódik. A handleStart() az első indításkor és minden alkalommal lefut, amikor a munkamenet tétlen állapotból aktiválódik.
  3. Az actor kezeli a kapcsolatot. Ellenőrizheti a kliens azonosságát és elutasíthatja a kapcsolatot, vagy elküldheti az aktuális állapotot.
  4. A kliens üzenetet küld.
  5. Az actor kezeli az üzenetet. A munkamenet-állapot módosítása előtt ellenőrizheti a formátumot és a küldő jogosultságait.
  6. Az actor szétküldi a frissítést minden csatlakozott kliensnek, vagy csak a küldőnek válaszol.
  7. A kliens lezárja a kapcsolatot.
  8. Az actor kezeli a kapcsolatbontást. Eltávolíthatja a kapcsolatonkénti állapotot.

Valós idejű üzenetek

Minden csatlakozott kliens egy munkamenethez tartozik, és WebSocketen keresztül valós időben küldhet üzeneteket. A kliensek a subscribe() metódussal a bejövő üzenetekre is figyelhetnek.
A Base44 több valós idejű funkciót kínál, amelyek feliratkozásalapú figyelőt használnak:
  • Az actor subscribe() metódusa az actor által a csatlakozott klienseknek küldött üzenetekre figyel.
  • Az entitás subscribe() metódusa az alkalmazás entitásainak változásaira figyel.
Ellenőrizze, melyik szolgáltatást használja, hogy a várt eseményeket kapja.
Valós idejű üzenetekkel a következőket teheti:
  • Válasz egy adott kliensnek.
  • Szétküldés minden csatlakozott kliensnek.
  • Az éppen csatlakozott kliensek listázása.
  • Az egyes kliensek azonosítása, és annak ellenőrzése, hogy a kliens bejelentkezett-e.
További információ: kapcsolatok. Mintafolyamatért lásd: kliensek kapcsolatainak kezelése.

Üzenettípusok

A kliens és az actor egy kapcsolaton keresztül cserél üzeneteket. Az üzenetek a következő típusokba sorolhatók:
  • Bejövő üzenetek: Amit egy csatlakozott kliens küld az actornak, például egy szöveg, egy lépés vagy egy szavazat. A kliens a send() metódussal küldi őket, az actor pedig a handleMessage() kezelőben fogadja.
  • Kimenő üzenetek: Amit az actor küld a csatlakozott klienseknek, például egy válasz egy kliensnek, egy szétküldés minden csatlakozott kliensnek, vagy az aktuális tábla, amikor valaki csatlakozik. Az actor a conn.send() vagy a broadcast() metódussal küldi őket, a kliens pedig egy subscribe() visszahívásban fogadja.
Javasoljuk, hogy típusokat adjon az üzeneteknek, hogy az actor és a kliens egyetértsen az egyes üzenetek szerkezetében:
  • Backend: Adja át az Incoming és az Outgoing típust generikus paraméterként az Actor osztálynak. Teljes példáért lásd: actor létrehozása.
  • Kliens: Bővítse az ActorRegistry interfészt ugyanezekkel a szerkezetekkel, hogy a TypeScript ellenőrizze a send() és a subscribe() típusait.

Tárolás

Az actorok több tárolási lehetőséget kínálnak attól függően, hogyan használja és őrzi meg az adatokat a munkamenet:
  • Memóriabeli tárolás: Munkaállapot, amely a munkamenet aktív ideje alatt az osztálymezőkben él, és a munkamenet tétlenné válásakor visszaáll.
  • Tartós tárolás: Kulcs-érték tároló azokhoz az adatokhoz, amelyeknek meg kell maradniuk, amikor a munkamenet tétlenné válik.

Memóriabeli tárolás

Az osztálymezők a munkamenet aktív ideje alatt tárolják a munkaállapotot, például az aktuális táblát vagy egy körszámlálót. Memóriabeli tárolást akkor használjon, ha az adatok gyakran változnak, és nem kell megmaradniuk, amikor a munkamenet tétlenné válik, például egy élő pontszám vagy egy kurzorpozíció esetén. Amikor egy munkamenet tétlenné válik, az osztálymezők visszaállnak.

Tartós tárolás

Minden munkamenetnek saját kulcs-érték tárolója van, amelyet teljes egészében Ön kezel. Tartós tárolást akkor használjon, ha az adatoknak meg kell maradniuk, amikor a munkamenet tétlenné válik, például csevegési előzmények vagy egy játéktábla esetén. Az egész alkalmazásban elérhető adatok tárolásához használjon entitásokat. Az actorok tárolásáról további információ: tárolás.

Az állapot visszaállítása

Amikor egy munkamenet tétlenné válik, a memóriabeli állapot visszaáll. A tartós tároló megmarad, de a munkamenet aktiválódáskor nem tölti vissza automatikusan a tárolt adatokat a memóriába. A tartós adatok, például a csevegési előzmények vagy a játéktábla visszaállításához használja a handleStart() kezelőt. Mintafolyamatért lásd: munkamenetadatok megőrzése.

Ütemezett munka

Az actorok lehetővé teszik, hogy egy munkamenet a kliensüzenetektől függetlenül, ütemezetten futtasson logikát:
  • Tickek: Kód futtatása időközönként, és a munkamenet aktívan tartása, amíg ismétlődnek.
  • Ébresztések: Egyszeri futás egy Ön által választott időpontban, akár aktív, akár tétlen a munkamenet.

Tickek

A tickek időközönként futtatnak kódot, és aktívan tartják a munkamenetet, amíg ismétlődnek. A shouldTick() metódussal adhatja meg, milyen feltételek mellett fusson a tickelés. Az actor minden kapcsolat, üzenet, kapcsolatbontás és tick után újraértékeli a shouldTick() értékét, így a tickelés azonnal leáll, amint a feltétel már nem teljesül.
A tickeléshez legalább egy csatlakozott kliens szükséges.
Tickekkel a következőket teheti:
  • Az egyes időközök hosszának kiválasztása.
  • Feltétel megadása, amely elindítja és leállítja a tickelést, például „legalább két játékos van a munkamenetben”.
  • Az időközönként futó kód megírása.
Tickekkel aktívan tarthat egy munkamenetet akkor is, ha a kliensek nem küldenek üzenetet, például egy körszámláló frissítésekor. A tickekről további információ: időzítőkezelők és beállítások, mintafolyamatért pedig lásd: tickek futtatása.

Ébresztések

Az ébresztés egyszer fut egy Ön által választott időpontban, akár aktív, akár tétlen a munkamenet. Ébresztésekkel a következőket teheti:
  • Az ébresztés futásának ütemezése.
  • Az ébresztéskor futó logika megvalósítása.
Ébresztéssel egyszeri műveletet ütemezhet, például egy játékkör lezárását, egy üres előtér bezárását, egy emlékeztető kiváltását vagy egy esemény adott időpontban való indítását. Az ébresztésekről további információ: időzítőkezelők és beállítások, mintafolyamatért pedig lásd: ébresztések ütemezése.

Actor telepítése

Az actorokat az actors deploy paranccsal telepítheti. A projekt összes erőforrásának egyszerre történő feltöltéséhez használja a deploy parancsot. A telepítés hozzáadja és frissíti a távoli actorokat, a többit pedig érintetlenül hagyja.

Actor törlése

Actor törlése:
  • Futtassa az actors delete parancsot a távoli actor Base44-ből való törléséhez.
  • Törölje az actor könyvtárát a helyi projektből.
Ha nem törli az actort a helyi projektből, a következő actors deploy vagy deploy parancs újra létrehozza és telepíti az actort a Base44-projektbe.

Lásd még

Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.