鴻蒙OS 開(kāi)發(fā)指導(dǎo)

場(chǎng)景介紹

TTS、Wireless、Network、Input、Sound、Display、Date、Call、General 九類(lèi)定義了表征終端設(shè)備狀態(tài)的相關(guān)字段，如屏幕亮度、日期格式、字體顯示大小等，應(yīng)用程序可以根據(jù)自身所擁有的權(quán)限對(duì)其進(jìn)行增、刪、改、查等操作，并進(jìn)行相應(yīng)的場(chǎng)景適配。

例如：TIME_FORMAT——表示日期格式，應(yīng)用程序可進(jìn)行讀寫(xiě)。

圖1 數(shù)據(jù)表更新過(guò)程

接口說(shuō)明

SystemSettings 提供系統(tǒng)設(shè)置的相關(guān)接口，包括 TTS、Wireless、Network、Input、Sound、Display、Date、Call、General 九類(lèi)字段的存儲(chǔ)和檢索接口。應(yīng)用程序通過(guò) AppSettings 類(lèi)提供的方法對(duì)其自身的能力進(jìn)行查詢(xún)。

開(kāi)發(fā)步驟

1. 應(yīng)用程序打開(kāi)某個(gè) Slice 時(shí)，在 OnStart()時(shí)，注冊(cè)相關(guān)設(shè)置項(xiàng)的回調(diào)，并讀取一次該設(shè)置項(xiàng)的值，進(jìn)行初始化適配。

   場(chǎng)景介紹
   TTS、Wireless、Network、Input、Sound、Display、Date、Call、General九類(lèi)定義了表征終端設(shè)備狀態(tài)的相關(guān)字段，如屏幕亮度、日期格式、字體顯示大小等，應(yīng)用程序可以根據(jù)自身所擁有的權(quán)限對(duì)其進(jìn)行增、刪、改、查等操作，并進(jìn)行相應(yīng)的場(chǎng)景適配。
   
   例如：TIME_FORMAT——表示日期格式，應(yīng)用程序可進(jìn)行讀寫(xiě)。
   
   圖1 數(shù)據(jù)表更新過(guò)程
   點(diǎn)擊放大
   
   接口說(shuō)明
   SystemSettings 提供系統(tǒng)設(shè)置的相關(guān)接口，包括TTS、Wireless、Network、Input、Sound、Display、Date、Call、General 九類(lèi)字段的存儲(chǔ)和檢索接口。應(yīng)用程序通過(guò) AppSettings 類(lèi)提供的方法對(duì)其自身的能力進(jìn)行查詢(xún)。
   
   表1 AppSettings的主要接口
   接口名
   
   描述
   
   canShowOverlays(Context context)
   
   檢查指定應(yīng)用程序是否可以顯示在其他應(yīng)用之上。
   
   checkSetPermission(Context context)
   
   通過(guò)應(yīng)用上下文檢查指定的應(yīng)用是否具有修改系統(tǒng)設(shè)置的權(quán)限。
   
   表2 SystemSettings的主要接口
   接口名
   
   描述
   
   getUri(String name)
   
   為特定的字段構(gòu)造URI，用于DataAbility的數(shù)據(jù)監(jiān)視。
   
   getValue(DataAbilityHelper dataAbilityHelper, String name)
   
   獲取指定字段的值。
   
   setValue(DataAbilityHelper dataAbilityHelper, String name, String value)
   
   設(shè)置指定字段的值。
   
   表3 SystemSettings.TTS提供的典型字段
   字段名
   
   字段描述
   
   DEFAULT_TTS_PITCH
   
   文本轉(zhuǎn)語(yǔ)音引擎的默認(rèn)音調(diào)。
   
   DEFAULT_TTS_RATE
   
   文本轉(zhuǎn)語(yǔ)音引擎的默認(rèn)語(yǔ)速。
   
   表4 SystemSettings.Wireless提供的典型字段
   字段名
   
   字段描述
   
   BLUETOOTH_STATUS
   
   藍(lán)牙開(kāi)啟狀態(tài)。
   
   WIFI_STATUS
   
   WLAN是否啟用。
   
   WIFI_TO_MOBILE_DATA_AWAKE_TIMEOUT
   
   從WLAN斷開(kāi)連接后等待建立移動(dòng)數(shù)據(jù)連接時(shí)保持喚醒鎖的最長(zhǎng)時(shí)間。
   
   表5 SystemSettings.Network提供的典型字段
   字段名
   
   字段描述
   
   DATA_ROAMING_STATUS
   
   數(shù)據(jù)漫游開(kāi)啟狀態(tài)。
   
   NETWORK_PREFERENCE_USAGE
   
   設(shè)置用戶(hù)經(jīng)常使用的網(wǎng)絡(luò)。
   
   表6 SystemSettings.Input提供的典型字段
   字段名
   
   字段描述
   
   DEFAULT_INPUT_METHOD
   
   設(shè)置默認(rèn)的輸入法，并記錄此輸入法的ID。
   
   ACTIVATED_INPUT_METHODS
   
   已激活的輸入法列表。
   
   AUTO_CAPS_TEXT_INPUT
   
   設(shè)置文本編輯器是否啟用自動(dòng)大寫(xiě)。
   
   表7 SystemSettings.Sound提供的字段
   字段名
   
   字段描述
   
   HAPTIC_FEEDBACK_STATUS
   
   設(shè)置是否開(kāi)啟觸摸反饋。
   
   VIBRATE_WHILE_RINGING
   
   設(shè)置來(lái)電響鈴時(shí)是否震動(dòng)。
   
   DEFAULT_NOTIFICATION_SOUND
   
   系統(tǒng)默認(rèn)通知鈴聲的存儲(chǔ)區(qū)。
   
   表8 SystemSettings.Display提供的典型字段
   字段名
   
   字段描述
   
   FONT_SCALE
   
   設(shè)置字體大小因子。
   
   SCREEN_BRIGHTNESS_STATUS
   
   設(shè)置屏幕亮度。
   
   AUTO_SCREEN_BRIGHTNESS
   
   設(shè)置是否打開(kāi)屏幕亮度自動(dòng)調(diào)節(jié)模式。
   
   SCREEN_OFF_TIMEOUT
   
   設(shè)置設(shè)備屏幕自動(dòng)休眠時(shí)間。
   
   表9 SystemSettings.Date提供的典型字段
   字段名
   
   字段描述
   
   DATE_FORMAT
   
   設(shè)置日期格式。
   
   TIME_FORMAT
   
   設(shè)置以12或24小時(shí)制顯示時(shí)間。
   
   AUTO_GAIN_TIME
   
   是否從網(wǎng)絡(luò)（NITZ）自動(dòng)獲取日期，時(shí)間和時(shí)區(qū)的值。
   
   AUTO_GAIN_TIME_ZONE
   
   是否從網(wǎng)絡(luò)（NITZ）自動(dòng)獲取時(shí)區(qū)的值。
   
   表10 SystemSettings.General提供的典型字段
   字段名
   
   字段描述
   
   SETUP_WIZARD_FINISHED
   
   識(shí)別開(kāi)機(jī)向?qū)欠褚呀?jīng)運(yùn)行過(guò)。
   
   AIRPLANE_MODE_STATUS
   
   飛行模式是否開(kāi)啟。
   
   DEVICE_NAME
   
   設(shè)備名稱(chēng)。
   
   ACCESSIBILITY_STATUS
   
   設(shè)置輔助功能是否可用。
   
   表11 SystemSettings.Call提供的典型字段
   字段名
   
   字段描述
   
   RTT_CALLING_STATUS
   
   設(shè)置來(lái)去電是否啟動(dòng)RTT模式進(jìn)行應(yīng)答。
   
   開(kāi)發(fā)步驟
   應(yīng)用程序打開(kāi)某個(gè)Slice時(shí)，在OnStart()時(shí)，注冊(cè)相關(guān)設(shè)置項(xiàng)的回調(diào)，并讀取一次該設(shè)置項(xiàng)的值，進(jìn)行初始化適配。
   @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) {
       if ("12".equals(timeFormat)) {        
           // Display in 12-hour format
       } else {
           // Display in 24-hour format
       }
   }
   在 onStop()時(shí)，解除回調(diào)注冊(cè)。
   dataAbilityHelper.unregisterObserver(SystemSettings.getUri(SystemSettings.Date.TIME_FORMAT), dataAbilityObserver);