提交 5459844d 编写于 作者: DCloud_iOS_WZT's avatar DCloud_iOS_WZT

docs: get-univerify-manager.md

上级 a827db69
......@@ -4,24 +4,24 @@
<!-- UTSAPIJSON.getUniverifyManager.compatibility -->
App一键登陆,封装了个推的一键登陆sdk,其内部再次封装了中国三大电信运营商提供的sdk。通过运营商提供的服务,可以在手机sim卡信号正常的情况下,通过云端接口获取到当前用户的手机号。
App一键登录,封装了个推的一键登录sdk,其内部再次封装了中国三大电信运营商提供的sdk。通过运营商提供的服务,可以在手机sim卡信号正常的情况下,通过云端接口获取到当前用户的手机号。
使用一键登可以点一下直接以当前手机号登录。不再需要短信验证码,而且费用比短信验证码便宜。
使用一键登可以点一下直接以当前手机号登录。不再需要短信验证码,而且费用比短信验证码便宜。
App一键登的优势:
App一键登的优势:
1. 对比短信验证码登录
- 对开发者而言每条短信费用更贵、短信模板审核慢、短信发送成功可能几十秒;
- 对用户而言,输入手机号耗时、等待耗时、输入验证码耗时,等待体验差。
2. 对比微信登录
- 中国法律要求开发者了解客户的真实信息。与其微信登录后再次要求用户输入短信验证码,不如直接一键登
- 在iOS上,一旦使用微信登录,就必须同时加入Apple登录。Apple登录的用户无法再次有效触达,只能再次要求用户输入短信验证码绑定手机号,体验非常差。不如直接一键登陆。使用一键登陆时Appstore不会要求必须同时使用Apple登录。
- 中国法律要求开发者了解客户的真实信息。与其微信登录后再次要求用户输入短信验证码,不如直接一键登
- 在iOS上,一旦使用微信登录,就必须同时加入Apple登录。Apple登录的用户无法再次有效触达,只能再次要求用户输入短信验证码绑定手机号,体验非常差。不如直接一键登录。使用一键登录时Appstore不会要求必须同时使用Apple登录。
一键登涉及业务开通和付费,因为安全问题又涉及客户端和服务器交互,有较多文档:
一键登涉及业务开通和付费,因为安全问题又涉及客户端和服务器交互,有较多文档:
1. 业务介绍:介绍业务流程、开通和付费。[详见](https://uniapp.dcloud.net.cn/univerify.html)
2. 客户端API,即本文
3. 服务器API,[详见](https://doc.dcloud.net.cn/uniCloud/uni-login/dev.html)
uni-id-pages插件,已经内置一键登,从云端到客户端均已开发好并开源,推荐使用。[详情](https://doc.dcloud.net.cn/uniCloud/uni-id/app-x.html)
uni-id-pages插件,已经内置一键登,从云端到客户端均已开发好并开源,推荐使用。[详情](https://doc.dcloud.net.cn/uniCloud/uni-id/app-x.html)
<!-- UTSAPIJSON.getUniverifyManager.param -->
......@@ -31,9 +31,9 @@ uni-id-pages插件,已经内置一键登陆,从云端到客户端均已开
## cause个推sdk错误码及运营商错误码汇总
上述API不管是预登还是登录,失败时返回的uni Error错误对象,有一个属性cause,它表示底层的错误来源,这里包含了个推的个验sdk和运营商sdk的详细信息。比如没有sim卡或未开启蜂窝网络。
上述API不管是预登还是登录,失败时返回的uni Error错误对象,有一个属性cause,它表示底层的错误来源,这里包含了个推的个验sdk和运营商sdk的详细信息。比如没有sim卡或未开启蜂窝网络。
在大多数情况下,开发者需要把这些更为详细的错误提示给用户,以引导用户正确使用一键登
在大多数情况下,开发者需要把这些更为详细的错误提示给用户,以引导用户正确使用一键登
### 个推sdk错误码 @getui-error-code
......@@ -209,11 +209,15 @@ uni-id-pages插件,已经内置一键登陆,从云端到客户端均已开
| 80800 | WIFI切换异常 |
| 80801 | WIFI切换超时 |
## Tips
- 运营商对一键登陆给用户呈现的ui有强制要求:必须有运营商的隐私协议和服务条款、不得默认勾选同意、手机号掩码显示、需要用户手动再点按钮获取而不能自动获取。
- 目前一键登陆的UI可自定义性有限。仅支持配置登录页全屏/半屏、登录页背景色、登录按钮文案以及登录页logo。后续会继续扩展自定义性。
- 一键登陆并非100%成功,手机没有sim卡、蜂窝网络未开启、当时手机没有蜂窝网信号是最常见的原因,更多错误见上方的错误码列表。在一键登陆无法使用时,可转为短信验证码登录。在uni-id-pages里已经集成了相关逻辑,无需自己开发。[详情](https://doc.dcloud.net.cn/uniCloud/uni-id/app-x.html)
- 一键登陆支持标准基座真机运行,涉及费用扣除开发者的费用。无需自定义基座。
- 页面必要元素有:号码栏(NumberText),品牌露出(SloganText),登录按钮(LoginButton),隐私确认(PrivacyCheckbox),隐私标题(PrivacyText)。
- 开发者不得通过任何技术手段将上述授权页面的必要元素内容隐藏、覆盖、或者动态变更。
- 登录按钮文字描述必须包含“登录”或“注册”等文字,不得诱导用户授权。
- 不得默认勾选同意、需要用户手动点击按钮获取手机号不能自动获取手机号。
- 对于接入一键登录并上线的应用,运营商会对上线的应用授权页面做审查,如果有出现未按要求弹出或设计授权页面的,将关闭应用的认证取号服务。
- 一键登录并非100%成功,手机没有sim卡、蜂窝网络未开启、当时手机没有蜂窝网信号是最常见的原因,更多错误见上方的错误码列表。在一键登录无法使用时,可转为短信验证码登录。在uni-id-pages里已经集成了相关逻辑,无需自己开发。[详情](https://doc.dcloud.net.cn/uniCloud/uni-id/app-x.html)
- 一键登录支持标准基座真机运行,涉及费用扣除开发者的费用。无需自定义基座。
<!-- UTSAPIJSON.getUniverifyManager.example -->
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册