# wx.getPhoneMask

iOS >= 0.7.13 支持，Android >= 0.7.5 支持。

获取本机手机号掩码，展示在登录页。作为本机号码一键登录的前置步骤。（注意，本机号码一键登录将消费 wx.getPhoneMask 获得的上下文信息，使得该上下文信息失效。开发者如需再次调用本机号码一键登录，应重新调用 wx.getPhoneMask。）

# 注意事项 1

• 开发者需依据返回 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 实际情况设计并放置相关的隐私协议，如：

# 注意事项 2

• 手机需打开蜂窝网络。即，此接口需要依赖手机上打开蜂窝网络，因此不可在开发者工具或者模拟器上调试，需在手机上测试。

# 使用步骤

1、需前往「微信开发者平台 - 多端应用 - 身份管理」开通身份管理功能，并且勾选「本机号码一键登录」。

2、按照开发文档调用 wx.getPhoneMask成功。（注意，本机号码一键登录将消费 wx.getPhoneMask 获得的上下文信息，使得该上下文信息失效。开发者如需再次调用本机号码一键登录，应重新调用 wx.getPhoneMask。）

3、按照开发文档调用本机号码一键登录组件，实现一键登录功能。

# 参数

# Object object

# object.success 回调函数

# 参数

# Object res

# object.fail 回调函数

# 参数

# Object res

res.errCode

# 示例代码

wx.getPhoneMask({
  success (res) {
    if (res.phoneMask) {
      // 获取手机号掩码 res.phoneMask 成功，展示在登录页。
    }
  }
})