- 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.
Actorok
AzActor 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.
Kliens
A JavaScript SDKbase44.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.
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:- A kliens WebSocketen keresztül csatlakozik az actorhoz.
- 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. - Az actor kezeli a kapcsolatot. Ellenőrizheti a kliens azonosságát és elutasíthatja a kapcsolatot, vagy elküldheti az aktuális állapotot.
- A kliens üzenetet küld.
- 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.
- Az actor szétküldi a frissítést minden csatlakozott kliensnek, vagy csak a küldőnek válaszol.
- A kliens lezárja a kapcsolatot.
- 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 asubscribe() 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.
- 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.
Ü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 ahandleMessage()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 abroadcast()metódussal küldi őket, a kliens pedig egysubscribe()visszahívásban fogadja.
- Backend: Adja át az
Incomingés azOutgoingtípust generikus paraméterként azActorosztálynak. Teljes példáért lásd: actor létrehozása. - Kliens: Bővítse az
ActorRegistryinterfészt ugyanezekkel a szerkezetekkel, hogy a TypeScript ellenőrizze asend()és asubscribe()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 ahandleStart() 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. AshouldTick() 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.
- 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.
É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.
Actor telepítése
Az actorokat azactors 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 deleteparancsot 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
- Actor létrehozása: Actorfájlok és egy minimális osztály
- Actorok: mintafolyamatok: Életciklus, időzítők, kapcsolatok, tárolás, entitások és backend-függvények
- Actorfájlok és -kód: A teljes backend-osztály API-ja
- Az
actorsSDK referenciája: A kliens SDK API-ja
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.