智能填充概述
======

智能填充服务提供场景化的输入建议，完善应用/元服务的系统开发能力，实现用户对复杂表单的一键填充，助力打造HarmonyOS极致输入效率。开发ArkUI输入组件后（[TextInput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textinput)、[TextArea](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textarea)以下统称输入组件），一行代码配置快速启用功能。

#### 约束与限制

智能填充支持Phone、Tablet设备，并且从5.1.0(18)版本开始，新增支持PC/2in1设备。

#### 申请接入智能填充服务

#### \[h2\]接入须知

*   智能填充服务仅提供给[已完成认证的企业开发者](https://developer.huawei.com/consumer/cn/doc/start/edrna-0000001062678489)使用。
    
*   智能填充支持的填充字段满足应用使用智能填充的业务场景需求。字段请参考[ContentType使用场景说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/scenario-fusion-intelligentfilling-appendix)。
    

#### \[h2\]接入操作

智能填充服务开放能力接入需要申请与审批，申请接入流程如下：

1.  请参考[创建HarmonyOS应用/元服务](https://developer.huawei.com/consumer/cn/doc/app/agc-help-createharmonyapp-0000001945392297)完成为HarmonyOS应用/元服务创建APP ID工作。
    
2.  登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)，选择“**开发与服务**”。
    
3.  选择应用后，在“开放能力管理”栏，找到智能填充服务的开放能力，点击右侧“申请”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/70/v3/IZeIIE0CQzqVp_5hNGpECQ/zh-cn_image_0000002594669444.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=35584FFBD8EDA57DD6E74376E96F8350EE61559DB268131AC1194672CCAD9A79)
    
4.  在“新建业务申请”窗口填写申请原因，选择上传附件，然后点击“提交”。
    
    *   申请原因：请详细描述使用**智能填充的具体场景**。（例如：\*\*\*应用是\*\*\*（应用简介），希望在\*\*\*场景中使用智能填充\*\*\*字段信息，以提升用户表单填写效率。）字段信息请参考[ContentType使用场景说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/scenario-fusion-intelligentfilling-appendix)。
    *   上传附件：提供接入智能填充场景的页面图片或视频。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b5/v3/rl3gaLqQR9uVmDJK0XGmSA/zh-cn_image_0000002594829372.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=CB5771B53974EB7EC6AAA0AFC5E214A5B3740F170BA3AA1C455FCAA8C9DAB994)
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/38/v3/qC3jkUC2SjiD8vSCjN_9Og/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=4638C0EDAF1A121E7C6391973DE6B2930347399E3A374795927F348255BA4537)
    
    请根据场景所需，申请必要的字段信息，并谨慎使用。若存在不合理使用的情况，我们将收回该服务授权。
    
5.  进入互动中心页面，可看到申请已提交的消息。
    
6.  返回“开放能力管理”页面，能力开关置灰，“申请”显示为“申请中”状态。
    
7.  申请审批通过后，互动中心将收到通知。至此，已成功接入智能填充服务。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/63/v3/5TGZ-FZZT7SlUo1PicQyfg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=BF5FD77934D9A090E0D1B03BB9B6E0E1AEF902DBF75DDD944957DD5922B43BAF)
    
    审批通过后，预计30分钟生效。
    

#### 前提条件

*   设备智能填充开关必须处于打开状态，请前往“设置 > 隐私和安全 > 智能填充”页面开启开关，页面中可查看“关于智能填充与隐私的声明”和“权限使用说明”。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f0/v3/675pOz_HQLii9hFhISWlrg/zh-cn_image_0000002625188819.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=4BF202FB473830C9E8505B91C0FADFF69CD140867A68F1F37292963FB94BC442)

*   应用/元服务的输入组件的[ContentType](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/scenario-fusion-intelligentfilling-appendix)属性配置对应场景，即可触发智能填充功能。
    
*   设备已连接互联网。
    

#### 表单智能填充

#### \[h2\]表单填充推荐场景

点击表单中任一配置了ContentType属性的输入组件，将在其下方弹窗展示推荐的填充数据，填充数据来源请参考[推荐数据源及推荐逻辑说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/scenario-fusion-intelligentfilling-explain)。

*   点击表单中ContentType为“PERSON\_FULL\_NAME”（姓名）或“PERSON\_LAST\_NAME”（姓氏）、“PERSON\_FIRST\_NAME”（名字）的输入组件时，将同时推荐表单中其他ContentType类型的数据（以下统称多输入框场景）。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/30/v3/Z-gCYAPDQcS5FTW2YK7CwA/zh-cn_image_0000002625108963.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=CF6BAB6214AF05D2B3C8FBEC5BB847D5162DEF3A8088EAD0E41F9CF5CEE385E3)

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ef/v3/W0WyODH4RsyRpDsqWsTTfQ/zh-cn_image_0000002594669446.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=8A2A29DE3B9F47969173680A56D73158DB2DB3CA1B94955385346AEE83DBE760)

*   点击其他ContentType的输入组件时，只会推荐对应场景数据。例如点击ContentType为“NICKNAME”（昵称）的输入组件时，仅会在弹窗中推荐昵称数据（以下统称单输入框场景）。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/70/v3/B9GyYcTXSU-iNF4hCVRHag/zh-cn_image_0000002594829374.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=F2C740088AA1BE1669E25D96C6B0BE9DD0DF990C73CFA46966C2E65639943C94)

*   表单中存在ContentType为“PERSON\_FULL\_NAME”（姓名）或“PERSON\_LAST\_NAME”（姓氏）、“PERSON\_FIRST\_NAME”（名字）的输入组件且其中已填入信息，在点击其他已配置ContentType的输入组件时，将根据已填入的姓名信息进行信息匹配推荐。例如姓名填写“张三”，点击“手机号码”输入组件仅推荐数据源中“张三”相关的信息。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/41/v3/CSnDIFEqSFWBKEgZE-dKog/zh-cn_image_0000002625188821.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=A7158928B60ED5A35D352C42FE5F4CB47D13E6BE716E210732DECE61691B87DE)

*   表单中存在ContentType为“PERSON\_FULL\_NAME”（姓名）或“PERSON\_LAST\_NAME”（姓氏）、“PERSON\_FIRST\_NAME”（名字）的输入组件且存在地址输入组件，在点击用户姓名类和地址信息类的ContentType输入组件时，若推荐的数据包含华为账号数据源的数据，且华为账号数据源的推荐数目少于推荐的华为账号收货地址数据时，可点击“更多地址”按钮拉起选择其他收货地址页面。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ee/v3/LxAZFhPgTuSAKmdeh_CXUg/zh-cn_image_0000002625108965.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=D14166872C672188A90CC4DDFB2B5A297D2DF104F9061A3689FB837A2534E2AD)

#### \[h2\]昵称填写推荐场景

当表单中需要昵称填写时，可从华为账号信息来源获取。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e3/v3/3buxuRPuRKK1CdQ-iN59GQ/zh-cn_image_0000002594829374.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=28142FE8EEFC268634366B5B9BD036D2E2F14C7EF8DEDE2B74C2134ECFEA9A96)

#### \[h2\]日程信息推荐场景

当表单中的输入组件仅配置了ContentType为“FORMAT\_ADDRESS”（全量地址）时，会从日程信息中获取2小时内的数据进行填充推荐。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/84/v3/xvVsEkVYQxykrDKJVlxfOA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=FC64B63AA3C4A907F4A9367475D8F9A529E27A23A18F3F57060185FE3D670034)

日程数据源推荐场景目前仅支持中文地址。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d3/v3/5VIfzcuoQtuHDUUMM4jJKw/zh-cn_image_0000002594669448.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=2702C2B8F83299D01C137A77C7245772DFB43108758CD7F5D99DA18B82DF198C)

#### \[h2\]联系人信息推荐场景

点击配置了ContentType为“PHONE\_NUMBER”（手机号）的输入组件时，若表单中存在ContentType为“PERSON\_FULL\_NAME”（姓名）或“PERSON\_LAST\_NAME”（姓氏）、“PERSON\_FIRST\_NAME”（名字）的输入组件且已填入信息，将根据其填入的信息来推荐联系人数据。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4b/v3/jcZWB6-aSwmXGyuZe8S_Ow/zh-cn_image_0000002594829376.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=AAE39E3527FDB4AB861FC6BEB7E3B45F60844D37B341B7DE8648A954B6875C96)

#### \[h2\]车牌信息推荐场景

从5.1.0(18)开始，支持智能填充的推荐车牌号场景。

当表单中需要车牌号填写时，可从历史表单输入数据源中获取机主本人的车牌信息。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b8/v3/g_0kwyQFTsWuXPofjRceOg/zh-cn_image_0000002625188823.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=68C7E0BB3945413FFEEC077AD0D20275AF8606C05D84FA53A71A0F7D864A920E)

#### \[h2\]护照信息推荐场景

从5.1.0(18)开始，支持智能填充的护照信息推荐场景。

表单中存在ContentType为“COUNTRY\_ADDRESS”（国籍）、“PASSPORT\_NUMBER”（护照号）、“VALIDITY”（有效期至）、“ISSUE\_AT”（签发地）的输入组件，在点击姓名类输入组件时，可从历史表单输入数据源中推荐护照信息。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d9/v3/AcSAlUZBSwiWahkgdQ1GaA/zh-cn_image_0000002625108967.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=1A30E56E1FBE35F2EBD99F631D923A3C9AFB6AEC1457D0003357E41629238D8E)

#### \[h2\]发票抬头推荐场景

从5.1.0(18)开始，支持智能填充的发票抬头推荐场景。

当表单中存在ContentType为“ORGANIZATION”（名称）和“TAX\_ID”（税号）时，点击名称框可从华为账号数据源获取数据进行主动推荐，或根据输入内容进行匹配推荐，名称单框不支持推荐；税号框则根据名称框内容进行匹配推荐，名称框为空则进行主动推荐，税号单框不支持匹配推荐。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/be/v3/tYvCAcRuRzy8ikPd-92RCA/zh-cn_image_0000002594669450.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=D7D5CE833C6738175D2535EEB318D307AD70D0DED693336DFE9C6C5FCF21A835)

#### 历史表单输入

保存在应用/元服务中填写的表单信息，用于后续表单填充推荐。

#### \[h2\]保存历史表单输入场景

填写表单信息时，表单中存在配置了ContentType属性的输入组件触发历史表单输入保存页面，选择“保存”后智能填充弹窗提示开通服务，开启智能填充开关后填写表单进行一键填充。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2b/v3/dOLsGH-1TliohjcYnGgBwA/zh-cn_image_0000002594829378.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=33F39F98D91DA4900666588BD96B73AB2786FE6ABA7E0F5537F45487D3D69996)

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b4/v3/RVAAy-WLTS6sngozkviKGA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=E6A0E2CB02C41E6C2A2B45885E9E6673C6CDDCA8D094A15DEB207B65AA01377C)

*   当使用智能填充功能的表单页面在切换或退出时，会自动触发[requestAutoSave](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-autofillmanager#autofillmanagerrequestautosave)接口进行历史表单输入保存请求，将弹出“保存至历史表单输入”页面。也可主动调用该接口触发历史表单输入保存。
    
*   “保存至历史表单输入”页面在点击“保存信息”按钮之后，若智能填充功能开关未打开，则弹出智能填充服务打开引导弹窗，点击“同意”按钮之后，智能填充开关会打开并将表单输入数据保存到历史表单输入中。
    
*   “保存至历史表单输入”页面在点击“忽略”按钮后，该应用24小时之内不会再次询问。该设备累计忽略5次后，页面中将显示“忽略后不再询问”勾选框，勾选之后点击“忽略”按钮，后续将不再询问。
    

#### \[h2\]更新已有历史表单输入记录

当表单中存在ContentType为“PERSON\_FULL\_NAME”（姓名）的输入组件时，且表单还存在其他任一配置了ContentType的输入组件，在触发保存时若历史表单输入记录中存在该姓名的记录且其他数据存在差异，则拉起页面提示“更新已有记录”或“保存为新记录”。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/81/v3/Gq1oHEcCRG64EkRWEtxiyw/zh-cn_image_0000002625188825.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=36BD30B84FF5F0E826739C205D751B10713FA82BE2B38F6D90701294C2B36228)

#### \[h2\]手动新增/修改历史表单输入场景

在智能填充页面或个人信息页面可以对历史表单输入进行管理。当历史表单输入中无数据，可点击“新增表单信息”进行新增；也可对已保存的信息进行修改或删除（当设备设置锁屏密码，进入历史表单输入时，需要输入锁屏密码）。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/68/v3/9Isx52o5QzG3tISJNEzZ_w/zh-cn_image_0000002625108969.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=4FE797D54E70EEB72386B34C0B6545BDF308D9F88DBEC7EA78CC1C8ACA4E00F5)

#### 云空间同步数据

同一华为账号下通过云空间实现数据上云保存，用于多设备数据同步。

#### \[h2\]云空间多设备同步数据场景

登录华为账号后“云空间服务 ”中 智能填充开关默认开启，可以实现多设备同步历史表单输入数据。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/39/v3/dkmRNcrHRZ2M0Gi0HNlmmg/zh-cn_image_0000002594669452.png?HW-CC-KV=V1&HW-CC-Date=20260612T073644Z&HW-CC-Expire=86400&HW-CC-Sign=079459FB583928C0B3B370A49C45FDF10D3BD4054233D122A32161E00830FD08)