Release Notes Search

Added: Added EnergyUsage API to enable power monitor (CPU, GPU, TPU, display, memory) energy consumption reading.

Added: Added CompileSdkSpec Gradle DSL classes.

Added: Added support for SDK Platform 37.

Added: Added support the new CPU/GPU utilization Adaptive Performance metrics via CPU/GPU headroom methods on Android.

Added: Added the PowerMonitor energy consumption API to Adaptive Performance Android provider.

Added: Added ApplicationStartInfoProvider.GetHistoricalProcessStartReasons to retrieve ApplicationStartInfo records.

Added: Added PlayerSettings.Android.compileSdkVersion to set the compile API level independently of the target API level, including sub-integer (major.minor) precision.

Added: Added ``AndroidWindowInsets.GetBounds(Type)`` to get the screen-space rect where an overlapping inset covers the game view.

Added: Added ``AndroidWindowInsets.SetAppearance / GetAppearance`` runtime API to control system bar icon appearance (Light/Dark) per inset type.

Added: Added ``AndroidWindowInsets.SetOverlapping / GetOverlapping`` runtime API to control which insets overlap with the game view.

Added: Added ``AndroidWindowInsets.SetSystemBarsBackground / GetSystemBarsBackground`` runtime API to control system bars background transparency.

Added: Added ``AndroidWindowInsets.Show(Type type, Type overlapping)`` overload to atomically show insets and set overlapping in a single operation.

Added: Added ``PlayerSettings.Android.GetInsetsAppearance / SetInsetsAppearance`` editor API to configure per-inset appearance at build time.

Added: Added ``PlayerSettings.Android.requestedOverlappingInsets`` to configure which insets the game view can draw behind (edge-to-edge rendering) at build time.

Added: Added ``PlayerSettings.Android.systemBarsBackground`` editor property to configure system bars background (Opaque/Transparent) at build time.

Changed: Reduced public API surface of the Android Java player library (com.unity3d.player) by making internal classes and methods package-private. Affected classes - ApplicationExitInfoBase, ApplicationExitInfoProvider, AudioVolumeHandler, Camera2Wrapper, GoogleARCoreApi, HFPStatus, MultiWindowSupport, NativeLoader, NetworkConnectivity, OrientationLockListener, PermissionRequest, PlatformSupport, StaticSplashscreen, UnityGameManager, UnityGameState, UnityPermissions, VideoPlayer, TimeoutThread, UnityPlayer.kbCommand, IFrameReady, IPermissionRequestCallbacks, VideoPlayer.StateCallback. Affected methods - UnityPlayer.getNetworkProxySettings(java.lang.String), UnityPlayer.startOrientationListener(int), UnityPlayer.stopOrientationListener(), UnityPlayer.setMainSurfaceViewAspectRatio(float).

Deprecated: Removed deprecated TouchScreenKeyboard.Android.consumesOutsideTouches and closeKeyboardOnOutsideTap properties; Unity now always processes touches outside the on-screen keyboard.

Changed: Moved AnimationPlayableOutputExtensions and AnimationStreamSource out of experimental. Projects will be upgraded automatically with the new namespace.

Added: AssetImportContext.DependsOnArtifact overloads that take a UnityEngine.Object or a LazyLoadReference<T>, so a scripted importer can declare an artifact dependency directly from an object or lazy reference.

Added: Added a real-time counterpart to ControlContext.SendMessage for the Scriptable Audio Pipeline. This is a binary breaking change, but it's source compatible.

Added: Added seeking support to scriptable processors and audio clips used as generators.

Added: Scriptable processors: added GeneratorInstance.CreationParameters and RootOutputInstance.CreationParameters; deprecated ProcessorInstance.CreationParameters and its implicit conversions (to be removed in a following version).

Deprecated: Deprecated various Audio APIs.

Added: Added a new AssetPostprocessor.OnProcessScene callback used when loading scenes in playmode or during a build as a deterministic replacement to IProcessSceneWithReport.OnProcessScene.

Added: Added BuildAnalysisUtility.OpenWindow, which opens the Build Analysis window with a specific build selected.

Added: Allow for extra scripting defines when using BuildPlayer with BuildPlayerWithProfileOptions.

Added: GameObjectUtility.AllStaticEditorFlagsSet returns true only if all of the requested StaticEditorFlags are set.

Added: GameObjectUtility.AnyStaticEditorFlagsSet returns true if any of the requested StaticEditorFlags are set.

Changed: Added new abstractions for progressive asset loading.

Deprecated: GameObjectUtility.AreStaticEditorFlagsSet use AnyStaticEditorFlagsSet for the previous behavior, or AllStaticEditorFlagsSet to require all flags. Existing code is automatically upgraded to AnyStaticEditorFlagsSet by the API Updater (no behavior change).

Added: Added a new public API to ease discoverability of available Main Toolbar elements.

Added: Added a new RequiresInsights attribute. Packages and user code can use it to declare a dependency on the Insights module, which ensures the module is included in the build.

Added: Added APIs to insert custom entries in the Graph and Blackboard right-click menus.

Added: Added HierarchyViewColumnDescriptor.MinWidth to set the minimum width of a custom Hierarchy column.

Added: Added more alloc-free APIs for TextElement.

Added: Added public text API to generate text using ATG.

Added: Added right click menu support for state machine.

Added: Added ShortcutArguments.sourceEvent to get the event that triggered a shortcut.

Added: Added SourceTemplateAttribute.Target and the SourceTemplateTargetExpression enum to the built-in JetBrains.Annotations, so source templates can use Target = SourceTemplateTargetExpression.Outer.

Added: Added Span/ReadOnlySpan for applicable editor APIs.

Added: Added the BuildProfilePlayerSettings component, so that you can create, get, and remove a build profile's own player settings with BuildProfile.CreateComponent, GetComponent, and RemoveComponent.

Added: Added the MainToolbarCustomElement API to the customizable toolbar to enable the creation of custom VisualElements.

Added: Added the UnityEditor.EditorDialogEvents API, which raises dialogWillShow and dialogDismissed events when a native or custom modal dialog appears in the Editor. External tooling can use these events to detect that the Editor's main thread is blocked by a dialog instead of appearing hung.

Added: Added CompassSensor, exposing magnetic heading, true heading, raw geomagnetic vector, and heading accuracy as the parity equivalent of UnityEngine.Input.compass.

Added: Added EditorUserBuildSettings.activeNamedBuildTarget and BuildSummary.namedBuildTarget.

Added: Expose BuildProfileGraphicsSettings as a public build profile component.

Added: Expose BuildProfileQualitySettings as a public build profile component.

Added: GTK : Custom state machine conditions can now customize their row in the transition inspector.

Added: GTK : New API added to have icons for Conditions, logic groups, transition rules and transitions, shown on their row in the transition inspector.

Added: Introduced support for Unity Registry packages adding references to on-disk assets to a build profile.

Added: Introduced support for Unity Registry packages adding references to on-disk assets to a build profile.

Added: Project Auditor: Added migration areas to support adding migration rules.

Added: Project Auditor: Added Descriptor.IsSupported so analyzers can check if an issue is valid for the current platform and version.

Added: Project Auditor: Exposed various APIs to enable packages and user code to write rules.

Added: Project Auditor: exposed ShadersModule.OnAnalysisStarted.

Deprecated: Deprecate Oculus XR package.

Obsoleted: The EntityCommandBuffer PlaybackPolicy enum has been made obsolete with errors. To apply the same set of commands more than once, record them into a new EntityCommandBuffer for each playback.

Removed: Project Auditor: Removed FirstCustomCategory from IssueCategory enum, and moved it to IssueCategoryExtensions as a static field.

Added: Implemented visibility, focus and resizability APIs for Windowing.

Added: Implemented window focus, visibility, and destruction event system APIs in Windowing.

Changed: EngineDiagnosticsSettings.enabled now reads and writes the Diagnostic Data Collection setting of the active build profile, or of the active platform profile if no build profile is active, and doesn't change other build profiles. To disable Diagnostic Data Collection for all users and CI, set it to Disabled in a build profile asset, commit the asset, and build with that profile by using -activeBuildProfile or BuildPipeline.BuildPlayer with BuildPlayerWithProfileOptions.

Added: Added the CompanionComponent<T> unmanaged wrapper and the EntityManager.GetCompanion<T> extension so that companion components can be read from systems without using the obsolete managed component API.

Added: ChunkEntityEnumerator.IsSparse and .NextEntityIndexBatch were added to support cases where code needs to branch on sparse chunks, and would prefer batched APIs for performance reasons.

Changed: IDebugOnAdded and IDebugOnRemoved callback signatures now require Entity parameter. Update callbacks from OnAdded(ref T component) to OnAdded(Entity entity, in T component).

Deprecated: Deprecated BlobAssetReference<T>.TryRead and BlobAssetReference<T>.Write. Use BlobAssetReferenceIO<T>.TryRead and BlobAssetReferenceIO<T>.Write instead.

Deprecated: Deprecated the Write Groups API.

Deprecated: Deprecated the HierarchySearchProvider class. The standalone Entities Hierarchy window has been replaced by the integrated Editor Hierarchy window.

Deprecated: Marked the following functions as deprecated as part of the managed component deprecation: EntityQuery.ToComponentArray<T>(), EntityQuery.GetSingleton<T>(), TryGetSingleton<T>(), GetSingletonRW<T>(), and SetSingleton<T>() for managed (class) component types, and EntityQuery.GetTransformAccessArray().

Removed: Baking managed components and managed shared components is no longer supported. Baker.AddComponentObject, Baker.AddSharedComponentManaged, and Baker.SetSharedComponentManaged are now compile errors. Convert your data to unmanaged IComponentData / ISharedComponentData (use UnityObjectRef<T> to reference UnityEngine.Object instances) and bake it with the unmanaged AddComponent / AddSharedComponent APIs.

Removed: The managed-component APIs deprecated in 6.6 are now compile errors.

Removed: The EntityCommandBuffer/ParallelWriter APIs for managed IComponentData and managed ISharedComponentData are now compile errors.

Added: Added an API for creating, loading and unloading procedurally generated LightProbes objects.

Added: Added LODGroup.globalIlluminationLOD, Renderer.lodGroupMask and the Unity.Rendering.GlobalIlluminationLOD component.

Added: Let render pipelines opt out of the baked divide-by-PI convention.

Deprecated: Deprecated both TerrainExtensions.UpdateGIMaterials overloads. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated CombineInstance.realtimeLightmapScaleOffset. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated DynamicGI.indirectScale, DynamicGI.isConverged, DynamicGI.materialUpdateTimeSlice, DynamicGI.synchronousMode, DynamicGI.updateThreshold, DynamicGI.SetEmissive, and DynamicGI.SetEnvironmentData. DynamicGI.UpdateEnvironment is not deprecated. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated LightingSettings.realtimeGI and LightingSettings.realtimeEnvironmentLighting. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated LightmapParameters.clusterResolution, LightmapParameters.irradianceBudget, LightmapParameters.irradianceQuality, LightmapParameters.isTransparent, LightmapParameters.modellingTolerance, LightmapParameters.stitchEdges, and LightmapParameters.systemTag. LightmapParameters.resolution is not deprecated, because it also sets the resolution the Progressive Lightmapper bakes terrain at. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated MeshRenderer.enlightenVertexStream. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated Renderer.realtimeLightmapIndex and Renderer.realtimeLightmapScaleOffset. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated RendererExtensions.UpdateGIMaterials. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated Terrain.realtimeLightmapIndex and Terrain.realtimeLightmapScaleOffset. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated UnityEditor.Lightmapping.realtimeGI. Enlighten realtime Global Illumination will be removed in a future release.

Added: Added a new API to access the root VisualElement of Nodes.

Added: Added a new API to access the root VisualElement of States.

Added: Added a new overload to Graph.AddVariableNode that allows variable nodes to be created with a specific mode. Added a Mode getter to IVariableNode to get the current VariableNodeMode of the variable node.

Added: Added an API to edit Group Conditions.

Added: Added an overload to Graph.UndoBeginRecordGraph taking a param array of Node objects. Passing nodes here will track changes to serialized fields on user defined nodes, ensuring they are tracked by the undo system and that the graph is dirtied when these fields are modified.

Added: Added public API for customizing state accent visuals in editor and runtime.

Added: Added public API for customizing state transition visuals in editor and runtime.

Added: Added state options. Implemented by overriding State.OnDefineOptions on a State, and accessed through IStateOption. State options appear in the Inspector when the state is selected.

Added: Added StateMachine.OnStateMachineChanged() public API.

Added: Added the following properties on Graph: SupportedTypes, AvailableVariableTypes and AvailableConstantTypes. Added the following methods on Graph: BuildAvailableVariableTypes and BuildAvailableConstantTypes. Graph devs can now customize which variable types their end users have access to in the blackboard and constant types in the graph item library. Types added using BuildAvailableConstantTypes and BuildAvailableConstantTypes are implicitly added to SupportedTypes.

Added: Added the DataTypeStyleMapper.Register(System.Type dataType, UnityEngine.Color color) overload to allow changing the color of a data type while showing a default icon.

Added: Added IInputPortBuilder.WithDataTypes and IOutputPortBuilder.WithDataTypes APIs to define a port as Polymorphic (a port that accepts multiple data types).

Added: Added IPort.TrySetDataType API to programmatically change the data type of a polymorphic port.

Added: Added Node.OnPortDataTypeChanged callback that is triggered when a user changes the data type of a polymorphic port.

Added: Extend ITransition to add abilities to manage ITransitionRules.

Added: Extend the StateMachine class to add the ability to manage transitions between states.