用户事件
用户事件行为提供了完整的用户身份认证和账户管理功能,支持微信小程序和网页端的注册、登录、绑定、验证码等操作,为应用构建安全可靠的用户体系。
用户事件行为包括:
小程序端:
- 微信静默登录
- 获取用户微信头像/昵称
- 账户绑定/解绑
- 验证码发送/验证
网页端:
- 用户注册/登录
- 验证码管理
- 账户绑定/解绑
- 密码重置
- 登出/注销
小程序端用户事件
微信静默登录
作用
首次进入小程序时,通过【静默登录】行为获取 openid、unionid(如有),生成“游客身份”,并在 account 表插入用户数据。后续登录自动沿用该身份。
特殊说明
- 可直接使用【当前用户数据】引用当前用户。
- 静默登录以 openid/unionid 区分用户,unionid 需关注同主体公众号。
- 项目创建后默认全局添加该行为,无需手动配置。
获取用户微信头像/昵称
作用
获取微信用户头像和昵称,自动更新账户表。常用于小程序登录场景。
配置与输出
在组件交互中添加“用户事件-获取用户微信头像/昵称”行为,通常在成功时配置【刷新当前用户数据】行为。
选择行为 | 配置成功时刷新 | 线上效果 |
---|---|---|
![]() | ![]() | ![]() |
特殊说明
- 微信页面需选择邮箱和昵称后点击确认,才能获取头像和昵称。
绑定
作用
为账户添加手机号或邮箱并验证,增强安全性,便于找回密码或接收通知。绑定成功后更新账户表。
配置与输出
- 按钮添加绑定行为,绑定输入手机号/邮箱的组件。
- 添加发送验证码按钮,验证码类型设为“绑定账号”。
绑定手机号 | 绑定邮箱 |
---|---|
![]() | ![]() |
解绑
作用
移除账户中已绑定的手机号或邮箱,常用于更换联系方式或不再使用某方式接收信息。解绑成功后账户表对应字段置空。
配置与输出
按钮添加解绑行为,绑定输入验证码的组件。
- 验证码类型设为“解绑账号”。
解绑手机号 | 解绑邮箱 |
---|---|
![]() | ![]() |
发送验证码
作用
向手机号或邮箱发送验证码,常用于注册、绑定、解绑、重置密码等场景。
选择行为 | 发送方法 | 绑定数据 |
---|---|---|
![]() | ![]() | ![]() |
配置与输出
- 邮箱/手机号通过输入组件获取,建议重命名组件。
- 发送成功/失败时配置【显示提示】行为。
1 分钟内仅可触发一次,重复点击会报错。
校验验证码
作用
校验用户输入的验证码是否正确,正确时执行后续行为,错误时提示。
使用方法:
- 添加校验验证码行为,选择发送方式,绑定手机号和验证码输入组件。
- 验证成功/失败时配置后续行为。
选择行为 | 选择发送方式 |
---|---|
![]() | ![]() |
网页端用户事件
注册
作用
用户创建新账户,需填写基本信息(姓名、邮箱、手机号、密码等),可选邮箱/手机验证。支持用户名、手机号、邮箱三种注册方式。
配置与输出
按钮添加注册行为,绑定输入组件获取注册信息。
用户名注册 | 手机号注册 | 邮箱注册 |
---|---|---|
![]() | ![]() | ![]() |
特殊说明
- 注册成功后,Zion 会自动插入账户数据并建立一对一关联。
- 注册成功/失败时建议配置【显示提示】行为。
登录
作用
已注册用户通过用户名、手机号、邮箱、验证码等方式登录应用。支持用户名、手机号验证码、手机号密码、邮箱、微信扫码、微信授权、企微登录等多种方式。
配置与输出
按钮添加登录行为,绑定输入组件获取登录信息。
用户名登录 | 手机号验证码登录 | 手机号密码登录 | 邮箱登录 | 微信扫码登录 |
---|---|---|---|---|
![]() | ![]() | ![]() | ![]() | ![]() |
微信登录前置条件
- 登录设置中开启微信登录并填写 App-ID、App-Secret。
- App-ID、App-Secret 获取方式:
登录成功/失败时建议配置【显示提示】或跳转行为。
Web 端与小程序端的账号联通
在 Web 端使用“微信扫码登录”时,打开“跨客户端启用微信身份关联”开关,即可实现 Web 端与小程序端的账号联通。
其原理是扫码登录时通过微信的 Union ID 查找是否已经存在该微信账号,如果存在,则使用该账号登录;否则,创建新账号。
验证码
作用
敏感操作时向用户发送一次性验证码,增强账户安全。
配置与输出
按钮添加发送验证码行为,绑定输入组件获取手机号或邮箱。
绑定
作用
为账户添加手机号或邮箱并验证,增强安全性。
配置与输出
按钮添加绑定行为,绑定输入组件获取手机号或邮箱。
- 验证码类型设为“绑定账号”。
绑定手机号 | 绑定邮箱 |
---|---|
![]() | ![]() |
解绑
作用
移除账户中已绑定的手机号或邮箱。
配置与输出
按钮添加解绑行为,绑定输入组件获取验证码。
- 验证码类型设为“解绑账号”。
解绑手机号 | 解绑邮箱 |
---|---|
![]() | ![]() |
重置密码
作用
用户忘记密码时通过已绑定手机号或邮箱重置密码,需先验证身份。
配置与输出
按钮添加重置行为,绑定输入组件获取手机号、新密码、验证码。
手机号重置密码 | 邮箱重置密码 |
---|---|
![]() | ![]() |
登出
作用
用户主动退出应用,结束当前登录会话,保护个人信息安全。
选择行为 | 线上效果 |
---|---|
![]() | ![]() |
注销
作用
用户永久删除账户及数据,分验证码注销和密码注销两种方式。
- 验证码类型设为“注销”。
验证码注销 | 密码注销 |
---|---|
![]() | ![]() |