@ohos.app.ability.Configuration (Configuration)

定义环境变化信息。Configuration是接口定义，仅做字段声明。

说明：

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import Configuration from '@ohos.app.ability.Configuration';

属性

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力：SystemCapability.Ability.AbilityBase

名称	类型	只读	必填	说明
language	string	否	否	表示应用程序的当前语言，例如“zh"。
colorMode	ColorMode	否	否	表示深浅色模式，默认为浅色。取值范围： - COLOR_MODE_NOT_SET：未设置 - COLOR_MODE_LIGHT：浅色模式 - COLOR_MODE_DARK：深色模式
direction	Direction	否	否	表示屏幕方向，取值范围： - DIRECTION_NOT_SET：未设置 - DIRECTION_HORIZONTAL：水平方向 - DIRECTION_VERTICAL：垂直方向
screenDensity	ScreenDensity	否	否	表示屏幕像素密度，取值范围： - SCREEN_DENSITY_NOT_SET：未设置 - SCREEN_DENSITY_SDPI：120 - SCREEN_DENSITY_MDPI：160 - SCREEN_DENSITY_LDPI：240 - SCREEN_DENSITY_XLDPI：320 - SCREEN_DENSITY_XXLDPI：480 - SCREEN_DENSITY_XXXLDPI：640
displayId	number	否	否	表示应用所在的物理屏幕ID。
hasPointerDevice	boolean	否	否	指示指针类型设备是否已连接，如键鼠、触控板等。

具体字段描述参考ohos.app.ability.Configuration.d.ts文件

示例：

import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback';
import Want from '@ohos.app.ability.Want';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
      let envCallback: EnvironmentCallback = {
          onConfigurationUpdated(config) {
              console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`);
              let language = config.language;
              let colorMode = config.colorMode;
              let direction = config.direction;
              let screenDensity = config.screenDensity;
              let displayId = config.displayId;
              let hasPointerDevice = config.hasPointerDevice;
          },
          onMemoryLevel(level) {
              console.log('onMemoryLevel level: ${level}');
          }
      };
      try {
          let applicationContext = this.context.getApplicationContext();
          let callbackId = applicationContext.on('environment', envCallback);
          console.log(`callbackId: ${callbackId}`);
      } catch (paramError) {
          console.error(`error: ${paramError.code}, ${paramError.message}`);
      }
  }
}