用户资料

读取并更新资料字段，例如显示名称和电话号码。

备注

userInstance —— 在用户登录过程中获得的 ESPRMUser 实例。

本模块的功能

加载用户资料数据，并更新姓名或电话号码（电话号码需通过 OTP 确认）。

应用专属 JSON、地理坐标或时区请使用 自定义数据，不要写入内置资料字段。

预期结果：下次调用 getUserInfo() 时可以看到已更新的资料。

常见工作流

获取用户信息

const userInfo = await userInstance.getUserInfo();
const userInfoWithCustom = await userInstance.getUserInfo(true);

传入 true 可在同一次响应中包含自定义数据。

更新显示名称

await userInstance.updateName("John Doe");

设置电话号码（两步）

await userInstance.setPhoneNumber("+1234567890");
await userInstance.confirmPhoneNumber(verificationCode);

错误处理

try {
  await userInstance.confirmPhoneNumber(verificationCode);
} catch (error) {
  console.error("Phone confirmation failed:", error);
}

请先完成 setPhoneNumber，再用该步骤收到的 OTP 进行确认。

最佳实践

1. 刷新界面：在 updateName 或电话确认成功后
2. 谨慎使用 getUserInfo(true)：当自定义数据较大时
3. 先校验电话号码格式：再调用 setPhoneNumber

相关资源

• API 参考：
  • ESPRMUser
  • ESPRMUserInfo