Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Microsoft-Windows-Devices-Lights-WinRT component specifies settings for Windows Dynamic Lighting.
In this section
| Setting | Description |
|---|---|
| DefaultLightingProvider | Specifies the package family name of the preinstalled application that should be considered the default Dynamic Lighting provider. This application must declare the "com.microsoft.windows.lighting" AppExtension in its manifest. |
| WinDLDefaultBrightness | Specifies the desired brightness level for the default effect run by the Dynamic Lighting Background Controller, expressed as a percentage value from 0 to 100. |
| WinDLDefaultEffectMainColor | Specifies the desired main color to be used in the default effect run by the Dynamic Lighting Background Controller. |
| WinDLDefaultEffectMode | Specifies a desired additional parameter (typically the direction the effect animation should travel across each device) to be used in the default effect run by the Dynamic Lighting Background Controller. |
| WinDLDefaultEffectSecondaryColor | Specifies the desired second color to be used in the default effect run by the Dynamic Lighting Background Controller, if applicable. |
| WinDLDefaultEffectSpeed | Specifies the desired speed for the default effect run by the Dynamic Lighting Background Controller, on a scale from 1 to 10. |
| WinDLDefaultEffectType | Specifies which RGB lighting effect should be run by the Dynamic Lighting Background Controller. |
XML examples
The following unattend XML example shows how you can specify the default Dynamic Lighting provider.
<?xml version="1.0" encoding="UTF-8"?>
<unattend xmlns="urn:schemas-microsoft-com:unattend">
<settings pass="offlineServicing">
<component language="neutral" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" versionScope="nonSxS" publicKeyToken="31bf3856ad364e35" processorArchitecture="amd64" name="Microsoft-Windows-Devices-Lights-WinRT">
<DefaultLightingProvider>MyAppPackage_8wekyb3d8bbwe</DefaultLightingProvider>
</component>
</settings>
</unattend>
The following unattend XML example shows how to specify default effect parameters for the Dynamic Lighting Background Controller. The effect being represented in this example is a blue and green Wave effect which travels across each lighting device from right to left.
<?xml version="1.0" encoding="UTF-8"?>
<unattend xmlns="urn:schemas-microsoft-com:unattend">
<settings pass="offlineServicing">
<component language="neutral" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" versionScope="nonSxS" publicKeyToken="31bf3856ad364e35" processorArchitecture="amd64" name="Microsoft-Windows-Devices-Lights-WinRT">
<WinDLDefaultEffectType>4</WinDLDefaultEffectType>
<WinDLDefaultEffectMode>1</WinDLDefaultEffectMode>
<WinDLDefaultEffectSpeed>9</WinDLDefaultEffectSpeed>
<WinDLDefaultEffectMainColor>0xFFFF0000</WinDLDefaultEffectMainColor>
<WinDLDefaultEffectSecondaryColor>0xFF00FF00</WinDLDefaultEffectSecondaryColor>
</component>
</settings>
</unattend>
Applies To
To determine whether a component applies to the image you’re building, load your image into Windows SIM and search for the component or setting name. For information on how to view components and settings, see Configure Components and Settings in an Answer File.
Related topics
An overview of Package Identity in Windows apps