[HarmonyOS Next示例代码] 鸿蒙 - 基于原生能力的无障碍模式

xiaohai_09

已于 2024-08-18 16:59:42 修改

阅读量442

点赞数 19

文章标签： harmonyos 鸿蒙

于 2024-08-18 12:20:59 首次发布

本文链接：https://blog.csdn.net/qq_23068089/article/details/141298071

版权

鸿蒙 - 基于原生能力的无障碍模式源码下载地址

介绍

本示例基于系统提供的无障碍阅读能力，实现了无障碍扩展服务集成、原生组件屏幕朗读以及多个控件组合标注。

效果图预览

原生组件屏幕朗读：

创建说明：

在已创建工程的ets文件夹下创建accessibility文件夹，在该文件夹下创建AccessibilityExtAbility.ets文件，可在该文件中实现一些回调函数，并加入业务处理逻辑的调用，具体可参考src/main/ets/accessibility/AccessibilityExtAbility.ets代码。
在已创建的accessibility文件夹下创建AccessibilityManager.ets文件，用于存放业务逻辑代码，可参考src/main/ets/accessibility/AccessibilityManager.ets进行实现。
在src/main/module.json5下新增扩展服务的配置信息，其中srcEntry标签为extensionAbility对应的路径。需要注意的一点是配置信息中的type标签要按照与无障碍子系统的约定进行配置，固定为accessibility，否则将无法正常连接。

"extensionAbilities": [
  {
    "name": "AccessibilityExtAbility",
    "srcEntry": "./ets/accessibility/AccessibilityExtAbility.ets",
    "label": "$string:MainAbility_label",
    "description": "$string:MainAbility_desc",
    "type": "accessibility",
    "metadata": [
      {
        "name": "ohos.accessibleability",
        "resource": "$profile:accessibility_config"
      }
    ]
  }
]

另外，配置信息中的accessibility_config为无障碍扩展服务的具体配置，需要在resources/base/profile/下新建accessibility_config.json文件，在该文件中声明此无障碍扩展服务具备的能力类型，根据业务功能合理声明能力类型，本案例中，需要如下声明:

{
  "accessibilityCapabilities": [
    "retrieve",
    "gesture",
    "touchGuide"
  ]
}

使用说明：

打开设置->辅助功能->屏幕朗读->屏幕朗读选项。
打开屏幕朗读后，关键手势如下:
1. 单击选择某个项目，双击确认选择。
2. 返回桌面及桌面切换等原有的单指操作都需要换成两指操作。
3. 下滑屏幕朗读下一项，上滑屏幕朗读上一项。
打开应用，下滑或上滑查看朗读情况。

工程目录

工程的目录结构

├──entry/src/main/ets                         // 代码区
│  ├──accessibility
│  │  ├──AccessibilityExtAbility.ets          // 无障碍扩展ability
│  │  └──AccessibilityManager.ets             // 无障碍扩展管理
│  ├──common
│  │  └──Constants.ets                        // 常量 
│  ├──entryability
│  │  └──EntryAbility.ets                     // EntryAbility
│  ├──pages
│  │  └──Index.ets                            // 组合标注sample页
│  ├──utils
│  │  └──Logger.ets                           // 日志工具类
│  ├──view
│  │  └──WeatherLine.ets                      // 天气行组件
│  └──viewmodel
│     └──WeatherViewModel.ets                 // 天气数据viewmodel
└──entry/src/main/resources                   // 应用资源目录

具体实现

使用原生组件时，即可自然支持无障碍能力，但是在一些场景中，一个功能上完整的UI对象可能是由若干个更小的UI组件组合而成的。若每一个小的UI组件都可以获焦并朗读，则会造成信息冗余和效率降低。同时由于可聚焦的组件过多过细，也会影响触摸浏览时走焦的性能体验。此时需要将多个控件设置为一个组，通过对组设置朗读标签，达到整组播报的效果。