进度

描述

Progress 实用程序类向 Unity 报告异步任务的进度。

Progress 实用程序类可以通过多种方式用于报告异步任务的进度。以下是一个在 EditorApplication.update 循环中运行并报告进度的任务示例

using System.Collections;
using UnityEditor;

class ProgressReport_EditorUpdate
{
    static IEnumerator s_CurrentEnumerator;

    [MenuItem("Examples/ProgressReport/EditorUpdate")]
    static void RunEditorUpdate()
    {
        if (s_CurrentEnumerator == null)
        {
            s_CurrentEnumerator = RunTaskWithReport();
        }
        EditorApplication.update -= RunTaskOnUpdate;
        EditorApplication.update += RunTaskOnUpdate;
    }

    static void RunTaskOnUpdate()
    {
        if (s_CurrentEnumerator == null)
        {
            return;
        }

        // Execute one step of the task
        var atEnd = !s_CurrentEnumerator.MoveNext();

        // If there is nothing more to do, remove the update callback
        if (atEnd)
        {
            s_CurrentEnumerator = null;
            EditorApplication.update -= RunTaskOnUpdate;
        }
    }

    static IEnumerator RunTaskWithReport()
    {
        // Create a new progress indicator
        int progressId = Progress.Start("Running one task");

        // Report the progress status at anytime
        for (int frame = 0; frame <= 1000; ++frame)
        {
            string description;
            if (frame < 250)
                description = "First part of the task";
            else if (frame < 750)
                description = "Second part of the task";
            else
                description = "Last part of the task";
            Progress.Report(progressId, frame / 1000.0f, description);

            // Do your computation that you want to report progress on
            // ...
            yield return null;
        }

        // The task is finished. Remove the associated progress indicator.
        Progress.Remove(progressId);
    }
}

以下是在单独线程上运行并报告进度的另一个示例

using System.Threading;
using System.Threading.Tasks;
using UnityEditor;

class ProgressReport_Threaded
{
    [MenuItem("Examples/ProgressReport/Threaded")]
    static void RunThreaded()
    {
        Task.Run(RunTaskWithReport);
    }

    static void RunTaskWithReport()
    {
        // Create a new progress indicator
        int progressId = Progress.Start("Running one task");

        // Report the progress status at anytime
        for (int frame = 0; frame <= 1000; ++frame)
        {
            string description;
            if (frame < 250)
                description = "First part of the task";
            else if (frame < 750)
                description = "Second part of the task";
            else
                description = "Last part of the task";
            Progress.Report(progressId, frame / 1000.0f, description);

            // Do your computation that you want to report progress on
            ComputeSlowStep();
        }

        // The task is finished. Remove the associated progress indicator.
        Progress.Remove(progressId);
    }

    static void ComputeSlowStep()
    {
        // Simulate a slow computation with a 1 millisecond sleep
        Thread.Sleep(1);
    }
}

静态属性

静态方法

事件