Skip to main content
אתה צופה בתיעוד למפתחים
תיעוד זה מיועד למפתחים העובדים עם פלטפורמת המפתחים של Base44.
צור actor כדי להריץ לוגיקת בקאנד עבור session חי שמשותף לכמה לקוחות, כמו חדר צ’אט או משחק מרובה משתתפים. ה-actor מטפל בחיבורים, בהודעות ובניתוקים של לקוחות מצד הבקאנד.

קובצי actor

צור actors כקובצי TypeScript בתיקיית ה-actors של הפרויקט. כל actor נמצא בתת-תיקייה משלו תחת base44/actors/, עם קובץ entry.ts:
base44
actors
chatRoom
entry.ts
שם התיקייה הופך לשם ה-actor ב-SDK וקובע איך לקוחות קוראים ל-actor, למשל base44.actors.chatRoom. ייצא את מחלקת ה-actor כ-default export מקובץ entry.ts. אפשר לכלול בתיקיית ה-actor קבצים נוספים מסוג .ts, .js, .json ו-.jsonc, ולייבא אותם מ-entry.ts.

entry.ts

קובץ הקוד מכיל את מחלקת ה-actor. ייבא את Actor מ-base44:runtime/actors וייצא כ-default export מחלקה שמרחיבה את Actor. העבר את ה-generics Incoming ו-Outgoing כדי להגדיר טיפוסים להודעות שה-actor מקבל ושולח. ממש את מתודות המחלקה הבאות. המתודה handleStart() אופציונלית:
  • handleStart(): טוען נתוני session שמורים מהאחסון לשדות המחלקה. Base44 קוראת ל-handler הזה בכל פעם שה-session מופעל. כך המצב המשוחזר מוכן לפני ש-Base44 מטפלת בחיבור כלשהו. לדוגמת אחסון מלאה, ראה שמירת נתוני session.
  • handleConnect(): שולח את מצב ה-session הנוכחי ללקוח שמתחבר. לדחיית חיבורים או לזיהוי לקוחות, ראה ניהול חיבורי לקוחות.
  • handleMessage(): מעדכן את מצב ה-session, שומר את המצב ומשדר את השינוי.
  • handleClose(): מסיר כל מצב שקשור לחיבור הזה. אם אין מצב חיבור לניקוי, כתוב גוף ריק.
  • handleTick(): מריץ קוד בכל מרווח tick. אם ה-actor לא משתמש ב-ticks, כתוב גוף ריק. להגדרת ticks, ראה הרצת ticks. לתזמון השכמה חד-פעמית, ראה תזמון השכמות.
הדוגמה הבאה מציגה actor פשוט בשם ChatRoom:

ראה גם

דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.