写点什么

《HarmonyOSNext 极速开发指南:5 大 Account Kit 能力一键集成,用户信息秒级获取!》

作者:Turing_010
  • 2025-06-28
    广东
  • 本文字数:1895 字

    阅读完需:约 6 分钟

《HarmonyOSNext极速开发指南:5大Account Kit能力一键集成,用户信息秒级获取!》

《HarmonyOSNext 极速开发指南:5 大 Account Kit 能力一键集成,用户信息秒级获取!》


##Harmony OS Next ##Ark Ts ##教育


本文适用于教育科普行业进行学习,有错误之处请指出我会修改。



🚀 一键搞定用户信息!Account Kit 超全能力指南

无需手动填写! 用华为 Account Kit 快速获取头像/昵称/手机号/地址/发票,用户体验直接起飞~ ✨



一、📸 头像昵称秒级获取(超实用!)

适用场景:用户首次登录时,自动拉取华为账号头像昵称,告别手动上传!

🔄 业务流程(3 步极简!)

graph TDA[调用授权API] --> B{已授权?}B -->|Yes| C[直接获取数据]B -->|No| D[拉起授权页]D --> E[用户确认授权]E --> C
复制代码

⚙️ 核心接口三件套

⚠️ 避坑指南

🚫 未设置昵称时:默认返回华为账号绑定的匿名手机号/邮箱🔥 ​​必看错误码​​:1001500001(证书校验失败 = 公钥指纹未配好!)



二、🛠️ 客户端开发四步曲(附完整代码!)

Step 1️⃣ 导入模块

import { authentication } from '@kit.AccountKit'; import { hilog } from '@kit.PerformanceAnalysisKit';import { util } from '@kit.ArkTS'; import { BusinessError } from '@kit.BasicServicesKit';
复制代码

Step 2️⃣ 配置授权参数

const authRequest = new authentication.HuaweiIDProvider()  .createAuthorizationWithHuaweiIDRequest();
// ✅ 关键配置authRequest.scopes = ['profile']; // 必须声明profile作用域authRequest.permissions = ['serviceauthcode']; // 需要Authorization Code时添加authRequest.forceAuthorization = true; // 强制拉起授权页authRequest.state = util.generateRandomUUID(); // 防CSRF攻击
复制代码

Step 3️⃣ 执行授权请求

try {  const controller = new authentication.AuthenticationController(    this.getUIContext().getHostContext()  );    controller.executeRequest(authRequest)    .then((data) => {      const res = data as authentication.AuthorizationWithHuaweiIDResponse;            // ✅ 解析关键数据      const avatarUri = res?.data?.avatarUri;     // 头像URL      const nickName = res?.data?.nickName;       // 用户昵称      const authCode = res?.data?.authorizationCode; // 服务端凭证            // 💡 使用提示:头像需自行下载URL内容    })    .catch((error: BusinessError) => {...});} catch (error) {...}
复制代码

Step 4️⃣ 错误处理大全

dealAllError(error: BusinessError): void {  const errorMap = new Map([    [1001502001, "❌ 华为账号未登录!快去登录~"],      [1001502005, "🌐 网络开小差啦!检查网络重试"],     [1001502012, "⛔ 用户取消授权了哦"],      [12300001, "🔥 系统服务异常,请稍后再试"]  ]);    hilog.error(0x0000, 'testTag', `错误码: ${error.code}, 信息: ${error.message}`);  showToast(errorMap.get(error.code) || "未知错误,请联系客服"); // 对用户友好提示}
复制代码



三、📱 手机号快速验证(秒级认证!)

适用场景:注册/登录时自动获取用户手机号,省去短信验证码步骤!

🔍 特殊要求

+ 必须申请phone的scope权限!- 未申请会报错1001502014
复制代码

📝 配置差异点(vs 头像获取)

// 只需修改scopes参数!authRequest.scopes = ['phone']; // 其他配置与头像方案相同
复制代码

⚠️ 特别注意

🌟 首次授权后:后续可直接获取手机号(但需定期刷新凭证)📆 ​​时效性​​:该方案获取的是​​账号绑定手机号​​,非实时验证新号



四、📦 收货地址 / 发票抬头获取

🗺️ 收货地址流程

graph LRA[调用chooseAddress] --> B[打开地址管理页]B --> C{用户操作}C -->|新增地址| D[填写地址]C -->|选择已有| E[确认地址]D --> F[返回地址数据]E --> F
复制代码

🧾 发票抬头调用

invoiceAssistant.selectInvoiceTitle(context)  .then((data) => {    console.log("抬头发票号:" + data.taxNumber);   });
复制代码

🔒 权限申请速查表


📮 邮件模板:​​主题​​:【获取收货地址】权限申请​​正文​​:企业名称:xxx 应用包名:com.xxx.xxxAPP ID:123456​​5 个工作日内审核完毕​



💎 服务端开发关键点(拿小本本记好!)

🔑 Token 刷新机制

⚡ 最佳实践

# 刷新命令示例POST /oauth2/v3/token?grant_type=refresh_token&refresh_token=xxx
复制代码


💡 避坑口诀:Access Token 一小时,失效快用 Refresh 救 Refresh Token 半年寿,过期重走授权路



🎯 总结:5 大能力快速索引




最后叮咛 👇1️⃣ 所有客户端接口​​必须在页面生命周期内调用​​2️⃣ 遇到错误码1001500002?那是重复请求,直接忽略!3️⃣ 穿戴设备仅支持头像/手机号获取(地址发票不可用)

用户头像

Turing_010

关注

还未添加个人签名 2025-05-22 加入

还未添加个人简介

评论

发布
暂无评论
《HarmonyOSNext极速开发指南:5大Account Kit能力一键集成,用户信息秒级获取!》_Turing_010_InfoQ写作社区