标签

为已登录用户添加、删除和确认标签。

备注

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

本模块的功能

为用户添加字符串标签，用于部署中的分类、Beta 版访问或功能开关。

适用场景：RainMaker 部署使用标签管理权限或过滤内容，而非设备/节点标签（参阅节点元数据）。

预期结果：调用 addTags 后标签生效，部分场景还需通过 OTP 调用 confirmTagAssignment 确认。

常见工作流

添加标签

await userInstance.addTags(["premium", "beta-tester"]);

删除标签

await userInstance.removeTags(["premium"]);

确认标签分配

await userInstance.confirmTagAssignment(verificationCode);

部分部署要求在调用 addTags 后通过 OTP 确认。

错误处理

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

最佳实践

1. 标签名称与 RainMaker 控制台配置保持一致
2. 在 UI 中确认标签：当平台发送验证码时
3. 标签变更后刷新权限：再据此控制功能访问

相关资源

• API 参考：
  • ESPRMUser