{"_id":"com.unity.xr.compositionlayers","name":"com.unity.xr.compositionlayers","description":"Support for Provider based XR SDK Composition Layers.","provider":"upm","versions":{"2.6.0":{"_upm":{"changelog":"### Added\n* Added a Dynamic Texture option to the source texture component. When enabled, the layer's swapchain image is rewritten every frame, so textures whose contents are updated externally on the GPU (such as native plugin or AHardwareBuffer-backed `Texture2D` objects) no longer appear static.\n* Added a `Mip Mode` option to the source texture component that controls how a Local Texture's mip levels reach the layer swapchain: `CopyFromSource`, `AutoGenerate`, or `None` (default). See the [Source Textures component](xref:xr-layers-source-textures) documentation for details.\n* Added an inspector warning to the Equirect layer when the Upper Vertical Angle is at or below the Lower Vertical Angle.\n\n### Fixed\n* Fixed per-frame managed allocations in `CompositionLayerManager` caused by `CompositionLayerManager.LayerInfo` not implementing `IEquatable<LayerInfo>`.\n* Fixed `InteractableUIMirror` so that XRI input continues to work correctly when switching a composition layer's type at runtime via `ChangeLayerDataType`.\n* Fixed `InteractableUIMirror` so that interactive UI controls like sliders, scrollbars, scroll views, and joystick scrolling work correctly on composition layer canvases.\n* Fixed the Default Scene Layer so it is reliably found after domain reload, scene reopening, and other editor lifecycle events, and no longer produces an error when duplicated.\n* Fixed documentation to clarify that single-pass instanced (SPI) rendering and GPU Instancing are supported for projection layers.\n* Fixed static cleanup analyzer warnings in Unity 6000.7.\n* Fixed Equirect layer emulation so that the Editor preview matches the headset output.\n\n### Changed\n* Raised the minimum supported Unity Editor version to 6000.0.\n* The Default Scene Layer is now serialized into the scene (persisted in the scene file, still excluded from builds) instead of being recreated on load.\n* Changed how the Equirect layer's Upper and Lower Vertical Angles are represented. They are now measured from the equator (positive above, negative below), so a full sphere uses Upper +90 and Lower -90 instead of the previous +90 and +90. Existing layers are upgraded automatically."},"unity":"6000.0","samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"},{"path":"Samples~/CompositionLayersSample","description":"Sample showing how to use Composition Layers.","displayName":"Sample Composition Layers Scene"}],"documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@2.6/manual/index.html","name":"com.unity.xr.compositionlayers","version":"2.6.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"4101f28daab7cd942264345c4af14951605a917e","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-2.6.0.tgz"}},"2.5.0":{"_upm":{"changelog":"### Added\n* Added hierarchy window warning icon and inspector warnings for camera clear flags or background alpha using underlay or passthrough composition layers.\n* Added Individual, Left and Right Target Eye option to the source texture component. Allowing per-eye or single eye textures for standard Quad, Cylinder, Equirect, and Cube layers.\n\n### Fixed\n* Fixed Color Scale and Bias emulation in the Editor and Standalone builds.\n* Fixed composition layer emulation not rendering in Editor Play Mode or Standalone builds.\n* Fixed `CompositionLayer` to successfully open prefabs from scenes that do not contain any composition layers.\n* Fixed `EmulatedLayerData` so it no longer logs an error related to a destroyed CompositionLayer when changing scenes from within prefab mode.\n* Fixed `InteractableUIMirror` so that its fields are correctly serialized, resolving a warning that was previously logged to the console in Unity 6000.6.0a5 or newer.\n* Fixed `CameraTargetTextureFactory` so that it no longer logs an error related to releasing render texture that is set as Camera.targetTexture.\n\n### Changed\n* Emulation in Play mode and Standalone builds previously depended on the now obsolete `com.unity.modules.vr` and now depends on`com.unity.modules.xr` and falls back to always emulating when the XR module is not present."},"unity":"2022.3","samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"},{"path":"Samples~/CompositionLayersSample","description":"Sample showing how to use Composition Layers.","displayName":"Sample Composition Layers Scene"}],"unityRelease":"11f1","documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@2.5/manual/index.html","name":"com.unity.xr.compositionlayers","version":"2.5.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"2843cb312e13e070a1b63371bd3bcc64acff42f4","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-2.5.0.tgz"}},"2.4.0":{"_upm":{"changelog":"### Added\n* Added `CompositionLayerManager.TryGetLayerId(CompositionLayer layer, out int layerId)` to get a layer's unique id instead of `GetInstanceID()` or `GetEntityID()`.\n\n### Fixed\n* Fixed `InteractableUIMirror` to support creating or duplicating them during runtime such as with prefabs or asset bundles.\n* Fixed `CompositionLayersRuntimeSettings` so that the `Script` property is no longer modifiable from the inspector.\n* Fixed `InteractableUIMirror` so cameras can be added at runtime without camera layer issues.\n* Fixed `ScriptableSingleton` warning log when first launching a project with the composition layers package.\n\n### Changed\n* Changed `InteractactableUIMirror` Cameras so they are visible in the inspector\n* Changed how CompositionLayerManager initializes `LayerInfo.Id` to use its own generated unique ids instead of `GetInstanceID()` or `GetEntityID()`."},"unity":"2022.3","samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"},{"path":"Samples~/CompositionLayersSample","description":"Sample showing how to use Composition Layers.","displayName":"Sample Composition Layers Scene"}],"unityRelease":"11f1","documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@2.4/manual/index.html","name":"com.unity.xr.compositionlayers","version":"2.4.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"461024b1d757aaf3b16bd38f36af0650008ef687","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-2.4.0.tgz"}},"2.3.0":{"_upm":{"changelog":"### Added\n* Added Background Type option to the Composition Layer Splash Screen settings to allow using Passthrough as the background.\n\n### Fixed\n* Fixed `DefaultLayerData` so it no longer logs a warning related to the `SerializeReferenceAttribute` when you install this package for the first time.\n* Fixed internal code so that inspecting a `CompositionLayersRuntimeSettings` object soon after package import no longer causes a warning to be logged to the console."},"unity":"2022.3","samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"},{"path":"Samples~/CompositionLayersSample","description":"Sample showing how to use Composition Layers.","displayName":"Sample Composition Layers Scene"}],"unityRelease":"11f1","documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@2.3/manual/index.html","name":"com.unity.xr.compositionlayers","version":"2.3.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"d683872db6618c9db277420f7f70f857ab2716a9","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-2.3.0.tgz"}},"2.2.0":{"_upm":{"changelog":"### Deprecated\n* Deprecated `EmulationLayerUniversalScriptableRendererPass.Execute`. This method depends on URP Compatibility Mode, which has been deprecated since Unity 6.0 and is removed in Unity 6.4."},"unity":"2022.3","samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"},{"path":"Samples~/CompositionLayersSample","description":"Sample showing how to use Composition Layers.","displayName":"Sample Composition Layers Scene"}],"unityRelease":"11f1","documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@2.2/manual/index.html","name":"com.unity.xr.compositionlayers","version":"2.2.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"08f04b171ba16292eefabf638959f7d59f1e321b","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-2.2.0.tgz"}},"2.1.1":{"_upm":{"changelog":"### Added\n* Added Right-eye configuration support to the Stereo Projection Layer.\n\n### Fixed\n* Fixed `CompositionLayer`'s `LayerType` property to not ask the user twice to add an extension when set to anything other than `[Empty]` if the user chooses `No`.\n* Fixed `NullReferenceException` when adding a Source Textures component to an empty GameObject.\n* Fixed shader warnings."},"unity":"2022.3","samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"},{"path":"Samples~/CompositionLayersSample","description":"Sample showing how to use Composition Layers.","displayName":"Sample Composition Layers Scene"}],"unityRelease":"11f1","documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@2.1/manual/index.html","name":"com.unity.xr.compositionlayers","version":"2.1.1","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"437b0757672654e5f9311c728f02727096feadfd","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-2.1.1.tgz"}},"2.1.0":{"_upm":{"changelog":"### Added\n* Added Game view and Standalone color scale bias emulation for Default Scene Layer for the Built-in Render Pipeline and Universal Render Pipeline.\n* Added Project Validation rules for Composition Layer Transparency.\n\n### Fixed\n* Fixed `CompositionLayerManager` so that it correctly sets layers to be visible when they are enabled after previously being disabled."},"unity":"2022.3","samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"},{"path":"Samples~/CompositionLayersSample","description":"Sample showing how to use Composition Layers.","displayName":"Sample Composition Layers Scene"}],"unityRelease":"11f1","documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@2.1/manual/index.html","name":"com.unity.xr.compositionlayers","version":"2.1.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"5e1c832d301cda8acd7de7a4d03507f0f7a67227","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-2.1.0.tgz"}},"2.0.0":{"_upm":{"changelog":"### Fixed\n* Fixed Composition Layers not hiding or showing correctly when using Scene Visibility in the hierarchy.\n* Fixed an issue where non-cubemap textures could be assigned to the Cube Projection Layer.\n\n### Changed\n* Moved `ProjectionEyeRigUtil` to the `Unity.XR.CompositionLayers.Layers.Editor` namespace.\n* Moved `CompositionSplash` to the `Unity.XR.CompositionLayers` namespace."},"unity":"2022.3","samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"},{"path":"Samples~/CompositionLayersSample","description":"Sample showing how to use Composition Layers.","displayName":"Sample Composition Layers Scene"}],"unityRelease":"11f1","documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@2.0/manual/index.html","name":"com.unity.xr.compositionlayers","version":"2.0.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"3f9eb72f637342d3b13c579b909d484822d183db","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-2.0.0.tgz"}},"1.0.0":{"_upm":{"changelog":"### Added\n* Added Default Layer Support allows for the creation of a default layer and rearragment of the default layer order.\n* Added Composition Layer Sample Scene to demonstrate the use of Composition Layers in a scene.\n* Added Composition Layer Android Sample Surface Scene to demonstrate the use of Andriods External Surface in a scene.\n* Added supporing HDR Tonemapping extension. It allows to set HDR parameters for each layer.\n* Added supporting MirrorViewRenderer. It provides to draw mirror view rendering with layers on XR.\n* Added supporting automatically renderer feature settings on URP and HDRP.\n\n### Fixed\n* Fixed Interactable UI Scalings are now consistent between editor and build.\n* Fixed Projection Eye Rig Emulation for URP and Unity6.\n\n### Changed\n* Removed EmulationLayerUniversalScriptableRendererFeature.(Manual configuration is no longer required.)"},"unity":"2022.3","samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"},{"path":"Samples~/CompositionLayersSample","description":"Sample showing how to use Composition Layers.","displayName":"Sample Composition Layers Scene"}],"unityRelease":"11f1","documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@1.0/manual/index.html","name":"com.unity.xr.compositionlayers","version":"1.0.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"fc89f0bd9eb1859a33e79f294264e64db3e9bfe8","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-1.0.0.tgz"}},"0.6.0":{"_upm":{"changelog":"### Added\n* Added a projection validation to check if EmulationLayerUniversalScriptableRendererFeature is added to the current pipeline for URP. Click \"Fix\" button will automatically add the emulation render feature to enable URP Editor emulation.\n* Added composition layer splash screen support. See Composition Layer Splash Screen section in documentation for details.\n\n### Changed\n* Emulation In Playmode or Standalone now is only available when no XR provider is active or no headset is connected for visual approximation and preview purposes.\n\n### Fixed\n* Fixed error spamming issue when creating a UI canvas and drag it into a quad layer."},"type":"assets","unity":"2022.3","upmCi":{"footprint":"5010976c87fc835323f5aa9df2ecd9d3d8a01e02"},"samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"}],"repository":{"url":"https://github.cds.internal.unity3d.com/unity/xr.sdk.compositionlayers.git","type":"git","revision":"a9c787f0baf2f12244f6b35489472a01a9fdf64a"},"documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@0.6/manual/index.html","name":"com.unity.xr.compositionlayers","version":"0.6.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"992ad93d8e2ad31d7513aa32ca6d6434e1a25e35","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-0.6.0.tgz"}},"0.5.0":{"_upm":{"changelog":"### This is the first experimental release of *Unity Package XR CompositionLayers \\<com.unity.xr.compositionlayers\\>*."},"type":"assets","unity":"2022.3","upmCi":{"footprint":"661ec7c39860108cce8ff17b14af9964e7dcd1a8"},"samples":[{"path":"Samples~/ExternalSurfaceSample","description":"Sample project that implements an external Android surface rendering to a composition layer using the XR_KHR_android_surface_swapchain extension. \n\nCurrently, this sample can only be seen in the editor when using Unity's Built-in Render Pipline.","displayName":"Sample External Android Surface Project"}],"repository":{"url":"https://github.cds.internal.unity3d.com/unity/xr.sdk.compositionlayers.git","type":"git","revision":"c281c16812bdbbe23aad5a553c576dbfafbfa65e"},"documentationUrl":"https://docs.unity3d.com/Packages/com.unity.xr.compositionlayers@0.5/manual/index.html","name":"com.unity.xr.compositionlayers","version":"0.5.0","displayName":"XR Composition Layers","description":"Support for Provider based XR SDK Composition Layers.","keywords":["xr","composition","layers"],"dependencies":{"com.unity.inputsystem":"1.6.3","com.unity.xr.core-utils":"2.2.2","com.unity.xr.management":"4.0.1"},"dist":{"shasum":"b9b7bd58a8dee88ad892f2a3328a58c914c78490","tarball":"https://download.packages.unity.com/com.unity.xr.compositionlayers/-/com.unity.xr.compositionlayers-0.5.0.tgz"}}},"time":{"2.6.0":"2026-09-08T21:01:31.417Z","2.5.0":"2026-06-24T16:14:35.965Z","2.4.0":"2026-03-16T17:59:50.306Z","2.3.0":"2025-12-19T22:30:59.786Z","2.2.0":"2025-10-21T16:24:47.180Z","2.1.1":"2025-10-01T17:14:59.504Z","2.1.0":"2025-07-01T17:07:30.377Z","2.0.0":"2024-12-13T00:50:09.063Z","1.0.0":"2024-11-01T15:42:40.393Z","0.6.0":"2024-07-03T15:24:26.000Z","0.5.0":"2024-02-26T10:46:50.000Z"},"dist-tags":{"latest":"2.6.0"},"etag":"\"5c09-sfrGXYCLL2UvvJ5RzadPjYdZOlo\""}