鸿蒙开发者社区

一、总体流程二、具体执行本文主要参考鸿蒙官方网站材料

一、习惯推荐是HarmonyOS学习用户的行为习惯后做出的主动预测推荐。1.开发者将用户在应用元服务内的使用行为向HarmonyOS共享，使得HarmonyOS可以基于共享的数据学习用户的行为习惯。2.在HarmonyOS学习到用户的行为习惯后，会给用户推荐相应功能，并且尝试补充详细功能参数，减少用户执行任务的步骤。以听音乐为例，意图框架设计了统一的意图——播放歌单意图，该意图可以让应用元服务与HarmonyOS交互。当用户使用应用元服务播放...

意图框架向开发者提供真机测试能力，即开发者可连接设备进行调测。开发者完成代码开发之后，功能正式上架应用市场前，可以在HarmonyOSNEXT设备上面进行自验证，打磨体验。真机测试分为三个步骤：基础信息提供，环境准备，联调验证。一、基础信息提供达成开发意向后，开发者发送邮件到邮箱（hagservicehuawei.com）或者联系华为意图框架接口同事，向华为提供测试应用的信息。二、环境准备准备一台装有HarmonyOSNext版本的手机设...

一、方案概述当开发者有事件想要通知到用户时，可通过应用元服务的云侧服务器向智慧分发平台推送事件内容（意图共享）。系统通过智慧决策判断事件发生的条件，在满足条件时，向用户推荐事件提醒卡片，当用户点击卡片后，可跳转到应用元服务的详情页查看事件详情（意图调用）。二、流程图开发者获取云侧事件捐赠所需的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(...