LogicLooper 开源项目教程

LogicLooper 开源项目教程

LogicLooper A library for building server application using loop-action programming model on .NET. 项目地址: https://gitcode.com/gh_mirrors/lo/LogicLooper

1. 项目介绍

LogicLooper 是一个基于 .NET 的库，旨在使用循环动作编程模型构建服务器应用程序。该库特别专注于构建游戏服务器，提供了一种比简单任务驱动更高效的方式来聚合和处理游戏循环。

主要特点

• 循环动作编程模型：通过循环动作模型，开发者可以更高效地处理服务器逻辑。
• 多线程支持：支持多线程环境下的高效运行，特别适用于多核服务器。
• 集成支持：可以与 Microsoft.Extensions.Hosting 集成，方便在现有项目中使用。

2. 项目快速启动

安装

首先，通过 NuGet 安装 LogicLooper 包：

dotnet add package LogicLooper

使用示例

以下是一个简单的单循环应用程序示例：

using Cysharp.Threading;

// 创建一个 looper
const int targetFps = 60;
using var looper = new LogicLooper(targetFps);

// 注册一个动作到 looper 并等待完成
await looper.RegisterActionAsync((in LogicLooperActionContext ctx) =>
{
    // 如果想要停止/完成循环，返回 false
    if (/* 停止条件 */)
    {
        return false;
    }

    // 执行一些操作
    // network.Receive();
    // world.Update();
    // players.Update();
    // network.Send();

    return true; // 等待下一次更新
});

3. 应用案例和最佳实践

多循环应用程序

在多核服务器上，使用 LooperPool 可以更高效地运行多个循环。以下是一个示例：

using Cysharp.Threading;

// 创建一个 looper pool
// 如果你的机器有 4 个核心，LooperPool 会创建 4 个 Looper 实例
const int targetFps = 60;
var looperCount = Environment.ProcessorCount;
using var looperPool = new LogicLooperPool(targetFps, looperCount, RoundRobinLogicLooperPoolBalancer.Instance);

// 注册一个动作到 looper 并等待完成
await looperPool.RegisterActionAsync((in LogicLooperActionContext ctx) =>
{
    // 如果想要停止/完成循环，返回 false
    if (/* 停止条件 */)
    {
        return false;
    }

    // 执行一些操作
    // network.Receive();
    // world.Update();
    // players.Update();
    // network.Send();

    return true; // 等待下一次更新
});

集成 Microsoft.Extensions.Hosting

LogicLooper 可以与 Microsoft.Extensions.Hosting 集成，方便在现有项目中使用。参考 samples/LoopHostingApp 示例。

4. 典型生态项目

相关项目

• Cysharp.Threading：提供了多线程和异步编程的支持，与 LogicLooper 配合使用可以进一步提升性能。
• Microsoft.Extensions.Hosting：提供了托管服务的框架，LogicLooper 可以作为托管服务的一部分运行。

社区资源

• GitHub 仓库：Cysharp/LogicLooper
• NuGet 包：LogicLooper

通过以上内容，您可以快速上手并深入了解 LogicLooper 的使用和最佳实践。

LogicLooper A library for building server application using loop-action programming model on .NET. 项目地址: https://gitcode.com/gh_mirrors/lo/LogicLooper