docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Struct AsyncOperationHandle

    Non typed operation handle. This allows for reference counting and checking for valid references.

    Implements
    IEnumerator
    Inherited Members
    ValueType.Equals(object)
    ValueType.ToString()
    object.Equals(object, object)
    object.ReferenceEquals(object, object)
    object.GetType()
    Namespace: UnityEngine.ResourceManagement.AsyncOperations
    Assembly: solution.dll
    Syntax
    public struct AsyncOperationHandle : IEnumerator

    Properties

    Name Description
    DebugName

    Debug name of the operation.

    IsDone

    True if the operation is complete.

    IsWaitingForCompletion

    Indicates that the async operation is in the process of being completed synchronously.

    OperationException

    The exception for a failed operation. This will be null unless Status is failed.

    PercentComplete

    The progress of the internal operation. This is evenly weighted between all sub-operations. For example, a LoadAssetAsync call could potentially be chained with InitializeAsync and have multiple dependent operations that download and load content. In that scenario, PercentComplete would reflect how far the overal operation was, and would not accurately represent just percent downloaded or percent loaded into memory. For accurate download percentages, use GetDownloadStatus().

    Result

    The result object of the operations.

    Status

    The status of the internal operation.

    Task

    Return a Task object to wait on when using async await.

    Methods

    Name Description
    Convert<T>()

    Converts handle to be typed. This does not increment the reference count. To convert back to non-typed, implicit conversion is available.

    Equals(AsyncOperationHandle)

    Provide equality for this struct.

    GetDependencies(List<AsyncOperationHandle>)

    Get dependency operations.

    GetDownloadStatus()

    Return the current download status for this operation and its dependencies. In some instances, the information will not be available. This can happen if the operation is dependent on the initialization operation for addressables. Once the initialization operation completes, the information returned will be accurate.

    GetHashCode()

    Get hash code of this struct.

    IsValid()

    Check if the internal operation is not null and has the same version of this handle.

    WaitForCompletion()

    Synchronously complete the async operation.

    Events

    Name Description
    Completed

    Completion event for the internal operation. If this is assigned on a completed operation, the callback is deferred until the LateUpdate of the current frame.

    Destroyed

    Event for handling the destruction of the operation.


    Did you find this page useful? Please give it a rating:

    Thanks for rating this page!

    Report a problem on this page

    What kind of problem would you like to report?

    • This page needs code samples
    • Code samples do not work
    • Information is missing
    • Information is incorrect
    • Information is unclear or confusing
    • There is a spelling/grammar error on this page
    • Something else

    Thanks for letting us know! This page has been marked for review based on your feedback.

    If you have time, you can provide more information to help us fix the problem faster.

    Provide more information

    You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:

    You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:

    You've told us there is information missing from this page. Please tell us more about what's missing:

    You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:

    You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:

    You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:

    You've told us this page has a problem. Please tell us more about what's wrong:

    Thank you for helping to make the Unity documentation better!

    Your feedback has been submitted as a ticket for our documentation team to review.

    We are not able to reply to every ticket submitted.

    In This Article
    • Properties
    • Methods
    • Events
    Back to top
    Copyright © 2024 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)