更新记录
1.0.1(2021-08-12)
初始提交
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 11.0 | armeabi-v7a:支持,arm64-v8a:支持,x86:支持 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
使用示例
var captcha = uni.requireNativePlugin('HXR-GoogleReCAPTCHA');
captcha.verifyWithSiteKey('your site key', (res) => {
console.log(JSON.stringify(res));
uni.showToast({
title:res.msg
})
})
回调说明
回调格式 {code:0, msg:''},当成功的时候,会多一个token,建议是拿到这个token后传给服务端拿去验证,验证接口说明见后文。
code说明:
- SAFE_BROWSING_UNSUPPORTED_THREAT_TYPES = 12000;
- SAFE_BROWSING_MISSING_API_KEY = 12001;
- SAFE_BROWSING_API_NOT_AVAILABLE = 12002;
- VERIFY_APPS_NOT_AVAILABLE = 12003;
- VERIFY_APPS_INTERNAL_ERROR = 12004;
- VERIFY_APPS_NOT_ENABLED = 12005;
- UNSUPPORTED_SDK_VERSION = 12006;
- RECAPTCHA_INVALID_SITEKEY = 12007;
- RECAPTCHA_INVALID_KEYTYPE = 12008;
- SAFE_BROWSING_API_NOT_INITIALIZED = 12009;
- OS_VERSION_NOT_SUPPORTED = 12010;
- INVALID_ADMIN_APPLICATION = 12011;
- SINGLE_USER_SERVICE_NOT_AVAILABLE = 12012;
- RECAPTCHA_INVALID_PACKAGE_NAME = 12013;
- SAFE_BROWSING_BLACKLIST_PARSE_ERROR = 12014;
- PACKAGE_WARNING_IN_PROGRESS = 12015;
- REMOVE_HARMFULAPP_ACTION_NOT_RESOLVED = 12017;
- APP_NOT_HARMFUL = 12018;
- OK = 0;表示成功,会返回一个token
- 99998;表示谷歌sdk没有返回token
- 99999;表示发生未知错误 更多错误码参考:SafetyNetStatusCodes
服务端验证接口
URL: https://www.google.com/recaptcha/api/siteverify <br/>
METHOD: POST <br/>
参数描述 <br/>
secret 必填. 就是你注册的时候的后面一个key(此密钥用于您的网站和 reCAPTCHA 之间的通信。)<br/>
response 必填. 就是插件返回给你的token <br/>
remoteip 可选. 用户的ip地址 <br/>
更多文档参考[Verifying the user's response](https://developers.google.com/recaptcha/docs/verify)
注册
打开注册链接,记得选择第2版,’隐形reCAPTCHA徽章, 在后台验证请求‘,成功之后有两个Key,第一个key是插件需要的sitekey,后一个key是服务器验证用的key
说明
该插件功能不保证所有安卓机型有效,可能涉及Google Play服务,出海应用可能更适合,请试用满意后购买。验证形式就是经常看到谷歌验证人机的形式,点图片那种。