Coroutine协程模も块.md

Coroutine协程管理かんり

• （题外话） 尽つき管かん网上很多大だい佬并不ふ推荐在ざいUnity中ちゅう使用しよう协程，但ただし是ぜ不可ふか否いや认的是ぜ在ざいU3D中ちゅう使用しよう协程来らい做异步ふ处理可か以让代だい码变得どく非常ひじょう简洁好こう看み。特とく别是在ざい和わU3D的てき资源加か载一起配合使用的时候真的很方便。所以ゆえん我わが还是非常ひじょう推崇在ざいU3D中ちゅう使用しよう协程来らい做异步ふ处理的てき。
• 目前もくぜん项目中ちゅう的てき异步操作そうさ已やめ经全部ぶ替がえ换为async await模も式しき了りょう，支持しじUnity Coroutine和わasync await相互そうご混用こんよう，自由じゆう转变。

协程模も块支持しじ的てき功こう能のう

• 协程使用しよう统一管理かんり，让携程ほど的てき启动不ふ再さい依よ赖MonoBehaviour。
• 实现类似 WWW/AssetBundleRequest等とう带自定てい义参数すう返かえし回かい的てき协程对象，以简化か使用しよう协程的てき代だい码结构。
• 支持しじ在ざい热更新しん端はし使用しよう协程。

模かたぎ块提供ていきょう的てきAPI

• 
• 框かまち架か中ちゅう提供ていきょう的てき协程管理かんり，可か以在任意にんい位置いち启动一いち个协程ほど操作そうさ，不ふ受MonoBehaviour的てき约束。

CoroutineManager.cs
public CoroutineHandler StartHandler(IEnumerator rIEnum)	// 开始一いち个可控ひかえ制せい(停とま掉)的てき协程
public Coroutine Start(IEnumerator rIEnum)					// 开始一いち个普通どおり协程
public void Stop(CoroutineHandler rCoroutineHandler)		// 停止ていし一いち个协程ほど

• 自じ定てい义参数すう返かえし回かい的てき携程对象

public class LoaderRequest : CoroutineRequest<LoaderRequest>
{
    public Object obj;
    public string path;

    public LoaderRequest(string rPath)
    {
        this.path = rPath;
    }
}

public class CoroutineLoadTest
{
    public LoaderRequest mRequest;

    private LoaderRequest Load_Async(string rPath)
    {
        LoaderRequest rRequest = new LoaderRequest(rPath);
        mRequest = rRequest;
        rRequest.Start(Load(rRequest));
        return rRequest;
    }

    private IEnumerator Load(LoaderRequest rRequest)
    {
        yield return new WaitForSeconds(1.0f);
        rRequest.obj = new GameObject(rRequest.path);
        Debug.LogFormat("Create GameObject: {0}", rRequest.path);
    }

    public IEnumerator Loading(string rPath)
    {
        yield return Load_Async(rPath);
    }
}

public class CoroutineTest : MonoBehaviour
{
    IEnumerator Start()
    {
        CoroutineManager.Instance.Initialize();
        yield return CoroutineManager.Instance.Start(Start_Async());
    }

    IEnumerator Start_Async()
    {
        CoroutineLoadTest rTest = new CoroutineLoadTest();
        yield return CoroutineManager.Instance.Start(rTest.Loading("Test1"));
        yield return CoroutineManager.Instance.Start(rTest.Loading("Test2"));
        Debug.Log("Done.");
    }
}

• async await异步模も式しき

public class Init : MonoBehaviour
{
    public string HotfixABPath = "";
    public string HotfixModule = "";
    
    async void Start()
    {
        CoroutineManager.Instance.Initialize();
	wait Start_Async();
    }

    private async Task Start_Async()
    {
        await ABPlatform.Instance.Initialize();
        await ABUpdater.Instance.Initialize();

        await HotfixManager.Instance.Load(this.HotfixABPath, this.HotfixModule);

        await HotfixGameMainLogic.Instance.Initialize();

        Debug.Log("End init..");
    }
}

// 直接ちょくせつawait Assetbundle.LoadFromFileAsync API
rAssetLoadEntry.CacheAsset = await AssetBundle.LoadFromFileAsync(rAssetLoadUrl);

// 直接ちょくせつawait Assetbundle.LoadAssetAsync API
rRequest.Asset = await rAssetLoadEntry.CacheAsset.LoadAssetAsync(rRequest.AssetName);

需要じゅよう注意ちゅうい的てき问题

• ILRuntime库目前ぜん不ふ支持しじ在ざいforeach中ちゅう使用しようyield return xxx;操作そうさ。

// 错误的てき用法ようほう
foreach (var rPair in rGameStageList)
{
	yield return rPair.Value.Run_Async();
}

// 正せい确的用法ようほう：目前もくぜん只ただ能のう转成for循环来らい执行协程
var rGameStageList = new List<KeyValuePair<int, GameStage>>(this.gameStages);
for (int i = 0; i < rGameStageList.Count; i++)
{
    yield return rGameStageList[i].Value.Run_Async();
}

• 目前もくぜん在ざい热更新しん端はし还不支持しじ直接ちょくせつ继承CoroutineRequest类，模も板ばん类的继承在ざいILRuntime中ちゅう支持しじ得とく不ふ是ぜ很好。在ざい热更新しん端はし可か以直接ちょくせつ创建一个类来缓存CoroutineHandler对象来らい模も拟实现带参さん数すう的てき协程对象。具体ぐたい用法ようほう参さん见热更新こうしんDLL中ちゅう的てきActorCreater.cs文ぶん件けん。