mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 17:21:16 +08:00
1c41c57d72
- 实现CoroutineMetadata类存储协程元数据信息 - 创建CoroutineScheduler协程调度器管理协程生命周期 - 添加CoroutineSlot类管理单个协程执行状态 - 实现GodotTimeSource时间源支持缩放和真实时间 - 添加Timing类提供Godot协程管理功能 - 实现CoroutineNodeExtensions扩展方法支持节点生命周期管理 - 支持协程分组、标签、优先级等功能 - 提供协程暂停、恢复、终止等控制接口 - 实现协程统计和快照功能 - 添加等待指令处理机制支持多种等待类型
109 lines
4.5 KiB
C#
109 lines
4.5 KiB
C#
// Copyright (c) 2026 GeWuYou
|
||
// Licensed under the Apache License, Version 2.0 (the "License");
|
||
// you may not use this file except in compliance with the License.
|
||
// You may obtain a copy of the License at
|
||
//
|
||
// http://www.apache.org/licenses/LICENSE-2.0
|
||
//
|
||
// Unless required by applicable law or agreed to in writing, software
|
||
// distributed under the License is distributed on an "AS IS" BASIS,
|
||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
// See the License for the specific language governing permissions and
|
||
// limitations under the License.
|
||
|
||
using GFramework.Core.Abstractions.Coroutine;
|
||
using GFramework.Core.Coroutine;
|
||
using Godot;
|
||
|
||
namespace GFramework.Godot.Coroutine;
|
||
|
||
/// <summary>
|
||
/// 提供协程相关的扩展方法，用于在Godot环境中管理协程的生命周期。
|
||
/// </summary>
|
||
public static class CoroutineNodeExtensions
|
||
{
|
||
/// <summary>
|
||
/// 启动协程的扩展方法。
|
||
/// </summary>
|
||
/// <param name="coroutine">要启动的协程枚举器。</param>
|
||
/// <param name="segment">协程运行的时间段，默认为 Process。</param>
|
||
/// <param name="tag">协程的标签，可用于标识或分组协程。</param>
|
||
/// <returns>返回协程的句柄，可用于后续操作（如停止协程）。</returns>
|
||
public static CoroutineHandle RunCoroutine(this IEnumerator<IYieldInstruction> coroutine,
|
||
Segment segment = Segment.Process, string? tag = null)
|
||
{
|
||
return Timing.RunCoroutine(coroutine, segment, tag);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 以指定节点作为生命周期所有者运行协程。
|
||
/// </summary>
|
||
/// <param name="owner">拥有该协程生命周期的节点。</param>
|
||
/// <param name="coroutine">要启动的协程枚举器。</param>
|
||
/// <param name="segment">协程运行的时间段。</param>
|
||
/// <param name="tag">协程标签。</param>
|
||
/// <param name="cancellationToken">可选取消令牌。</param>
|
||
/// <returns>返回协程句柄。</returns>
|
||
public static CoroutineHandle RunCoroutine(
|
||
this Node owner,
|
||
IEnumerator<IYieldInstruction> coroutine,
|
||
Segment segment = Segment.Process,
|
||
string? tag = null,
|
||
CancellationToken cancellationToken = default)
|
||
{
|
||
return Timing.RunOwnedCoroutine(owner, coroutine, segment, tag, cancellationToken);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 让协程在指定节点被销毁时自动取消。
|
||
/// </summary>
|
||
/// <param name="coroutine">要包装的协程枚举器。</param>
|
||
/// <param name="node">用于检查是否存活的节点。</param>
|
||
/// <returns>包装后的协程枚举器。</returns>
|
||
public static IEnumerator<IYieldInstruction> CancelWith(this IEnumerator<IYieldInstruction> coroutine,
|
||
Node node)
|
||
{
|
||
while (Timing.IsNodeAlive(node) && coroutine.MoveNext())
|
||
yield return coroutine.Current;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 让协程在任一节点被销毁时自动取消。
|
||
/// </summary>
|
||
/// <param name="coroutine">要包装的协程枚举器。</param>
|
||
/// <param name="node1">第一个用于检查是否存活的节点。</param>
|
||
/// <param name="node2">第二个用于检查是否存活的节点。</param>
|
||
/// <returns>包装后的协程枚举器。</returns>
|
||
public static IEnumerator<IYieldInstruction> CancelWith(this IEnumerator<IYieldInstruction> coroutine,
|
||
Node node1, Node node2)
|
||
{
|
||
while (Timing.IsNodeAlive(node1) &&
|
||
Timing.IsNodeAlive(node2) &&
|
||
coroutine.MoveNext())
|
||
yield return coroutine.Current;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 让协程在多个节点都被销毁时自动取消。
|
||
/// </summary>
|
||
/// <param name="coroutine">要包装的协程枚举器。</param>
|
||
/// <param name="nodes">用于检查是否存活的节点数组。</param>
|
||
/// <returns>包装后的协程枚举器。</returns>
|
||
public static IEnumerator<IYieldInstruction> CancelWith(this IEnumerator<IYieldInstruction> coroutine,
|
||
params Node[] nodes)
|
||
{
|
||
// 持续执行协程直到任一节点被销毁或协程执行完毕
|
||
while (nodes.AllNodesAlive() && coroutine.MoveNext())
|
||
yield return coroutine.Current;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 检查所有节点是否都处于存活状态。
|
||
/// </summary>
|
||
/// <param name="nodes">要检查的节点数组。</param>
|
||
/// <returns>如果所有节点都存活则返回 true，否则返回 false。</returns>
|
||
private static bool AllNodesAlive(this Node[] nodes)
|
||
{
|
||
return nodes.All(Timing.IsNodeAlive);
|
||
}
|
||
} |