意图标准协议上架指导
==========

该配置需开发者完成自测后，先将携有对应意图信息的App在AppGallery Connect（以下简称AGC）完成应用上架，具体操作步骤参见[应用开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/application-dev-overview)。

#### **意图注册配置操作步骤**

1.  账号登录：
    
    1.  通过“[华为开发者联盟](https://developer.huawei.com/consumer/cn/) > 管理中心 > 生态服务 > 智慧服务 > 小艺开放平台（原HarmonyOS服务开放平台） > 意图框架”，进入意图注册入口，需使用与应用上架相同的账号登录。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/76/v3/x7GdXL3-QbWkqIxc2VxNwA/zh-cn_image_0000002625109149.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=1EE21561BB5EE90C25BECF279DB2F7C5DA9D39106C73BAE62A610584A7A5AF62)
        
    2.  点击“立即体验”即可进入意图注册入口。
        
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b6/v3/y1e1tScORimG5LkPlaI7ZQ/zh-cn_image_0000002594669632.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=3EC36A384FE6E14CED9465DDB046692901CB1862EF71F756A4D9CE995A18C80E)
    
2.  选择意图集：在“小艺开放平台”首页“意图集（插件）”中，携有意图声明文件的应用在AGC**正式上架**后可**自动生成**一条草稿态的记录，记录中包含开发者在意图配置文件中声明的所有**端侧意图**（云侧意图需手动新增，见下图）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ee/v3/Uf4QGP8TRmiRow2DgP-IOg/zh-cn_image_0000002625189015.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=E3E567A58D42921B2F977A09CECC83F480FE69031EC622A8AFD1A4055BD008AE)
    
3.  基本信息编辑：点击对应的意图集记录的“编辑”按钮，进入基本信息编辑页面，开发者补充完基本信息后点击“保存”即可。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c7/v3/8qVZ33FvS32KEhLN_yMQIg/zh-cn_image_0000002625109159.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=C7D9EBFF971FC7A95786D7290DE03067A8AD7488DE2FEAD41410C55438F92125)
    
    此处的版本号和版本描述为智慧分发配置的版本信息，用于开发者记录和识别智慧分发配置版本变更，与APP软件包版本无关，意图注册名称与APP名称保持一致。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cc/v3/JHdOSKh5S6iKP8tG5p9PuA/zh-cn_image_0000002594669642.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=A8BA00EC2E65A9EB2CB3DAEFDF5BF14496F39A9499521E29CDA75171CEE53D89)
    
4.  意图检查：切换至“意图”页签，点击“保存”会触发刷新，需检查接入特性所依赖的全量意图是否在此页面都已列出，同时打开意图使用样本中“是否已提供线下样本”开关。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f2/v3/0ADeLIIQT722wKSWQFn3kQ/zh-cn_image_0000002594829570.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=FD887BA7295EA300EE33AE36EAB679AF6DFB694B1FA0DEF4FF86C32180EE4E58)
    
    1.  其中，“端云类型”涉及端的意图需在APP软件包中定义，此处会自动呈现。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/36/v3/M4UfcY9jQzS8C6TMyKbWqg/zh-cn_image_0000002625189017.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=F578D125ADA2404B1DF96C92D92E00E99648B1F898B5FC3CD83633979891720F)
        
    2.  “端云类型”仅涉及云的意图需要需手动添加该意图。可参照如下步骤配置：
        
        1.  点击添加进行意图新增。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/91/v3/GO-66y8wTl-tC6kOOGowIQ/zh-cn_image_0000002625109161.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=3C6FA39B7B1768EF4B8411276DCAF207B81FADB80D644C4A6E092258BC0F1F37)
            
        2.  选择云侧意图分类，搜索意图名称，勾选所需意图进行添加（若没有找到对应意图可联系华为工程师，检查是否未配置该意图）。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0/v3/w2Sehl7mSFO4wDz0HClQIg/zh-cn_image_0000002594669644.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=680892566AD740DF3E2B3800F0B3EE9B1DC2F3BE0621285366EDC394BD61B0C9)
            
        3.  添加完成后，需录入接口信息配置，具体信息如下：
            
            1.  API：即开发者的URL地址信息，供华为侧服务器进行云侧意图调用。
            2.  认证方式：如果涉及接口鉴权，则选择认证方式（例如AK/SK认证）并配置密钥信息；如果不涉及则选择不认证。
            3.  个人数据授权：该信息是指华为侧服务器携带对应信息访问开发者服务器，当有个性化推荐诉求时需要填写，默认不填写；比如选中“用户授权的用户唯一标识”（即SID），则华为侧服务器访问开发者服务器时会携带SID，开发者服务器则可以识别用户返回个性化的数据用户推荐展示。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/14/v3/l6REXODsT32qNBZK3FpsiA/zh-cn_image_0000002594829572.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=796E76F0EFFC5233A0BD4E2F5F3B3CD69DD6FC3027493C6D1C6B8E0911FE3978)
            
    3.  如仍未全部列出，检查软件包中意图注册配置文件是否漏配，若漏配则在意图配置文件中补充配置，并重新在AGC进行应用上架/升级，完成后在小艺开放平台进行意图注册。
        
    4.  如果提示声明意图不存在，则说明华为意图框架后台未配置该意图。开发者可以继续点击保存走完本次流程，但相应意图和关联特性不会生效；可联系华为工程师，检查是否未配置该意图。
        
5.  检查完成：如果特性依赖的所有意图都已列出，检查意图名称、意图调用配置和意图共享配置等是否正确，正确则点击“保存”，进入下一步。
    
6.  发布选择“发布”页签，进入配置检查页面。
    
    1.  点击“开始检查”，检查接入特性和其关联的意图是否正确，如下图所示。生成特性时会同时生成abilityId，若开发者接入特性的方案涉及此参数，则事件推荐请求字段abilityId参数需要填写当前界面的abilityId值。若提示特性undefined，则联系华为工程师，检查是否未配置该特性。
    2.  配置检查完成后点击“提交审核”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/27/v3/7VVJ-3Y3SjqvL65eWZX2PQ/zh-cn_image_0000002625189019.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=FA85DB4231E62876CDF3DB8CA4929559EAE01ED91523FE649BD8F545F91E028D)
    
7.  审核：提交审核后，在“小艺开放平台> 意图集”中，该条记录状态变为“上架审核中”，一般审核周期为3-5个工作日，审核通过后状态变为“已上架”，至此意图注册及特性选择已完成。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fa/v3/idMa63MRQaa8dgRhT36r3A/zh-cn_image_0000002625109163.png?HW-CC-KV=V1&HW-CC-Date=20260612T073803Z&HW-CC-Expire=86400&HW-CC-Sign=E2FAC1EA57D0194630717EA966E640E1A3753140DDC6EC5CC369F3EB1E55BA97)
    
8.  新增意图：若开发者有新意图上架，可在同一条记录上进行编辑后提交，操作流程同上述步骤，未提交审核不影响已经注册的意图。