Skip to Content
行为配置用户事件

用户事件

用户事件行为提供了完整的用户身份认证和账户管理功能,支持微信小程序和网页端的注册、登录、绑定、验证码等操作,为应用构建安全可靠的用户体系。

用户事件行为包括:

小程序端:

  1. 微信静默登录
  2. 获取用户微信头像/昵称
  3. 账户绑定/解绑
  4. 验证码发送/验证

网页端:

  1. 用户注册/登录
  2. 验证码管理
  3. 账户绑定/解绑
  4. 密码重置
  5. 登出/注销

小程序端用户事件

微信静默登录

作用

首次进入小程序时,通过【静默登录】行为获取 openid、unionid(如有),生成“游客身份”,并在 account 表插入用户数据。后续登录自动沿用该身份。

微信静默登录流程示意图

特殊说明

  1. 可直接使用【当前用户数据】引用当前用户。
  2. 静默登录以 openid/unionid 区分用户,unionid 需关注同主体公众号。
  3. 项目创建后默认全局添加该行为,无需手动配置。

静默登录行为全局配置示意图

获取用户微信头像/昵称

作用

获取微信用户头像和昵称,自动更新账户表。常用于小程序登录场景。

配置与输出

在组件交互中添加“用户事件-获取用户微信头像/昵称”行为,通常在成功时配置【刷新当前用户数据】行为。

选择行为配置成功时刷新线上效果
选择行为界面配置成功时刷新界面线上效果

特殊说明

  • 微信页面需选择邮箱和昵称后点击确认,才能获取头像和昵称。

绑定

作用

为账户添加手机号或邮箱并验证,增强安全性,便于找回密码或接收通知。绑定成功后更新账户表。

绑定行为流程示意图

配置与输出

  1. 按钮添加绑定行为,绑定输入手机号/邮箱的组件。
  2. 添加发送验证码按钮,验证码类型设为“绑定账号”。
绑定手机号绑定邮箱
绑定手机号界面绑定邮箱界面

解绑

作用

移除账户中已绑定的手机号或邮箱,常用于更换联系方式或不再使用某方式接收信息。解绑成功后账户表对应字段置空。

解绑行为流程示意图

配置与输出

按钮添加解绑行为,绑定输入验证码的组件。

  • 验证码类型设为“解绑账号”。
解绑手机号解绑邮箱
解绑手机号界面解绑邮箱界面

发送验证码

作用

向手机号或邮箱发送验证码,常用于注册、绑定、解绑、重置密码等场景。

选择行为发送方法绑定数据
选择行为界面发送方法界面绑定数据界面

配置与输出

  1. 邮箱/手机号通过输入组件获取,建议重命名组件。
  2. 发送成功/失败时配置【显示提示】行为。

1 分钟内仅可触发一次,重复点击会报错。

校验验证码

作用

校验用户输入的验证码是否正确,正确时执行后续行为,错误时提示。

使用方法:

  1. 添加校验验证码行为,选择发送方式,绑定手机号和验证码输入组件。
  2. 验证成功/失败时配置后续行为。
选择行为选择发送方式
选择行为界面选择发送方式界面

网页端用户事件

注册

作用

用户创建新账户,需填写基本信息(姓名、邮箱、手机号、密码等),可选邮箱/手机验证。支持用户名、手机号、邮箱三种注册方式。

用户名注册界面

配置与输出

按钮添加注册行为,绑定输入组件获取注册信息。

用户名注册手机号注册邮箱注册
用户名注册界面手机号注册界面邮箱注册界面

特殊说明

  1. 注册成功后,Zion 会自动插入账户数据并建立一对一关联。
  2. 注册成功/失败时建议配置【显示提示】行为。

登录

作用

已注册用户通过用户名、手机号、邮箱、验证码等方式登录应用。支持用户名、手机号验证码、手机号密码、邮箱、微信扫码、微信授权、企微登录等多种方式。

登录方式界面

配置与输出

按钮添加登录行为,绑定输入组件获取登录信息。

用户名登录手机号验证码登录手机号密码登录邮箱登录微信扫码登录
用户名登录界面手机号验证码登录界面手机号密码登录界面邮箱登录界面微信扫码登录界面
微信登录前置条件
  1. 登录设置中开启微信登录并填写 App-ID、App-Secret。
  2. App-ID、App-Secret 获取方式:
    • 微信扫码登录:微信·开放平台 注册账号,创建网站应用,获取 App-ID、App-Secret,配置授权回调域:https://zionbackend.functorz.com/
    • 微信授权登录:微信·公众平台 注册公众号(服务号且认证),开发配置获取 App-ID、App-Secret,功能设置中配置网页授权域名为 Zion 网页端发布域名,要求下载的校验文件可上传至网页端全局设置-上传文件至根目录。

登录成功/失败时建议配置【显示提示】或跳转行为。

Web 端与小程序端的账号联通

在 Web 端使用“微信扫码登录”时,打开“跨客户端启用微信身份关联”开关,即可实现 Web 端与小程序端的账号联通。

其原理是扫码登录时通过微信的 Union ID 查找是否已经存在该微信账号,如果存在,则使用该账号登录;否则,创建新账号。

验证码

作用

敏感操作时向用户发送一次性验证码,增强账户安全。

验证码发送界面

配置与输出

按钮添加发送验证码行为,绑定输入组件获取手机号或邮箱。

验证码配置与输出界面

绑定

作用

为账户添加手机号或邮箱并验证,增强安全性。

绑定行为界面

配置与输出

按钮添加绑定行为,绑定输入组件获取手机号或邮箱。

  • 验证码类型设为“绑定账号”。
绑定手机号绑定邮箱
绑定手机号界面绑定邮箱界面

解绑

作用

移除账户中已绑定的手机号或邮箱。

解绑行为界面

配置与输出

按钮添加解绑行为,绑定输入组件获取验证码。

  • 验证码类型设为“解绑账号”。
解绑手机号解绑邮箱
解绑手机号界面解绑邮箱界面

重置密码

作用

用户忘记密码时通过已绑定手机号或邮箱重置密码,需先验证身份。

重置密码界面

配置与输出

按钮添加重置行为,绑定输入组件获取手机号、新密码、验证码。

手机号重置密码邮箱重置密码
手机号重置密码界面邮箱重置密码界面

登出

作用

用户主动退出应用,结束当前登录会话,保护个人信息安全。

选择行为线上效果
登出行为界面登出线上效果

注销

作用

用户永久删除账户及数据,分验证码注销和密码注销两种方式。

  • 验证码类型设为“注销”。
验证码注销密码注销
验证码注销界面密码注销界面
Last updated on