HarmonyOS-鸿蒙app开发 —基于java设置项开发指导

场景介绍

TTS、Wireless、Network、Input、Sound、Display、Date、Call、General九类定义了表征终端设备状态的相关字段，如屏幕亮度、日期格式、字体显示大小等，应用程序可以对其进行查询，并进行相应的场景适配。

SystemSettings提供系统设置的相关接口，包括TTS、Wireless、Network、Input、Sound、Display、Date、Call、General九类字段的存储和检索接口。应用程序通过AppSettings类提供的方法对其自身的能力进行查询。

表1 SystemSettings的主要接口
接口名	描述
getUri(String name)	为特定的字段构造URI，用于DataAbility的数据监视。
getValue(DataAbilityHelper dataAbilityHelper, String name)	获取指定字段的值。

表2 SystemSettings.TTS提供的典型字段
字段名	字段描述
DEFAULT_TTS_PITCH	文本转语音引擎的默认音调。
DEFAULT_TTS_RATE	文本转语音引擎的默认语速。

表3 SystemSettings.Wireless提供的典型字段
字段名	字段描述
BLUETOOTH_STATUS	蓝牙开启状态。
WIFI_STATUS	WLAN是否启用。
WIFI_TO_MOBILE_DATA_AWAKE_TIMEOUT	从WLAN断开连接后等待建立移动数据连接时保持唤醒锁的最长时间。

表4 SystemSettings.Network提供的典型字段
字段名	字段描述
DATA_ROAMING_STATUS	数据漫游开启状态。
NETWORK_PREFERENCE_USAGE	设置用户经常使用的网络。

**表10** SystemSettings.Call提供的典型字段
字段名	字段描述
RTT_CALLING_STATUS	设置来去电是否启动RTT模式进行应答。

应用程序打开某个Slice时，在OnStart()时，注册相关设置项的回调，并读取一次该设置项的值，进行初始化适配。

@Override

public void onStart(Intent intent) {

// …

dataAbilityHelper = DataAbilityHelper.creator(this);

IDataAbilityObserver dataAbilityObserver = new IDataAbilityObserver() {

@Override

public void onChange() {

String timeFormat = SystemSettings.getValue(dataAbilityHelper, SystemSettings.Date.TIME_FORMAT);

setTimeFormat(timeFormat);

}

};

dataAbilityHelper.registerObserver(SystemSettings.getUri(SystemSettings.Date.TIME_FORMAT), dataAbilityObserver);

}

void setTimeFormat(String timeFormat) {

String timeStr = “12”;

if (timeStr.equals(timeFormat)) {

// Display in 12-hour format

} else {

// Display in 24-hour format

}

在onStop()时，解除回调注册。

dataAbilityHelper.unregisterObserver(SystemSettings.getUri(SystemSettings.Date.TIME_FORMAT), dataAbilityObserver);