鸿蒙开发者社区

一、方案概述当开发者有事件想要通知到用户时，可通过应用元服务的云侧服务器向智慧分发平台推送事件内容（意图共享）。系统通过智慧决策判断事件发生的条件，在满足条件时，向用户推荐事件提醒卡片，当用户点击卡片后，可跳转到应用元服务的详情页查看事件详情（意图调用）。二、流程图开发者获取云侧事件捐赠所需的SID（ServiceOpenID）。当用户有订单事件后，开发者云将事件内容和SID同步到业务云。华为内部会根据事件和具体...

一、概述事件推荐是应用元服务有新的动态产生且满足推荐规则时给用户做出的主动推荐。实现事件推荐需要开发者将事件信息共享给意图框架，当满足事件推送规则时，会在小艺建议入口向指定用户推荐该事件提醒卡片，也支持通过对话或关键字搜索的方式查询事件内容状态。事件根据是否指定用户ID可分为两种：用户事件和公共事件。用户事件：由用户主动行为触发，根据用户标识对某一个指定用户ID单独进行推送或某一批指定用户ID批量进...

开发者完成开发者测试后需在小艺开放平台进行意图注册配置并提交审核，审核通过后完成意图的正式上线。意图注册配置之前，APP需要先在AppGalleryConnect（以下简称AGC）完成应用上架。意图注册配置操作步骤如下：通过“华为开发者联盟管理中心生态服务智慧服务小艺开放平台（原HarmonyOS服务开放平台）”，即可找到小艺开放平台入口，注意需使用与应用上架相同的账号登录。在“小艺开放平台”首页“我的意图注册记录”中可以自...

一、方案概述开发者需要按照意图定义，进行意图注册并实现意图调用；用户通过对小艺对话进行自然语言输入，小艺理解语义转换成意图调用（含意图参数），执行意图调用实现对应交互体验。端侧意图注册以“搜索旅游攻略”特性为例，开发者首先要注册“查看旅游攻略”（ViewTravelGuides）。开发者需要编辑对应的意图配置PROJECTHOMEentrysrcmainresourcesbaseprofileinsightintent.json文件，实现意图注册。{"insightIntents":[{"i...

一、概述技能调用是意图框架依托系统AI多模态大模型能力做深度用户输入理解，并通过解析的用户意图对接应用或元服务内的功能和内容。二、场景体验用户通过对小艺对话进行自然语言输入实现内容查询，知识问答，以及通过对图片选定识别问答进行服务获取。技能调用场景分为两种：功能服务类：端侧意图调用直接进入应用或元服务对应意图功能服务页面。信息交互类：云侧意图调用进行内容查询后展示，端侧用户点击进行意图调用闭环。...

一、方案概述当用户使用应用元服务时，开发者可以按照标准意图Schema向系统共享数据，并支持意图调用（空调用与传参调用），以实现用户点击卡片后，可后台执行功能（例如播放指定歌曲）或跳转至指定内容页面（例如指定的歌曲播放页面）。二、意图注册以歌曲本地搜索特性为例，首先要注册播放歌曲意图（PlayMusic）。开发者需要编辑对应的意图配置PROJECTHOMEentrysrcmainresourcesbaseprofileinsightintent.json文件，实现意图...

一、概述本地搜索是在HarmonyOS归一化搜索特性，开发者将应用元服务内的功能和内容通过意图框架共享到HarmonyOS，即可实现“一步搜索，内容直达”。二、典型场景以“音乐垂域”的“歌曲本地搜索”特性为例，当用户在使用音乐应用元服务产生行为时，应用元服务可以将音乐的数据通过意图框架API接口共享到HarmonyOS。这里的音乐数据可以是用户收听过的歌曲，也可以是应用元服务预测用户感兴趣的歌曲，那么后续用户在小艺搜索入口...

在一些场景中，一个功能上完整的UI对象可能是由若干个更小的UI组件组合而成的。若每一个小的UI组件都可以获焦并朗读，则会造成信息冗余和效率降低。同时由于可聚焦的组件过多过细，也会影响触摸浏览时走焦的性能体验。在这种情况下，将它们在功能或语义上聚合成一个自然组并作为一个独立可获焦的UI元素来向视障用户表达内容更加合理，且更加高效。总体原则是：对于表示同一个对象信息的多个组件，需要进行组合标注，对外只暴露...

适用场景：界面上重要内容在动态变化后，需要实时发送变化后的朗读内容说明：如果界面上内容发生动态变化且其内容对用户具有必要的提示告知指导作用，则其发生变化后需对其变化内容进行朗读，可调用无障碍提供的主动朗读接口进行播报。importaccessibilityfrom'ohos.accessibility';leteventInfo:accessibility.EventInfo({type:'announceForAccessibility',bundleName:'com.example.pagesrouter',triggerAction:'common',textA...

例如下图，播放暂停按钮对应着两种状态，在状态切换时需要实时变化对应的标注信息。importpromptfrom'system.prompt'constRESOURCESTRPLAY$r('app.media.play')constRESOURCESTRPAUSE$r('app.media.pause')ComponentexportstructRule2112{title:string'Rule2.1.12'StateisPlaying:booleantrueplay(){playaudiofile}pause(){pauseplayingofaudiofile}build(){NavDestination(){Column(){Flex({direction:FlexDirection.Column,al...

一、控件位置调整场景移动过程中需要实时播报即将移动到的位置，新位置的播报会打断老位置的播报，放置到确定位置后，需要再播报已经放置的位置信息，尽量保证视障用户耳朵听到的信息和我们通过眼睛看到的信息是一致的。例如，桌面图标被托起时，会播报已托起，移动的过程中，根据即将放置的位置播报“移至第几行，第几列”，放置后播报“已放至第几行，第几列”。应用可调用主动播报的接口来进行主动播报。二、重新设置新焦点...

装饰性的控件一般为分隔符、占位符和美化图标等，这类图形元素仅仅起到调整页面布局或装饰性效果，并不会向用户传达有效的信息或提供交互功能，删除后不影响指引用户体验。可以设置控件的无障碍是否可见的属性将其设置对无障碍不可见，这样在屏幕朗读模式下控件就不会获取焦点和朗读。accessibilityGroup(true)用于多个组件的组合，组合内的默认没有焦点。.accessibilityLevel("no")用于组件设置不可聚焦，不被无障碍感知。例如...

当对朗读内容进行标注时，须对标注字符串进行多语种翻译，具体支持的语种和应用本身界面支持的语种保持一致。若采用多个字符串进行朗读内容的拼接，需考虑多语种的情况，避免拼接后朗读错误，例如阿拉伯语从右到左。ComponentexportstructRule2116{title:string'Rule2.1.16'privatemultilingual:string'Itisconvenient:屏幕朗读已开启anduse'build(){NavDestination(){Column(){Flex({direction:FlexDirection.Column,alignItem...

当对朗读内容进行标注时，须对标注字符串进行多语种翻译，具体支持的语种和应用本身界面支持的语种保持一致。若采用多个字符串进行朗读内容的拼接，需考虑多语种的情况，避免拼接后朗读错误，例如阿拉伯语从右到左。ComponentexportstructRule2116{title:string'Rule2.1.16'privatemultilingual:string'Itisconvenient:屏幕朗读已开启anduse'build(){NavDestination(){Column(){Flex({direction:FlexDirection.Column,alignItem...

如果应用展示的是多维信息，还可能出现“嵌套组”的情况。在嵌套组中，应避免两个可获焦对象的功能或朗读内容产生重复。比如下图的天气卡片，时间和地点信息获取到焦点时，都是朗读的时间信息；不同焦点的重复朗读会额外增减用户的操作步骤，焦点控制杂乱，这些对同一个信息结构的完整描述应该统一标注在这几个子控件的父控件上。ComponentexportstructRule214{title:string'Rule2.1.4'build(){NavDestination(){Column(){Text(...

如下图，插画信息有一定提示作用，插画和对应的功能介绍应该组合在一起，当焦点落到插画或者包含插画的符合控件时，需要朗读出对应的功能描述。建议插画和功能介绍作为一个组合使用一个焦点朗读。它可以借助“accessibilityGroup(true)”属性来实现。ComponentexportstructRule217{title:string'Rule2.1.7'privatedescription:string'gestureswipeleftthenup'build(){NavDestination(){Column(){Flex({direction:FlexDirection....

如果应用展示的是多维信息，还可能出现“嵌套组”的情况。在嵌套组中，应避免两个可获焦对象的功能或朗读内容产生重复。比如下图的天气卡片，时间和地点信息获取到焦点时，都是朗读的时间信息；不同焦点的重复朗读会额外增减用户的操作步骤，焦点控制杂乱，这些对同一个信息结构的完整描述应该统一标注在这几个子控件的父控件上。ComponentexportstructRule214{title:string'Rule2.1.4'build(){NavDestination(){Column(){Text(...

控件包含显示文本（text）、无障碍文本（accessibilityText）2个属性，其中，显示文本为用户界面上呈现的信息，无障碍文本为无障碍专有的朗读信息，不在界面上显示。屏幕朗读提取信息进行朗读时无障碍文本的优先级大于显示文本，即当无障碍文本不为空时，会朗读无障碍文本，否则朗读显示文本。所以：对于文本类控件，尽量使用显示文本来表达信息，使视障用户和视力健全用户可以获取到相同的信息。对于文本类控件，如果除显示文...

对于用户可点击等操作的任何按钮，如果不是文本类控件，则须通过给出标注信息，包括用户自定义的控件中的虚拟按钮区域，否则可能会导致屏幕朗读用户无法完成对应的功能。此类控件在进行标注时，标注文本不要包含控件类型、“单指双击即可打开”之类的字符串，此部分指引由屏幕朗读根据控件类型、控件状态，并结合用户是否开启了“新手指引”自动追加朗读。在下面的代码片段中，您可以看到Image组件（它实际上是一个播放暂停按钮...

Accessibility（信息无障碍），是指任何人在任何情况下都能平等、方便地获取信息并利用信息。其目的是缩小全社会不同阶层、不同地区、不同年龄、不同健康状况的人群在信息理解、信息交互、信息利用方面的数字鸿沟，使其更加方便地参与社会生活，享受数字发展带来的便利。AccessibilityKit（无障碍服务）提供应用适配无障碍的开放能力，以便应用可以更好的服务于障碍人群和障碍场景，如为组件添加无障碍焦点、无障碍朗读文本等。...