Share via


Microsoft-Windows-Devices-Lights-WinRT

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.

Components

An overview of Package Identity in Windows apps

Create and host an app extension

Preinstall Apps Using DISM