spacetimedb-client-rust

Rust クライアントの実装には、このスキルを使用してください。

Rust の基本パターン

Rust バインディングを生成し、生成された名前をローカルモジュールからインポートします。

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

use module_bindings::DbConnection;

let conn = DbConnection::builder()
    .with_uri("ws://localhost:3000")
    .with_database_name("my-database")
    .on_connect(|ctx, identity, _token| {
        log::info!("connected: {identity}");
        ctx.subscription_builder().subscribe_to_all_tables();
    })
    .on_connect_error(|_ctx, err| log::error!("connect error: {err}"))
    .on_disconnect(|_ctx, err| log::info!("disconnected: {err:?}"))
    .build()?;

conn.run_threaded();

実行時のルール

• run_threaded、run_async、または frame_tick を使用して接続を進めます。コールバックとキャッシュの更新には、これらのいずれかが必要です。
• サブスクライブした行は、conn.db.<table>().iter()、.count()、および生成された一意キー／インデックスハンドルを通じて読み取ります。
• 生成されたテーブルハンドルで on_insert、on_delete、on_update コールバックを登録します。on_update には主キーが必要です。
• トレイトジェネリックなコールバックコンテキストでは、conn.reducers.<reducer>(...) または ctx.reducers() を使用します。
• 生成されたバインディングのモジュール名と機能フラグを、ローカルプロジェクトに合わせます。

リファレンス一覧

必要な情報	開く
Rust SDK API	references/clients-rust.md

ガイダンス

• 生成されたモジュール名とバインディングのパスは、ローカルプロジェクトに合わせます。
• 接続のライフサイクル、サブスクリプションのコールバック、リデューサーの呼び出しは、Rust SDK のリファレンスに沿って実装します。
• Rust サーバーモジュールのスキーマやリデューサーのコードについては、このクライアントスキルではなく、テーブルおよびリデューサーのスキルを参照してください。