更新记录

1.0.0(2020-07-02)

初初发布,匆匆上架,多多包涵


云函数类插件通用教程

  1. 使用云函数类插件的前提是:使用HBuilderX 2.7+;已通过实名认证并开通了uniCloud。
  2. 如果下载的是完整项目,则需要在manifest.json的可视化界面获取appid。
  3. 需要对cloudfunctions目录点右键,绑定服务空间。如无服务空间,需先创建。建议在测试服务空间体验插件,避免对现网项目产生影响。
  4. 对cloudfunctions目录点右键上传所有云函数。在HBuilderX 2.7.8以前,如有common目录,还需单独对每个common目录下的公共模块上传。
  5. 如果cloudfunctions目录下有db_init.json,请点击右键,初始化云数据库。
  6. 通过以上步骤,完成uniCloud服务空间的初始化和云函数部署。然后就可以在HBuilderX的运行菜单里运行该项目,体验云端一体完整流程。

说明

  • HM-SmsCode 是一个发送验证码的云函数插件,一个插件聚合了阿里云,腾讯云,又拍云的短信接口。
  • 插件内置了流量控制,可以在插件内配置针对单一手机/IP/客户端发送验证码的数量限制。
  • 下载示例,你的很多疑问或得到答案。

使用说明

请先到/common/hm-config/index.js中配置好参数
配置文件里面有详细的注释,流量控制也在配置文件中配置,请下载组件查看
如果不会配置,或遇到问题bug,或有建议可以加入QQ群(147157269)咨询反馈
当然,也可以直接提问
如果觉得组件不错,给五星鼓励鼓励咯!

请求发送验证码

    uniCloud.callFunction({
        name: 'HM_sendcode',
        data:{
            type:"register",
            uuid:uuid,
            PhoneNumber:PhoneNumber
        }
    }).then((res) => {
        res = JSON.parse(res.result);
        if(res.ret==0){
            uni.showToast({title: '验证码已发送',icon:"none"});
        }else{
            //发送失败
            uni.showToast({title: res.msg,icon:"none"});
            console.error(res)
        }
    }).catch((err) => {
        uni.showToast({title: '请求失败',icon:"none"});
        console.error(err)
    })

检测验证码是否正确

    uniCloud.callFunction({
        name: 'HM_checkcode',
        data:{
            type:"register",
            PhoneNumber:PhoneNumber,
            code:code
        }
    }).then((res) => {
        res = JSON.parse(res.result);
        if(res.ret==0){
            //验证码正确
        }else{
            //验证码错误 错误信息 res.msg
            console.log(res.msg);
        }
    }).catch((err) => {
        //请求失败
        console.error(err);
    })

云函数说明

HM_sendcode 请求验证码

参数
参数名 类型 说明
type String 必填,短信模板项,config中TemplateID的子键,例如示例中的register
PhoneNumber Number 必填,手机号码,短信验证码将发送到此手机号码,国内手机号码。
uuid String 选填,APP端可以传入UUID,云函数可配置针对客户端UUID限流
返回值
键名 类型 说明
ret int 状态码,状态码对应的错误信息,可以在组件内hm-print/index.jg内查看
msg String 请求接口信息。
moremsg String 更多信息,不一定会有,只有请求失败时候返回此信息

HM_sendcode 检查验证码

参数
参数名 类型 说明
type String 必填,短信模板项,config中TemplateID的子键,例如示例中的register
PhoneNumber Number 必填,接收到验证码的手机号码。
code String 必填,要检测的验证码
返回值
键名 类型 说明
ret int 状态码,状态码对应的错误信息,可以在组件内hm-print/index.jg内查看
msg String 请求接口信息。
moremsg String 更多信息,不一定会有,只有请求失败时候返回此信息

特别说明

检查验证码的type必须要和请求发送验证码的type相同,不相同这检查不通过
这样做能保证在不同地方请求到的验证码不通用
比如示例中:注册页面请求云函数的type是register,重置密码页面请求云函数的type是resetpwd, 就能保证注册页面请求的验证码不能用在重置密码中验证码通过。
且配置不同的type也对应了不同的短信模板,就像示例中,注册页面和重置密码页面发出的短信是不一样的。

传入数据格式等更多的说明请下载示例查看,有示例对照注释更容易明白。

偷偷的打广告

定制模板,开发uniapp、H5+APP、wap2app、PHP,付费咨询指导,有需要加QQ。

QQ:565766672 (刮刮卡)

使用组件中遇到BUG,也可以加我QQ反馈。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件会根据你的配置,在请求发送验证码时候,带上传入云函数的手机号去请求阿里/腾讯/又拍云短信服务接口。插件内引用了阿里云/腾讯相关nodejs SDK。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问