Kliens csatlakoztatása egy munkamenethez
Ha a frontendnek csatlakoznia kell egy élő munkamenethez, üzeneteket kell fogadnia az actortól és üzeneteket kell küldenie neki, csatlakoztasson egy klienst egy actor-munkamenethez. Kliens csatlakoztatása egy munkamenethez:- Hívja meg a
base44.actors.ActorName(sessionId)metódust a munkamenet kiválasztásához. - Hívja meg a
.connect()metódust a WebSocket-kapcsolat megnyitásához. - Hívja meg a
conn.subscribe()metódust egy figyelő regisztrálásához az actortól érkező üzenetekhez. - Hívja meg a
conn.send()metódust üzenet küldéséhez az actornak.
chatRoom actor-munkamenethez csatlakozik, figyeli az üzeneteket, és üzenetet küld:
Tickek futtatása
Ha egy munkát meghatározott időközönként kell ismételni, amíg kliensek vannak a munkamenetben, futtasson tickeket. Ilyen például a játékállapot szétküldése vagy egy kör időzítőjének frissítése. Tickek futtatása:- Állítsa a
tickIntervalMsértékét az időköz ezredmásodpercben megadott hosszára. - Valósítsa meg a
shouldTick()metódust úgy, hogytrueértéket adjon vissza a tickek folytatásához, ésfalseértéket a leállításhoz. - A
handleTick()metódusban futtassa az egyes időközök munkáját.
Ébresztések ütemezése
Ha egy munkát egyszer, egy adott időpontban kell futtatni, függetlenül attól, hogy a munkamenet aktív vagy tétlen, ütemezzen ébresztést. Ilyen például egy kör lezárása 30 másodperc után vagy egy üres váróterem bezárása. Ébresztés ütemezése:- Hívja meg a
schedule()metódust egy kulccsal és egy időponttal az ébresztés élesítéséhez. - A
handleWake()metódusban ellenőrizze a kulcsot, és futtassa az adott ébresztés munkáját. - Ha az ébresztés már nem érvényes, hívja meg a
cancelSchedule()metódust a kulccsal.
A klienskapcsolatok kezelése
Ha el kell döntenie, ki csatlakozhat egy munkamenethez, egy adott kliensnek kell válaszolnia, és a munkamenet minden kliensét el kell érnie, kezelje a klienskapcsolatokat. A klienskapcsolatok kezelése:- A
handleConnect()metódusban ellenőrizze aconn.identityértékét, és egy kliens elutasításához hívja meg aconn.reject()metódust. - Hívja meg a
conn.send()metódust, ha csak annak a kliensnek szeretne válaszolni. - A
handleMessage()metódusban hívja meg abroadcast()metódust az összes csatlakozott kliens eléréséhez. A küldő azonosításához tegye bele az üzenetbe aconnmezőit.
Egy munkamenet metódusának hívása
Ha a szerverkódnak frissítést kell küldenie egy munkamenetbe, vagy egy oldalnak műveletet kell végeznie egy munkamenetben anélkül, hogy élőben megjelenítené, csatlakozás helyett hívja meg az actor egyik metódusát. A hívás nem foglal helyet a munkamenetben, és akkor is működik, ha egyetlen kliens sincs csatlakozva. Egy munkamenet metódusának hívása:- Az actorban írja meg a metódust, és adja meg a nevét a
static callablelistában. - A metódusban ellenőrizze az
identityértékét, és egy hívó elutasításához dobjonActorErrorhibát. Ha a hívó nevében szeretne eljárni, adja át arequestértéket acreateClientFromRequest()függvénynek. - Módosítsa a munkamenetet, és hívja meg a
broadcast()metódust a csatlakozott kliensek frissítéséhez. Adja vissza a hívónak szánt választ. - Hívja meg a metódust egy oldalról a
base44.actors.ActorName(sessionId).methodName(args), szerverkódból pedig abase44.asServiceRole.actors.ActorName(sessionId).methodName(args)formában.
Szerverkódban a munkamenet-azonosítót megbízható adatból vegye, például egy ellenőrzött rekordból, ne a kliens nyers bemenetéből.
A munkamenetadatok megőrzése
Ha az értékeknek túl kell élniük egy tétlen időszakot, őrizze meg a munkamenetadatokat. Ilyen például egy játéktábla, egy előzménylista vagy az aktuális kör. A munkamenetadatok megőrzése:- A
handleStart()metódusban töltse be az értékeket athis.storagetárolóból az osztálymezőkbe. - Minden módosítás után hívja meg a
this.storage.put()metódust a frissített érték mentéséhez. - A munkamenet alaphelyzetbe állításához hívja meg a
this.storage.delete()vagy athis.storage.deleteAll()metódust.
Entitásadatok írása egy munkamenetből
Ha a munkamenetnek alkalmazásrekordokat kell létrehoznia vagy frissítenie, írjon entitásadatokat. Ilyen például egy végső pontszám vagy egy teljesített rendelés. Entitásadatok írása egy munkamenetből:- Írás előtt validálja a beérkező üzenetet.
- Olvassa ki a felhasználói azonosítót a
conn.identity.userIdértékből. - Emelt szintű hozzáféréshez használja a
this.client.asServiceRoleklienst. Stabil kulccsal, például a munkamenet-azonosítóval írjon, hogy egy ismételten lefutó kezelő ugyanazt a rekordot frissítse.
Backend-függvény hívása titkos adatot igénylő munkához
Az actorok asecrets.get() segítségével olvashatják az alkalmazás titkos adatait. Ha egy kezelőnek titkos adatot igénylő munkát kell végeznie, például API-kulccsal kell meghívnia egy külső API-t, javasoljuk, hogy hívjon meg egy backend-függvényt. A függvény kiolvassa a titkos adatot, és az eredményt adja vissza, soha nem magát a titkos adatot.
Backend-függvény hívása egy actorból:
- Hozzon létre egy backend-függvényt, amely a
secrets.get()segítségével kiolvassa a titkos adatot, elvégzi a munkát, és visszaadja az eredményt. - Egy kezelőben hívja meg a
this.client.functions.invoke()metódust a függvény nevével és a küldendő adatokkal. - Használja az eredményt a munkamenetben, például küldje szét a csatlakozott klienseknek.
Lásd még
- Az actorok áttekintése: Fogalmak és terminológia
- Actor létrehozása: Actorfájlok és egy minimális osztály
- Actorfájlok és -kód: A teljes backend-osztály API-ja
actors deploy: Helyi actorok telepítése
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.