アクターを作成する

アクターを作成すると、複数のクライアントが共有するライブセッションのバックエンドロジックを実行できます。たとえば、チャットルームやマルチプレイヤーゲームです。アクターは、クライアントの接続、メッセージ、切断をバックエンドで処理します。

アクターファイル

アクターは、プロジェクトの actors ディレクトリに TypeScript ファイルとして作成します。各アクターは base44/actors/ 配下の専用サブディレクトリに配置され、entry.ts ファイルを持ちます。

base44

actors

chatRoom

entry.ts

フォルダー名は SDK でのアクター名になり、クライアントがアクターを呼び出す方法を決めます。例: base44.actors.chatRoom。entry.ts ファイルから、アクタークラスをデフォルトエクスポートとしてエクスポートします。アクターディレクトリには、追加の .ts、.js、.json、.jsonc ファイルを含め、entry.ts からインポートできます。

entry.ts

このコードファイルにはアクタークラスが含まれます。base44:runtime/actors から Actor をインポートし、Actor を継承したクラスをデフォルトエクスポートとしてエクスポートします。Incoming と Outgoing のジェネリクスを渡して、アクターが受信、送信するメッセージに型を付けます。次のクラスメソッドを実装します。handleStart() メソッドは省略可能です。

handleStart(): 保存されたセッションデータをストレージからクラスフィールドに読み込みます。Base44 はセッションがアクティブになるたびにこのハンドラーを呼び出します。そのため、Base44 が接続を処理する前に、復元した状態の準備が整います。ストレージの完全な例については、セッションデータを永続化するを参照してください。
handleConnect(): 接続してきたクライアントに現在のセッション状態を送信します。接続の拒否やクライアントの識別については、クライアント接続を管理するを参照してください。
handleMessage(): セッション状態を更新して永続化し、変更をブロードキャストします。
handleClose(): その接続に紐づく状態を削除します。クリアする接続状態がない場合は、空の本体を記述します。
handleTick(): tick の間隔ごとにコードを実行します。アクターが tick を使わない場合は、空の本体を記述します。tick の設定については、tick を実行するを参照してください。1 回限りの wake をスケジュールするには、wake をスケジュールするを参照してください。

次の例は、簡略化した ChatRoom アクターです。

import { Actor } from "base44:runtime/actors";

type Incoming = { type: "message"; text: string };
type Outgoing =
  | { type: "history"; messages: string[] }
  | { type: "message"; text: string };

export default class ChatRoom extends Actor<Incoming, Outgoing> {
  messages: string[] = [];

  async handleStart() {
    this.messages = (await this.storage.get<string[]>("messages")) ?? [];
  }

  async handleConnect(conn) {
    conn.send({ type: "history", messages: this.messages });
  }

  async handleMessage(_conn, msg) {
    this.messages.push(msg.text);
    await this.storage.put("messages", this.messages);
    this.broadcast({ type: "message", text: msg.text });
  }

  async handleClose(_conn) {}

  async handleTick() {}
}

概要

クイックスタート

プロジェクト

AI 開発ツール

リソース

アクターファイル

entry.ts

関連項目

​アクターファイル

​entry.ts

​関連項目

アクターファイル

entry.ts

関連項目