docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Method OnUpdate

    OnUpdate()

    Implement OnUpdate() to perform the major work of this system.

    Declaration
    [RequiredMember]
    protected abstract void OnUpdate()
    Remarks

    By default, the system invokes `OnUpdate()` once every frame on the main thread. To skip OnUpdate if all of the system's [EntityQueries] are empty, use the [RequireMatchingQueriesForUpdateAttribute]. To limit when OnUpdate is invoked, you can specify components that must exist, or queries that match specific Entities. To do this, call RequireForUpdate<T>() or RequireForUpdate(EntityQuery) in the system's OnCreate method. For more information, see [ShouldRunSystem].

    The [Entities.ForEach] and [Job.WithCode] constructions provide convenient mechanisms for defining jobs. You can also instantiate and schedule an IJobChunk instance; you can use the [C# Job System] or you can perform work on the main thread. If you call EntityManager methods that perform structural changes on the main thread, be sure to arrange the system order to minimize the performance impact of the resulting [sync points].

    In This Article
    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)