# Unity-Coroutine-Toolkit

**Repository Path**: River314588804/unity-coroutine-toolkit

## Basic Information

- **Project Name**: Unity-Coroutine-Toolkit
- **Description**: 以 Unity Coroutine 为基础的二次封装工具。其目的是整合定时（次）、延时、循环等常用方法。
- **Primary Language**: C#
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-03-20
- **Last Updated**: 2026-07-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Unity, 协程, 工具

## README

# Unity Coroutine Toolkit | 协程扩展工具包
___
[![](https://img.shields.io/badge/不定期-更新中-green)]() [![](https://img.shields.io/badge/支持-Unity6.0-green)]() [![](https://img.shields.io/badge/支持-TuanJie-green)]() [![fa](https://img.shields.io/badge/发行版-v1.0.0-red)]()

|支持平台|.NET|Unity|Visual Studio|
|--|--|--|--|
|Windows|.NET 6.0 以上|Unity 2020 以上|VS 2022|

 
#### 说明 | 项目起源

这是一个基于 Unity Coroutine（协程）的二次封装仓库。其目的是封装、管理常见应用逻辑（循环/延迟 - 按时间/按帧数/有限/无限）。
 
#### 说明 | 支持内容
1. 支持 全局静态单例访问。
2. 支持 监听 + 分层事件拓展。可追踪任务活跃状态详细。具体如下：
    - `CoroutineTask.OnStarted`：当协程启动后回调。
    - `CoroutineTask.OnStopped`：当协程停止后回调。（即 干预下终止行为）
    - `CoroutineTask.OnCompleted`：当协程完成时回调。（即 非干预下结束行为）
3. 提供 全局活跃协程任务表。
    - `CoroutineTracker.OnTaskLaunched`：任务激活
    - `CoroutineTracker.OnTaskTerminated`：任务结束。
4. 提供 可跟踪的快照信息（实验性）。

 
#### 说明 | 快速部署
- 联网环境：https://gitee.com/River314588804/unity-coroutine-toolkit.git#Unity-Package-Manager
- 离线环境：迁移项目目录下 `RStudio/unity coroutine tookit` 文件夹即可。

 
#### 说明 | 快速上手
```
using RStudio.RCoroutine;

public class ClassA : MonoBehaviour
{
    [SerializeField， Tooltip("显示文本")] TMP_Text tmp_TXT;

    public void Start()
    {
        // 引用 CorourtineLoop or CoroutineDelay 静态类构建 IEnumerator

        // 例如：建立有限循环计时器。
        var loopIE = CoroutineLoop.ILoopForTime(10f, 1f, null, OnUpdated, null);

        // 全局托管+活跃管理
        CoroutineManager.Make(loopIE, "计时器").Start();
    }

    private void OnUpdated(float timer)
    {
        this.tmp_TXT.text = timer.ToString();
    }
}
```
 
#### 说明 | 未来路线
- 增加 全局 `Mono` 以适用于非 Mono 类执行。(已完成)
- 调整 静态类 `CoroutineLoop`/`CoroutineDelay` 中方法进行封装类，遵循单一职责原则，压缩代码总行数。

 
#### 说明 | 依赖环境

- [unity-api-extension-toolkit](https://gitee.com/River314588804/unity-api-extension-toolkit.git)

 
#### 后记
附注：没有任何的技术含量。如果有用到，请随意拾取代码或片段。