spacetimedb-client-c-sharp

C# および Unity クライアントの実装にこのスキルを使用します。

C# の基本パターン

C# バインディングを生成し、ユーザーのプロジェクトで生成された DbConnection、RemoteTables、RemoteReducers の名前を使用します。

spacetime generate --lang csharp --out-dir client/module_bindings --module-path spacetimedb

var conn = DbConnection.Builder()
    .WithUri(new Uri("ws://localhost:3000"))
    .WithDatabaseName("my-database")
    .OnConnect((conn, identity, token) =>
    {
        conn.SubscriptionBuilder().SubscribeToAllTables();
    })
    .OnConnectError((ctx, err) => Log.Error(err.ToString()))
    .OnDisconnect((ctx, err) => Log.Info("Disconnected"))
    .Build();

実行時のルール

• メインループまたは Unity の更新処理から conn.FrameTick() を呼び出します。そうしないと、コールバックとキャッシュの更新が適用されません。
• メインスレッドのコードが conn.Db を読み取っている間、バックグラウンドスレッドで FrameTick() を実行しないでください。
• conn.Db.<Table>.Iter()、Count、および生成されたユニークハンドル／インデックスハンドルを通じて、購読中の行を読み取ります。
• OnInsert、OnDelete、OnUpdate でテーブルイベントを登録します。OnUpdate には主キーが必要です。
• conn.Reducers.<ReducerName>(...) でリデューサーを呼び出し、必要に応じて生成されたリデューサーイベントを登録します。
• Unity のライフサイクルコードは MonoBehaviour またはサービスクラスに記述し、生成されたバインディングは編集しないでください。

リファレンスマップ

必要なもの	開く
C# SDK API	references/clients-c-sharp.md

ガイダンス

• 利用できる場合は、ユーザーのプロジェクトで生成された C# バインディング名を使用します。
• プロジェクトですでに統合されている場合を除き、Unity のライフサイクルコードは生成されたバインディングコードと分離します。
• Unity のチュートリアル全般に関する作業は spacetimedb-tutorials に振り分けます。