> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actorfájlok és -kód

> Teljes referencia az Actor osztályhoz, a kezelőihez, a kapcsolatokhoz, a tárolóhoz és az időzítőkhöz

Ön a fejlesztői dokumentációt nézi

Ez a dokumentáció a Base44 fejlesztői
platformmal dolgozó fejlesztőknek szól.

Teljes referencia az alkalmazás backendjében futó `Actor` osztályhoz. A munkamenethez csatlakozó kliens-SDK-ról az [`actors` SDK-referenciában](https://docs.base44.com/developers/references/sdk/docs/type-aliases/actors) olvashat.

Az actorok fogalmairól és terminológiájáról az [actorok áttekintésében](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md) olvashat.

## Kötelező kezelők

Az `Actor` osztály absztrakt. Valósítsa meg az alábbi kezelők törzsét. A kezelők a kliensektől és az időzítőktől érkező eseményekre reagálnak.

| Kezelő | Események |
| - | - |
| [`handleConnect()`](#lifecycle-handlers) | Egy kliens csatlakozik. |
| [`handleMessage()`](#lifecycle-handlers) | Egy csatlakozott kliens üzenetet küld. |
| [`handleClose()`](#lifecycle-handlers) | Egy kliens bontja a kapcsolatot. |
| [`handleTick()`](#timer-handlers-and-settings) | Minden tick-időközben, amíg a tickelés be van kapcsolva. |

## Opcionális kezelők

Ha az actornak szüksége van rájuk, valósítsa meg ezeket a kezelőket.

| Kezelő | Események |
| - | - |
| [`handleStart()`](#lifecycle-handlers) | A munkamenet elindul, mielőtt a Base44 kapcsolatot kezelne. |
| [`shouldTick()`](#timer-handlers-and-settings) | Minden csatlakozás, üzenet, kapcsolatbontás és tick után. |
| [`handleWake()`](#timer-handlers-and-settings) | Elérkezik a `schedule()` metódussal beállított időpont. |

Ha a munkamenet tickel, állítsa be a [`tickIntervalMs`](#timer-handlers-and-settings) értékét. Ha elhagyja a `shouldTick()` metódust, a munkamenet soha nem tickel.

Ha azt szeretné, hogy az alkalmazás kódja csatlakozás nélkül futtathasson egy metódust egy munkameneten, sorolja fel a metódust a [`static callable`](#callable-methods) tömbben.

## Használható metódusok

Az actorosztály beépített funkciókat biztosít. Az actor kezelőinek megvalósításakor a következő metódusokat használhatja.

| Metódus | Cél |
| - | - |
| [`schedule()`](#timer-handlers-and-settings) | Ébresztés beállítása egy választott időpontra. |
| [`cancelSchedule()`](#timer-handlers-and-settings) | Ütemezett ébresztés törlése. |
| [`conn.send()`](#connections) | Válasz egy kliensnek. |
| [`conn.reject()`](#connections) | Csatlakozó kliens elutasítása. |
| [`broadcast()`](#connections) | A munkamenet összes kliensének elérése. |
| [`getConnections()`](#connections) | A csatlakozott kliensek listázása. |
| [`this.storage.get()`](#storage) | Mentett munkamenetérték olvasása. |
| [`this.storage.put()`](#storage) | Munkamenetérték mentése. |
| [`this.storage.delete()`](#storage) | Egy mentett érték eltávolítása. |
| [`this.storage.deleteAll()`](#storage) | A munkamenet tárolójának kiürítése. |
| [`secrets.get()`](#read-secrets) | Az alkalmazás egy titkos adatának olvasása. |

Az [entitások](https://docs.base44.com/hu/developers/backend/resources/entities/overview.md) olvasásához és írásához használja a [`this.client`](#entity-access) klienst.

## Osztálydeklaráció

Importálja az `Actor` osztályt a `base44:runtime/actors` modulból, és a `base44/actors/<actor-name>/entry.ts` fájlból alapértelmezett exportként exportáljon egy osztályt, amely kiterjeszti az `Actor` osztályt.
A mappa neve lesz az actor neve az SDK-ban. A beállítás részleteiről lásd: [actor létrehozása](https://docs.base44.com/hu/developers/backend/resources/actors/create-actor.md).

**Incoming** `generic`

A csatlakozott kliensektől érkező üzenetek típusát adja meg. A
`handleMessage()` `msg` paraméterére vonatkozik.

**Outgoing** `generic`

A csatlakozott klienseknek küldött üzenetek típusát adja meg. A
`conn.send()` és a `broadcast()` metódusra vonatkozik.

## Futásidejű API

Az actorok a `base44:runtime/actors` modulból importálják az `Actor` osztályt:

```typescript theme={null}
import { Actor, ActorError } from "base44:runtime/actors";
```

Az [`ActorError`](#callable-methods) segítségével utasíthatja el egy hívható metódus hívását.

### Titkos adatok olvasása

A `secrets.get()` metódussal olvashatja ki az alkalmazás környezeti változóit egy kezelőből. A metódus karakterláncként adja vissza az értéket, vagy `undefined` értéket, ha a titkos adat nincs beállítva.

Importálja a `secrets` objektumot a `base44:runtime` modulból:

```typescript theme={null}
import { secrets } from "base44:runtime";
```

A titkos adatokat a CLI-ből a [`secrets set`](https://docs.base44.com/developers/references/cli/commands/secrets-set) paranccsal konfigurálhatja.

Javasoljuk, hogy a titkos adatot igénylő munkához hívjon meg egy [backend-függvényt](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md). A függvény kiolvassa a titkos adatot és visszaadja az eredményt, így az actor soha nem kapja meg a titkos adatot. Mintafolyamatot a [backend-függvény hívása titkos adatot igénylő munkához](https://docs.base44.com/hu/developers/backend/resources/actors/sample-flows.md#call-a-backend-function-for-secret-work) részben talál.

## Életciklus-kezelők

A Base44 ezeket a kezelőket a munkamenet kliensoldali tevékenységére reagálva hívja meg.
Mindegyik törzsét Ön valósítja meg.
További információ arról, [hogyan működnek együtt az actorok és a kliensek](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md#how-actors-and-clients-interact).
Mintafolyamatot a [kliensek kapcsolatainak kezelése](https://docs.base44.com/hu/developers/backend/resources/actors/sample-flows.md#manage-client-connections) részben talál.

**handleStart** `method`

Minden alkalommal fut, amikor egy munkamenet aktiválódik, például:

* Amikor a munkamenet először létrejön.
* Amikor egy kliens tétlen munkamenethez csatlakozik.
* Amikor üzenet érkezik egy tétlen munkamenetre.
* Amikor elérkezik egy ütemezett időpont.

`void` vagy `Promise<void>` értéket ad vissza.

**handleConnect** `method` *required*

Akkor fut, amikor egy kliens csatlakozik a munkamenethez.
A `conn.send()` metódussal elküldheti az aktuális munkamenet-állapotot, vagy a `conn.reject()` metódussal elutasíthatja a kapcsolatot.
`void` vagy `Promise<void>` értéket ad vissza.

**Paraméterek**

**conn** `Conn` *required*

A csatlakozott klienst képviseli.

**handleMessage** `method` *required*

Akkor fut, amikor egy csatlakozott kliens üzenetet küld.
A munkamenet-állapot módosítása vagy az alkalmazásadatok elérése előtt validálhatja az üzenetet.
`void` vagy `Promise<void>` értéket ad vissza.

**Paraméterek**

**conn** `Conn` *required*

Az üzenetet küldő klienst képviseli.

**msg** `Incoming` *required*

A klienstől érkezett üzenetet tartalmazza. Az üzenet típusát az `Incoming`
generikus paraméter határozza meg.

**handleClose** `method` *required*

Akkor fut, amikor egy kliens bontja a kapcsolatot.
Ezzel a kezelővel távolíthatja el a kapcsolatazonosítóhoz tartozó munkamenet-állapotot.
Az ugyanazt az azonosítót használó újracsatlakozás a `handleClose()` futtatása nélkül cseréli le a régi socketet.
`void` vagy `Promise<void>` értéket ad vissza.

**Paraméterek**

**conn** `Conn` *required*

A kapcsolatot bontó klienst képviseli.

## Időzítőkezelők és -beállítások

Ezek a kezelők és beállítások szabályozzák a munkamenet időzített munkáját.
A Base44 akkor hívja meg őket, amikor elérkezik egy ütemezett időpont, nem a kliensoldali tevékenységre reagálva.
További információ az [ütemezett munkáról](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md#scheduled-work).
Mintafolyamatokat a [tickek futtatása](https://docs.base44.com/hu/developers/backend/resources/actors/sample-flows.md#run-ticks) és az [ébresztések ütemezése](https://docs.base44.com/hu/developers/backend/resources/actors/sample-flows.md#schedule-wakes) részben talál.

**handleTick** `method` *required*

Időközönként egyszer fut, amíg a `shouldTick()` `true` értéket ad vissza, és a munkamenetnek legalább egy kliense van.
`void` vagy `Promise<void>` értéket ad vissza.

**tickIntervalMs** `number`

A tickek közötti időközt adja meg ezredmásodpercben. Alapértelmezett érték: `100`.

**shouldTick** `method`

`boolean` értéket ad vissza. A `true` érték fenntartja a munkamenet tickelését, a `false` leállítja. Ez a metódus szinkron.

Tartsa ezt a metódust gyorsnak és mellékhatásmentesnek. A Base44 minden csatlakozás, üzenet, kapcsolatbontás és tick után meghívja.

**handleWake** `method`

Egyszer fut, amikor elérkezik a `schedule()` metódussal beállított időpont.
`void` vagy `Promise<void>` értéket ad vissza.

**Paraméterek**

**key** `string` *required*

A `schedule()` metódusnak átadott kulcsot tartalmazza.

**schedule** `method`

A `handleWake()` egyszeri futását ütemezi egy megadott időpontra.
Olyan `Promise` értéket ad vissza, amely azután teljesül, hogy a Base44 eltárolta az ütemezést.
Az ütemezés túléli a tétlen időszakot, és elindíthat egy tétlen munkamenetet.
Ha ugyanazzal a kulccsal újra meghívja a metódust, az lecseréli az ütemezett időpontot.

**Paraméterek**

**key** `string` *required*

Az ütemezett ébresztést azonosítja. Az ébresztés bekövetkezésekor a `handleWake()` megkapja.

**at** `number | Date` *required*

Megadja, mikor fusson a `handleWake()`. Használjon `Date` objektumot vagy az
1970\. január 1. óta eltelt ezredmásodpercek számát.

**cancelSchedule** `method`

Törli egy kulcshoz tartozó ütemezett ébresztést.
Olyan `Promise` értéket ad vissza, amely azután teljesül, hogy a Base44 törölte az ütemezést.

**Paraméterek**

**key** `string` *required*

A `schedule()` metódusnak átadott kulcsot adja meg.

## Kapcsolatok

Ezek a tulajdonságok és metódusok a klienssel kapcsolatos életciklus-kezelőknek átadott `conn` objektumon érhetők el.
Ezekkel olvashatja ki a kliens azonosságát, küldhet üzeneteket és kezelheti a kapcsolatot.
Az üzenetküldés áttekintéséről lásd: [valós idejű üzenetek](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md#realtime-messages).
Mintafolyamatot a [kliensek kapcsolatainak kezelése](https://docs.base44.com/hu/developers/backend/resources/actors/sample-flows.md#manage-client-connections) részben talál.

> [!NOTE]
>
> A `conn` a WebSocket backendoldali vége, a kliensben lévő `Connection` pedig ugyanannak a socketnek a másik vége. Az actorosztályban a `conn` objektumot használja. A kliensobjektumról az `actors` SDK-referenciában olvashat.

**conn.id** `string`

Ezt a kapcsolatot azonosítja. Megegyezik a kliens által csatlakozáskor átadott
azonosítóval, vagy az SDK által generált azonosítóval.

**conn.identity** `object`

Az ezen a kapcsolaton lévő klienst azonosítja. Minden
kapcsolaton jelen van.

**Tulajdonságok**

**type** `string` *required*

Értéke `authenticated` vagy `anonymous`.

**userId** `string`

A bejelentkezett klienst azonosítja. Akkor van jelen, ha a `type` értéke
`authenticated`.

**anonymousId** `string`

A névtelen klienst azonosítja. Akkor van jelen, ha a `type` értéke `anonymous`.

**conn.send** `method`

Üzenetet küld erre a kapcsolatra. `void` értéket ad vissza.

**Paraméterek**

**data** `Outgoing` *required*

Az erre a kapcsolatra küldendő üzenetet tartalmazza. Az üzenet típusát az `Outgoing` generikus paraméter határozza meg.

**conn.reject** `method`

Elutasít egy kapcsolatot a `handleConnect()` kezelőből. `void` értéket ad vissza.

**Paraméterek**

**code** `number` *required*

A kliensnek küldött állapotkódot adja meg.

**reason** `string` *required*

Leírja, miért utasította el az actor a kapcsolatot.

**broadcast** `method`

Üzenetet küld a munkamenet minden élő kapcsolatára. `void` értéket ad vissza.

**Paraméterek**

**data** `Outgoing` *required*

A munkamenet minden kapcsolatára küldendő üzenetet tartalmazza. Az üzenet típusát az `Outgoing` generikus paraméter határozza meg.

**getConnections** `method`

A munkamenet élő `conn` objektumainak tömbjét adja vissza. Ezt a metódust a
`handleStart()` kezelőben használja, hogy a visszaállított adatokat összepárosítsa
a tétlen időszak alatt is csatlakozva maradt kliensekkel.

**this.instanceId** `string`

Munkamenetszintű tulajdonság. Azt a munkamenet-azonosítót tartalmazza, amellyel
a kliens elérte ezt a munkamenetet.

## Hívható metódusok

Az alkalmazás kódja csatlakozás nélkül is futtathat metódust egy munkameneten. Egy oldal a `base44.actors.ActorName(sessionId).methodName(args)` hívást használja, a szerverkód, például egy backend-függvény pedig a `base44.asServiceRole.actors.ActorName(sessionId).methodName(args)` hívást. Metódust egyirányú hívásra használjon egy munkamenetbe: amikor szerverkód frissítést küld a munkamenet klienseinek, vagy amikor egy oldal élő megjelenítés nélkül végez műveletet egy munkameneten, például egy adminisztrátor kiürít egy táblát. Csak akkor csatlakozzon, ha az oldal élőben mutatja a munkamenetet.

A metódusok hívásához `@base44/sdk` 0.8.62 vagy újabb verzió szükséges. A hívható metódusok megjelenése előtt telepített actor minden hívást elutasít, amíg [újra nem telepíti](https://docs.base44.com/developers/references/cli/commands/actors-deploy.md). Mintafolyamatot a [munkamenet metódusának hívása](https://docs.base44.com/hu/developers/backend/resources/actors/sample-flows.md#call-a-sessions-method) részben talál.

> [!WARNING]
>
> Bármely kliens meghívhat egy metódust bármely munkameneten, amelyet meg tud nevezni. A munkamenet módosítása előtt minden metódusban ellenőrizze az `identity` értékét, ahogy a `handleConnect()` kezelőben a `conn.identity` értékét is ellenőrzi.

**static callable** `string[]`

Felsorolja a hívók által futtatható metódusokat. Bármely más metódus hívása
`404` hibával hiúsul meg. Kezelők és segédfüggvények így soha nem futnak, még akkor sem, ha
szerepelnek a listán: a `handle`, `on` vagy `_` kezdetű neveket a rendszer figyelmen kívül hagyja.

**methodName** `method`

Egy `static callable` tömbben felsorolt metódus. Akkor fut, amikor az alkalmazás kódja meghívja,
akkor is, ha egyetlen kliens sincs csatlakozva: egy tétlen munkamenet előbb aktiválódik, és lefuttatja a
`handleStart()` kezelőt. A metódus olvashatja és módosíthatja a munkamenet-állapotot, használhatja a tárolót,
és meghívhatja a `broadcast()` metódust. A hívónak szóló választ adja vissza, amelynek
JSON-szerializálhatónak kell lennie. Az SDK-hívás erre az értékre teljesül.

**Paraméterek**

**args** `any`

A hívó által átadott argumentumokat tartalmazza, legfeljebb 64 KB méretben. Validálja őket úgy,
ahogy egy kliensüzenetet validálna.

**context.identity** `object` *required*

A hívót azonosítja. A `type` értéke `service` a szolgáltatásszerepkörrel hívó
szerverkód esetén, `authenticated` és `userId` egy bejelentkezett
felhasználó esetén, vagy `anonymous` és `anonymousId`.

**context.request** `Request` *required*

A hívó hitelesítő adatait hordozza. Adja át a
[`createClientFromRequest()`](https://docs.base44.com/developers/references/sdk/docs/functions/createClientFromRequest)
függvénynek, hogy a hívó nevében, annak hozzáférési szabályaival járjon el, ahogy egy backend-függvényben.
Szerverkód esetén a kliens szolgáltatásszerepkörrel jár el. Ne
tárolja a kérést vagy a hitelesítő adatait: egy felhasználó hitelesítő adatai öt perc után
lejárnak.

**ActorError** `class`

Dobjon `new ActorError(status, message)` hibát egy hívható metódusból a hívás
elutasításához. A hívó SDK-hívása ezzel az állapotkóddal utasítódik el. Használjon `4xx`
állapotkódot, például `401` vagy `403` értéket. A metódusból dobott bármely más hiba
`500` hibaként jut el a hívóhoz.

## Tároló

A `this.storage` segítségével olvashatja és írhatja a munkamenet adatait. Az osztálymezőkkel ellentétben a tároló túléli a tétlen időszakokat. A tároló és az osztálymezők közötti választásról lásd: [tároló](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md#storage). Mintafolyamatot a [munkamenetadatok megőrzése](https://docs.base44.com/hu/developers/backend/resources/actors/sample-flows.md#persist-session-data) részben talál.

**this.storage.get** `method`

Kulcs alapján lekér egy értéket. Olyan `Promise` értéket ad vissza, amely a tárolt
értékre teljesül, vagy `undefined` értékre, ha a kulcs nem létezik.

**Paraméterek**

**key** `string` *required*

A lekérendő kulcsot adja meg.

**this.storage.put** `method`

Kulcs alapján ment egy értéket. Lecseréli a kulcs alatt már tárolt értéket. Olyan
`Promise` értéket ad vissza, amely az írás befejezésekor teljesül.

**Paraméterek**

**key** `string` *required*

A mentendő kulcsot adja meg.

**value** `unknown` *required*

A mentendő, JSON-kompatibilis értéket adja meg.

**this.storage.delete** `method`

Kulcs alapján eltávolít egy értéket. Olyan `Promise` értéket ad vissza, amely `true` értékre teljesül, ha a
kulcs létezett, egyébként `false` értékre.

**Paraméterek**

**key** `string` *required*

Az eltávolítandó kulcsot adja meg.

**this.storage.deleteAll** `method`

Eltávolítja a munkamenet összes mentett adatát. Olyan `Promise` értéket ad vissza, amely akkor teljesül, amikor
a tároló kiürült. Egy későbbi kapcsolat ugyanolyan üres tárolóval indul, mint egy
új munkamenet.

## Entitáshozzáférés

A `this.client` és a `this.client.asServiceRole` segítségével olvashatja és írhatja az alkalmazás entitásait egy actorkezelőből. Mintafolyamatot az [entitásadatok írása munkamenetből](https://docs.base44.com/hu/developers/backend/resources/actors/sample-flows.md#write-entity-data-from-a-session) részben talál.

**this.client** `Base44Client`

Erre a munkamenetre korlátozott alkalmazáskliens. Ez a kliens névtelen
hitelesítést használ, így az entitáshozzáférés ugyanazokat a szabályokat követi, mint egy kijelentkezett
kliensé, és éles adatokat olvas.

**this.client.asServiceRole** `Base44Client`

Emelt szintű hozzáférést biztosít, amely megkerüli a sorszintű biztonságot. Az üzeneteket validálja,
mielőtt ezt a klienst használná. Az írásokat tegye biztonságosan megismételhetővé, mert hiba után a munkamenet
újra lefuttathat egy kezelőt.

## Lásd még

* [Az actorok áttekintése](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md): Fogalmak és terminológia
* [Actorok: mintafolyamatok](https://docs.base44.com/hu/developers/backend/resources/actors/sample-flows.md): Életciklus, időzítők, kapcsolatok, hívható metódusok, tároló, entitások és backend-függvények
* [`actors` SDK-referencia](https://docs.base44.com/developers/references/sdk/docs/type-aliases/actors): Kliens-SDK API
* [`secrets set`](https://docs.base44.com/developers/references/cli/commands/secrets-set): Környezeti változók konfigurálása a CLI-ből

> [!NOTE]
>
> 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](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.