
Croupier SDK for .NET 8+
官方 C# SDK,用于连接 Croupier 游戏后端平台
📡 gRPC 通信
基于 Grpc.Net.Client 的高效双向通信,支持流式调用和双向通信。
🏢 多租户支持
内置 game_id/env 隔离机制,支持多游戏、多环境部署。
📝 函数注册
简洁的描述符和处理器注册 API,支持异步/同步函数。
🔄 异步/同步
完整支持 async/await 模式,同时也支持同步处理器。
🛠️ 依赖注入
集成 Microsoft.Extensions.DependencyInjection,便于集成到现有项目。
📊 日志抽象
支持 ILogger 和自定义日志实现,灵活的日志记录。
⚙️ 灵活配置
环境变量、JSON 文件、内存配置等多种配置方式。
🎮 Unity 支持
支持 Unity 2021.3+,可直接在游戏客户端中使用。
安装
dotnet add package Croupier.Sdk
快速示例
using Croupier.Sdk;
using Croupier.Sdk.Models;
// 创建客户端
var client = new CroupierClient(new ClientConfig {
AgentAddr = "127.0.0.1:19090",
ServiceId = "my-service",
GameId = "my-game"
});
// 注册函数
client.RegisterFunction(new FunctionDescriptor {
Id = "player.get",
Version = "1.0.0",
Category = "player",
Risk = "low"
}, async (context, payload) => {
// 处理调用
return "{\"status\":\"ok\"}";
});
// 连接并启动服务
await client.ConnectAsync();
await client.ServeAsync();