wx.getPhoneMask
iOS >= 0.7.13 支持,Android >= 0.7.5 支持。
获取本机手机号掩码,展示在登录页。作为本机号码一键登录的前置步骤。(注意,本机号码一键登录将消费 wx.getPhoneMask 获得的上下文信息,使得该上下文信息失效。开发者如需再次调用本机号码一键登录,应重新调用 wx.getPhoneMask。)
注意事项
- 开发者需依据返回 operatorType 在登录页放置对应的运营商的隐私协议,需用户同意隐私协议之后方可使用一键获取手机号的功能,且不能设计成默认同意,必须是用户主动同意,否则会影响此功能的使用
- 电信,隐私协议文字名称:《天翼账号提供认证服务与隐私协议》,跳转地址:https://e.189.cn/sdk/agreement/show.do?order=2&type=main&appKey=&hidetop=true&returnUrl=
- 联通,隐私协议文字名称:《联通统一认证服务条款》,跳转地址:https://opencloud.wostore.cn/authz/resource/html/disclaimer.html?fromsdk=true
- 移动,隐私协议文字名称:《中国移动认证服务条款》,跳转地址:https://wap.cmpassport.com/resources/html/contract.html
- 授权页的文案建议为:已阅读同意《天翼账号提供认证服务与隐私协议》并授权XXX获取本机号码
- 此外,根据个保法最小收集要求为:产品隐私协议、运营商隐私协议为用户必须勾选项
- 开发者可依据 App 实际情况设计并放置相关的隐私协议,如:
前置流程
手机打开蜂窝网络。
补充:此接口需要依赖手机上打开蜂窝网络,因此不可在开发者工具或者模拟器上调试,需在手机上测试。
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数 |
object.success 回调函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
phoneMask | string | 手机号掩码:137**** 1234 |
operatorType | int | 运营商名称;1 表示移动,2 表示联通,3 表示电信 |
object.fail 回调函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
errCode | number | 错误码 |
errMsg | string | 错误提示 |
res.errCode
errCode | 说明 |
---|---|
-700000 | 前端错误,errMsg 将给出详细提示 |
示例代码
wx.getPhoneMask({
success (res) {
if (res.phoneMask) {
// 获取手机号掩码 res.phoneMask 成功,展示在登录页。
}
}
})