HarmonyOS之系统设置项的查询和使用

一、基本概念

• 应用程序可以对系统各类设置项进行查询，例如，三方应用提前注册飞行模式设置项的回调。当用户通过系统设置修改终端的飞行模式状态时，三方应用会检测到此设置项发生变化并进行适配，如检测到飞行模式开启，将进入离线状态；检测到飞行模式关闭，其将重新获取在线数据。
• 系统设置数据项分为 TTS（Text To Speech）、Wireless、Network、Input、Sound、Display、Date、Call、General 九类，应用程序可以根据自身拥有的权限对其进行操作。
• TTS、Wireless、Network、Input、Sound、Display、Date、Call、General 九类定义了表征终端设备状态的相关字段，如屏幕亮度、日期格式、字体显示大小等，应用程序可以对其进行查询，并进行相应的场景适配。

二、API

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

• SystemSettings.TTS 提供的典型字段：

• SystemSettings.Wireless 提供的典型字段：

• SystemSettings.Network 提供的典型字段：

• SystemSettings.Input 提供的典型字段：

• SystemSettings.Sound 提供的字段：

• SystemSettings.Display 提供的典型字段：

• SystemSettings.Date 提供的典型字段：

• SystemSettings.General 提供的典型字段：

• SystemSettings.Call 提供的典型字段：

三、使用流程

• 应用程序打开某个 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
	    }
	}

  

 

  
1
  
2
  
3
  
4
  
5
  
6
  
7
  
8
  
9
  
10
  
11
  
12
  
13
  
14
  
15
  
16
  
17
  
18
  
19
  
20
  
21
  
22
 

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

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

  

 

  
1
 

文章来源: blog.csdn.net，作者：Serendipity·y，版权归原作者所有，如需转载，请联系作者。

原文链接：blog.csdn.net/Forever_wj/article/details/118545288