# 环境变量 **Environment**是框架在应用程序启动时创建的单例对象,它为**AppStorage**提供了一系列应用程序需要的环境状态属性,这些属性描述了应用程序运行的设备环境。**Environment**及其属性是不可变的,所有属性值类型均为简单类型。 如下示例展示了从**Environment**获取语音环境: ``` Environment.EnvProp("accessibilityEnabled", "default"); var enable = AppStorageGet("accessibilityEnabled"); ``` **accessibilityEnabled**是**Environment**提供默认系统变量识别符。首先需要将对应系统属性绑定到**Appstorage**中,后可以通过AppStorage中的方法或者装饰器,访问对应系统属性数据。 ## Environment接口

key

参数

返回值

说明

EnvProp

key : string

defaultValue: any

boolean

关联此系统项到Appstorage中。建议在app启动时使用此Api。如果此属性在Appstorage已经存在则返回false。请勿使用AppStorage中的变量,在调用此方法关联环境变量。

EnvProps

keys: {

key: string,

defaultValue: any

}[]

void

关联此系统项数组到Appstorage中。

Keys

Array<string>

number

返回关联的系统项。

## Environment内置的环境变量

key

类型

说明

accessibilityEnabled

boolean

无障碍屏幕朗读是否启用。

colorMode

ColorMode

深浅色模式,选项值为:

  • ColorMode.LIGHT:浅色模式;
  • ColorMode.DARK:深色模式。

fontScale

number

字体大小比例,范围为:[0.85, 1.45]。

fontWeightScale

number

字体权重比例,取值范围:[0.6, 1.6]。

layoutDirection

LayoutDirection

布局方向类型,可选值为:

  • LayoutDirection.LTR:从左到右;
  • LayoutDirection.RTL:从右到左。

languageCode

string

当前系统语言值,小写字母,例如zh。