diff --git a/docs/api/get-univerify-manager.md b/docs/api/get-univerify-manager.md index 1be98a7e331169d5f5b3bda2955dc2d1cbe47da4..e10b524bd1132b39214fb758aaf0c621cd778d04 100644 --- a/docs/api/get-univerify-manager.md +++ b/docs/api/get-univerify-manager.md @@ -4,24 +4,24 @@ -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) @@ -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) +- 一键登录支持标准基座真机运行,涉及费用扣除开发者的费用。无需自定义基座。