輔助功能

說明： 本模塊首批接口從 API version 7 開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]點擊或者復制轉到。

導入模塊

import accessibility from '@ohos.accessibility';

AbilityState

輔助應用狀態類型。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Core

AbilityType

無障礙輔助應用類型。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Core

AccessibilityAbilityInfo

輔助應用信息。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Core

屬性

Action

應用所支持的目標動作。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Core

Capability

輔助應用能力類型。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Core

aptionsFontEdgeType8+

字幕字體邊緣類型。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Hearing

CaptionsFontFamily8+

字幕字體。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Hearing

CaptionsStyle8+

字幕風格。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Hearing

CaptionsManager8+

字幕配置。

屬性

方法

下列 API 示例中都需要使用 [accessibility.getCaptionsManager()]獲取 captionsManager 實例，再通過此實例調用對應的方法。

on('enableChange')

on(type: 'enableChange', callback: Callback): void;

注冊字幕配置啟用的監聽函數。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Hearing

• 參數：

  參數名	參數類型	必填	說明
  type	string	是	監聽字幕配置啟用狀態。
  callback	Callback	是	回調函數，在啟用狀態變化時將狀態通過此函數進行通知。

• 示例

  captionsManager.on('enableChange',(data) = > {
      console.info('success data:subscribeStateObserver : ' + JSON.stringify(data))
  })
  

on('styleChange')

on(type: 'styleChange', callback: Callback): void;

注冊字幕風格變化的監聽函數。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Hearing

• 參數：

  參數名	參數類型	必填	說明
  type	string	是	監聽字幕風格變化。
  callback	Callback<[CaptionsStyle]>	是	回調函數，在字幕風格變化時通過此函數進行通知。

• 示例

  captionsManager.on('styleChange',(data) = > {
      console.info('success data:subscribeStateObserver : ' + JSON.stringify(data))
  })
  

off('enableChange')

off(type: 'enableChange', callback?: Callback): void;

移除字幕配置啟用的監聽函數。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Hearing

• 參數：

  參數名	參數類型	必填	說明
  type	string	是	監聽字幕配置啟用狀態。
  callback	Callback	否	回調函數，在啟用狀態變化時將狀態通過此函數進行通知。

• 示例

  captionsManager.off('enableChange')
  

off('styleChange')

off(type: 'styleChange', callback?: Callback): void;

移除字幕風格變化的監聽函數。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Hearing

• 參數：

  參數名	參數類型	必填	說明
  type	string	是	字幕風格變化。
  callback	Callback<[CaptionsStyle]>	否	回調函數，在字幕風格變化時通過此函數進行通知。

• 示例

  captionsManager.off('styleChange')
  

EventInfo

界面變更事件。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Core

屬性

方法

constructor

constructor(jsonObject)

構造函數。

• 參數：

  參數名	參數類型	必填	說明
  jsonObject	string	是	創建對象所需要的 JSON 格式字符串。

• 示例

  let eventInfo = new accessibility.EventInfo({"type":"click","bundleName":"com.example.MyApplication","triggerAction":"click"})
  

EventType

無障礙事件類型。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Core

TextMoveUnit

文本無障礙導航移動粒度。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Core

WindowUpdateType

窗口變化類型。

系統能力 ：以下各項對應的系統能力均為 SystemCapability.Barrierfree.Accessibility.Core

accessibility.getAbilityLists

getAbilityLists(abilityType: AbilityType, stateType: AbilityState): Promise>

查詢輔助應用列表。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Core

• 參數：

  參數名	參數類型	必填	說明
  abilityType	[AbilityType]	是	輔助應用的類型。
  stateType	[AbilityState]	是	輔助應用的狀態。

• 返回值：

  類型	說明
  Promise>	返回輔助應用信息列表。

• 示例

  accessibility.getAbilityLists("spoken", "enable")
      .then((data) = > {
          console.info('success data:getAbilityList1 : ' + JSON.stringify(data));
          for (let item of data) {
              console.info(item.id);
              console.info(item.name);
              console.info(item.description);
              console.info(item.abilityTypes);
              console.info(item.eventTypes);
              console.info(item.capabilities);
              console.info(item.packageName);
              console.info(item.filterBundleNames);
              console.info(item.bundleName);
          }
      }).catch((error) = > {
          console.error('failed to  getAbilityList1 because ' + JSON.stringify(error));
      })
  

accessibility.getAbilityLists

getAbilityLists(abilityType: AbilityType, stateType: AbilityState,callback: AsyncCallback>): void

查詢輔助應用列表。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Core

• 參數：

  參數名	參數類型	必填	說明
  abilityType	[AbilityType]	是	輔助應用的類型。
  stateType	[AbilityState]	是	輔助應用的狀態。
  callback	AsyncCallback>	是	回調函數，返回輔助應用信息列表。

• 示例

  accessibility.getAbilityLists("visual", "enable", (err, data) = > {
      if (err) {
          console.error('failed to getAbilityList2 because ' + JSON.stringify(err));
          return;
      }
      console.info('success data:getAbilityList2 : ' + JSON.stringify(data));
      for (let item of data) {
          console.info(item.id);
          console.info(item.name);
          console.info(item.description);
          console.info(item.abilityTypes);
          console.info(item.eventTypes);
          console.info(item.capabilities);
          console.info(item.packageName);
          console.info(item.filterBundleNames);
          console.info(item.bundleName);
      }
  })
  

accessibility.getCaptionsManager8+

getCaptionsManager(): CaptionsManager

獲取無障礙字幕配置。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Hearing

• 返回值：

  類型	說明
  [CaptionsManager]	無障礙字幕配置管理。

• 示例

  captionsManager = accessibility.getCaptionsManager()
  

accessibility.on('accessibilityStateChange' | 'touchGuideStateChange')

on(type: 'accessibilityStateChange' | 'touchGuideStateChange', callback: Callback): void

啟用輔助應用和觸摸瀏覽功能的狀態變化監聽。

系統能力 ：以下各項對應的系統能力有所不同，詳見下表。

• 參數：

  參數名	參數類型	必填	說明
  type	string	是	監聽的事件類型。 - type 為'accessibilityStateChange'時表示監聽類型為輔助功能啟用狀態變化監聽； 系統能力 ：SystemCapability.Barrierfree.Accessibility.Core - type 為'touchGuideStateChange'時表示監聽類型為觸摸瀏覽啟用狀態變化監聽。 系統能力 ：SystemCapability.Barrierfree.Accessibility.Vision
  callback	Callback	是	回調函數，在啟用狀態變化時將狀態通過此函數進行通知。

• 示例

  accessibility.on('accessibilityStateChange',(data) = > { 
      console.info('success data:subscribeStateObserver : ' + JSON.stringify(data))
  })
  

accessibility.off('accessibilityStateChange' | 'touchGuideStateChange')

off(type: ‘accessibilityStateChange ’ | ‘touchGuideStateChange’, callback?: Callback): void

關閉輔助應用和觸摸瀏覽功能的狀態變化監聽。

系統能力 ：以下各項對應的系統能力有所不同，詳見下表。

• 參數：

  參數名	參數類型	必填	說明
  type	string	否	監聽的事件類型。 - type 為'accessibilityStateChange'時表示監聽類型為輔助功能啟用狀態變化監聽； 系統能力 ：SystemCapability.Barrierfree.Accessibility.Core - type 為'touchGuideStateChange'時表示監聽類型為觸摸瀏覽啟用狀態變化監聽。 系統能力 ：SystemCapability.Barrierfree.Accessibility.Vision
  callback	Callback	否	要取消的監聽回調函數。

• 示例

  accessibility.off('accessibilityStateChange',(data) = > {
      console.info('success data:unSubscribeStateObserver : ' + JSON.stringify(data))
  })
  

accessibility.isOpenAccessibility

isOpenAccessibility(): Promise

判斷是否啟用了輔助功能。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Core

• 返回值：

  類型	說明
  Promise	如果輔助功能已啟用，則返回 true；否則返回 false。

• 示例

  accessibility.isOpenAccessibility()
      .then((data) = > {
          console.info('success data:isOpenAccessibility : ' + JSON.stringify(data))
      }).catch((error) = > {
          console.error('failed to  isOpenAccessibility because ' + JSON.stringify(error));
      })
  

accessibility.isOpenAccessibility

isOpenAccessibility(callback: AsyncCallback): void

判斷是否啟用了輔助功能。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Core

• 參數

  參數名	參數類型	必填	說明
  callback	AsyncCallback	是	回調函數，如果輔助功能已啟用，則返回 true；否則返回 false。

• 示例

  accessibility.isOpenAccessibility((err, data) = > {
      if (err) {
          console.error('failed to isOpenAccessibility because ' + JSON.stringify(err));
          return;
      }
      console.info('success data:isOpenAccessibility : ' + JSON.stringify(data))
  })
  

accessibility.isOpenTouchGuide

isOpenTouchGuide(): Promise

判斷觸摸瀏覽模式是否開啟。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Core

• 返回值：

  類型	說明
  Promise	如果觸摸瀏覽模式已開啟，則返回 true；否則返回 false。

• 示例

  accessibility.isOpenTouchGuide()
      .then((data) = > {
          console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data))
      }).catch((error) = > {
          console.error('failed to  isOpenTouchGuide because ' + JSON.stringify(error));
      })
  

accessibility.isOpenTouchGuide

isOpenTouchGuide(callback: AsyncCallback): void

判斷觸摸瀏覽模式是否開啟。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Core

• 參數

  參數名	參數類型	必填	說明
  callback	AsyncCallback	是	回調函數，如果觸摸瀏覽模式已開啟，則返回 true；否則返回 false。

• 示例

  accessibility.isOpenTouchGuide((err, data) = > {
      if (err) {
          console.error('failed to isOpenTouchGuide because ' + JSON.stringify(err));
          return;
      }
      console.info('success data:isOpenTouchGuide : ' + JSON.stringify(data))
  })
  

accessibility.sendEvent

sendEvent(event: EventInfo): Promise

發送無障礙事件。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Core

• 參數：

  參數名	參數類型	必填	說明
  event	[EventInfo]	是	無障礙事件對象。

• 返回值：

  類型	說明
  Promise	以 Promise 形式返回結果，如果發送無障礙事件成功，則 data 有數據返回；如果發送無障礙事件失敗，則 err 有數據返回。

• 示例

  accessibility.sendEvent(this.eventInfo)
      .then((data) = > {
          console.info('success data:sendEvent : ' + JSON.stringify(data))
      }).catch((error) = > {
          console.error('failed to  sendEvent because ' + JSON.stringify(error));
      })
  

accessibility.sendEvent

sendEvent(event: EventInfo, callback: AsyncCallback): void

發送無障礙事件。

系統能力 ：SystemCapability.Barrierfree.Accessibility.Core

• 參數：

  參數名	參數類型	必填	說明
  event	[EventInfo]	是	輔助事件對象。
  callback	AsyncCallback	是	回調函數，如果發送無障礙事件成功，則 AsyncCallback 中 data 有數據返回；如果發送無障礙事件失敗，則 AsyncCallback 中 err 有數據返回。HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿

  

• 示例

  accessibility.sendEvent(this.eventInfo,(err, data) = > {
      if (err) {
          console.error('failed to sendEvent because ' + JSON.stringify(err));
          return;
      }   
      console.info('success data:sendEvent : ' + JSON.stringify(data))
  })