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.
Használja ezeket a mintafolyamatokat kiindulópontként a megvalósításhoz.

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:
  1. Hívja meg a base44.actors.ActorName(sessionId) metódust a munkamenet kiválasztásához.
  2. Hívja meg a .connect() metódust a WebSocket-kapcsolat megnyitásához.
  3. Hívja meg a conn.subscribe() metódust egy figyelő regisztrálásához az actortól érkező üzenetekhez.
  4. Hívja meg a conn.send() metódust üzenet küldéséhez az actornak.
A következő példa egy chatRoom actor-munkamenethez csatlakozik, figyeli az üzeneteket, és üzenetet küld:
A kapcsolatokról további információt a kapcsolatok részben talál.

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:
  1. Állítsa a tickIntervalMs értékét az időköz ezredmásodpercben megadott hosszára.
  2. Valósítsa meg a shouldTick() metódust úgy, hogy true értéket adjon vissza a tickek folytatásához, és false értéket a leállításhoz.
  3. A handleTick() metódusban futtassa az egyes időközök munkáját.
A következő példa másodpercenként tickel, amíg legalább két kliens van a munkamenetben, és minden ticknél visszaszámlálást küld szét:
A tickekről további információt az időzítőkezelők és -beállítások részben talál.

É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:
  1. Hívja meg a schedule() metódust egy kulccsal és egy időponttal az ébresztés élesítéséhez.
  2. A handleWake() metódusban ellenőrizze a kulcsot, és futtassa az adott ébresztés munkáját.
  3. Ha az ébresztés már nem érvényes, hívja meg a cancelSchedule() metódust a kulccsal.
A következő példa egy kör kezdetekor időtúllépést ütemez, és az időtúllépés bekövetkezésekor üzenetet küld szét:
Az ébresztésekről további információt az időzítőkezelők és -beállítások részben talál.

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:
  1. A handleConnect() metódusban ellenőrizze a conn.identity értékét, és egy kliens elutasításához hívja meg a conn.reject() metódust.
  2. Hívja meg a conn.send() metódust, ha csak annak a kliensnek szeretne válaszolni.
  3. A handleMessage() metódusban hívja meg a broadcast() metódust az összes csatlakozott kliens eléréséhez. A küldő azonosításához tegye bele az üzenetbe a conn mezőit.
A következő példa elutasítja a névtelen klienseket, előzményeket küld a csatlakozó kliensnek, és a küldő felhasználói azonosítójával küldi szét az üzeneteket:
A kapcsolatokról további információt a kapcsolatok részben talál.

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:
  1. Az actorban írja meg a metódust, és adja meg a nevét a static callable listában.
  2. A metódusban ellenőrizze az identity értékét, és egy hívó elutasításához dobjon ActorError hibát. Ha a hívó nevében szeretne eljárni, adja át a request értéket a createClientFromRequest() függvénynek.
  3. 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.
  4. Hívja meg a metódust egy oldalról a base44.actors.ActorName(sessionId).methodName(args), szerverkódból pedig a base44.asServiceRole.actors.ActorName(sessionId).methodName(args) formában.
A következő példában csak egy adminisztrátor vagy az alkalmazás szerverkódja törölheti egy tábla tartalmát:
A következő példák egy oldalról és egy backend-függvényből hívják meg a metódust:
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:
  1. A handleStart() metódusban töltse be az értékeket a this.storage tárolóból az osztálymezőkbe.
  2. Minden módosítás után hívja meg a this.storage.put() metódust a frissített érték mentéséhez.
  3. A munkamenet alaphelyzetbe állításához hívja meg a this.storage.delete() vagy a this.storage.deleteAll() metódust.
A következő példa indításkor betölt egy táblát, minden lépés után menti, és törli a tárolót, amikor az utolsó kliens is lecsatlakozik:
A tárolásról további információt a tárolás részben talál.

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:
  1. Írás előtt validálja a beérkező üzenetet.
  2. Olvassa ki a felhasználói azonosítót a conn.identity.userId értékből.
  3. Emelt szintű hozzáféréshez használja a this.client.asServiceRole klienst. Stabil kulccsal, például a munkamenet-azonosítóval írjon, hogy egy ismételten lefutó kezelő ugyanazt a rekordot frissítse.
A következő példa elmenti a hitelesített kliens végső pontszámát. Ugyanannak a munkamenetnek egy későbbi mentése ezt a rekordot frissíti:
Az entitáshozzáférésről további információt az entitáshozzáférés részben talál.

Backend-függvény hívása titkos adatot igénylő munkához

Az actorok a secrets.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:
  1. 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.
  2. Egy kezelőben hívja meg a this.client.functions.invoke() metódust a függvény nevével és a küldendő adatokkal.
  3. Használja az eredményt a munkamenetben, például küldje szét a csatlakozott klienseknek.
A következő példa egy backend-függvényt mutat, amely kiolvas egy API-kulcsot, és fordítást ad vissza:
A következő példa egy actorból hívja meg ezt a függvényt, és szétküldi az eredményt:

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.