<!--
{
  "documentType" : "article",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/IntentParameter-Measurements-Illuminance",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Illuminance"
}
-->

# Illuminance

Configure the details for parameter variables that contain illuminance values.

## Topics

### Creating an intent parameter

[`convenience init(title: LocalizedStringResource, description: LocalizedStringResource?, defaultValue: Double?, defaultUnit: IntentParameter<Value>.Illuminance?, defaultUnitAdjustForLocale: Bool, supportsNegativeNumbers: Bool, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior)`](/documentation/AppIntents/IntentParameter/init(title:description:defaultValue:defaultUnit:defaultUnitAdjustForLocale:supportsNegativeNumbers:requestValueDialog:inputConnectionBehavior:)-81yqr)

Creates an app intent parameter with a default unit for the measurement.

[`convenience init<Spec>(title: LocalizedStringResource, description: LocalizedStringResource?, defaultValue: Double?, defaultUnit: IntentParameter<Value>.Illuminance?, defaultUnitAdjustForLocale: Bool, supportsNegativeNumbers: Bool, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, resolvers: () -> Spec)`](/documentation/AppIntents/IntentParameter/init(title:description:defaultValue:defaultUnit:defaultUnitAdjustForLocale:supportsNegativeNumbers:requestValueDialog:inputConnectionBehavior:resolvers:)-2486g)

Creates an app intent parameter with a default unit for the measurement.

[`convenience init(title: LocalizedStringResource, description: LocalizedStringResource?, defaultValue: Double?, unit: IntentParameter<Value>.Illuminance, unitAdjustForLocale: Bool, supportsNegativeNumbers: Bool, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior)`](/documentation/AppIntents/IntentParameter/init(title:description:defaultValue:unit:unitAdjustForLocale:supportsNegativeNumbers:requestValueDialog:inputConnectionBehavior:)-73fj3)

Creates an app intent parameter that specifies the unit for the measurement.

[`convenience init<Spec>(title: LocalizedStringResource, description: LocalizedStringResource?, defaultValue: Double?, unit: IntentParameter<Value>.Illuminance, unitAdjustForLocale: Bool, supportsNegativeNumbers: Bool, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, resolvers: () -> Spec)`](/documentation/AppIntents/IntentParameter/init(title:description:defaultValue:unit:unitAdjustForLocale:supportsNegativeNumbers:requestValueDialog:inputConnectionBehavior:resolvers:)-1ji9i)

Creates an app intent parameter that specifies the unit for the measurement.

[`convenience init<OptionsProvider>(title: LocalizedStringResource, description: LocalizedStringResource?, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, optionsProvider: OptionsProvider)`](/documentation/AppIntents/IntentParameter/init(title:description:requestValueDialog:inputConnectionBehavior:optionsProvider:)-8j88q)

Creates an app intent parameter with a list of selectable options.

[`convenience init<Spec, OptionsProvider>(title: LocalizedStringResource, description: LocalizedStringResource?, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, resolvers: () -> Spec, optionsProvider: OptionsProvider)`](/documentation/AppIntents/IntentParameter/init(title:description:requestValueDialog:inputConnectionBehavior:resolvers:optionsProvider:)-4hm4)

Creates an app intent parameter with a list of selectable options that can convert the selected value.

### Accessing unit details

[`var unit: IntentParameter<Value>.Illuminance?`](/documentation/AppIntents/IntentParameter/unit-5d6kq)

[`enum Illuminance`](/documentation/AppIntents/IntentParameter/Illuminance)

[`var defaultUnit: IntentParameter<Value>.Illuminance?`](/documentation/AppIntents/IntentParameter/defaultUnit-2j2ui)

[`var supportsNegativeNumbers: Bool?`](/documentation/AppIntents/IntentParameter/supportsNegativeNumbers-6mvvw)

[`var unitAdjustForLocale: Bool?`](/documentation/AppIntents/IntentParameter/unitAdjustForLocale-po5z)



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)