跳到主要内容

概述

Account Kit提供了华为账号一键登录华为账号登录静默登录等多种登录方式,其中华为账号一键登录仅支持企业开发者使用,华为账号登录和静默登录既支持企业开发者也支持个人开发者使用,应用可根据实际场景选择使用其中一种或多种方式进行账号登录。

基础概念

华为账号用户身份标识包含UnionID和OpenID,具体格式要求请参考OpenID和UnionID的格式说明,注意OpenID和UnionID严格区分大小写。两者的定义与使用场景:

项目/ID类型UnionIDOpenID
定义UnionID是华为账号用户同一开发者账号下的唯一标识。开发者有多个HarmonyOS应用时,同一个开发者账号下的HarmonyOS应用获取到用户的UnionID相同。OpenID是华为账号用户在HarmonyOS应用的唯一标识。不同HarmonyOS应用(不管是否在同一个开发者账号下)获取到用户的OpenID不同。
使用场景在同一个开发者账号下标识用户的唯一性。建议使用UnionID在同一个应用下标识用户的唯一性。

在开发HarmonyOS应用时,您需要考虑同一用户在非HarmonyOS应用和HarmonyOS应用的用户数据是否互通。如果您之前使用OpenID来关联用户数据,我们建议将用户数据关系切换成UnionID,以确保用户使用HarmonyOS应用后可以继承老版本的用户数据。具体切换指导可以参考:通过OpenID获取UnionID

场景介绍

  • 获取手机号和UnionID登录,即华为账号一键登录

    若应用需要同时获取手机号和UnionID,推荐使用此场景,用户仅需一次点击操作,应用即可获取用户手机号和UnionID。应用获取到用户手机号和UnionID后,可同时通过手机号和UnionID与应用原有用户体系进行关联。本场景仅支持企业开发者使用,个人开发者请使用华为账号登录或静默登录方式。

  • 华为账号登录

    若应用只需要获取UnionID可以使用此场景。应用获取到用户UnionID后,可通过UnionID与应用原有用户体系进行关联

  • 静默登录

    在应用卸载重装、用户换机等场景,应用可通过Account Kit提供的静默登录方式即不需要用户点击登录/注册按钮,即可获取用户的身份标识UnionID,完成用户的静默登录。

  • 订阅华为账号登录/登出事件

    当应用需要跟随华为账号的登录状态进行登录登出时,可以通过订阅华为账号的登录登出事件进行判断。