# 本机号码一键登录
> iOS >= 0.7.13 支持，Android >= 0.7.5 支持。

通过 `button` 组件指定 `open-type` 为 `phoneOneClickLogin`，可获取临时登录凭证 (code)，通过凭证进而换取用户标识信息等。

## 前置流程

1、需前往「[微信开发者平台](https://developers.weixin.qq.com/platform/) - 多端应用 - 身份管理」开通身份管理功能，并且勾选「本机号码一键登录」。

2、按照开发文档调用 [wx.getPhoneMask](/miniprogram/dev/platform-capabilities/miniapp/api/auth/wx.getPhoneMask) 成功。（注意，本机号码一键登录将消费 wx.getPhoneMask 获得的上下文信息，使得该上下文信息失效。开发者如需再次调用本机号码一键登录，应重新调用 wx.getPhoneMask。）

## button 组件参数

|属性|类型|默认值|必填|说明
|--|--|--|--|--|
|open-type|string||是|phoneOneClickLogin 为发起一键登录流程|
|bindphoneoneclicklogin|Function||否|一键登录回调，open-type=phoneOneClickLogin 时有效|

## bindphoneoneclicklogin 回调参数

### Object res

|属性|类型|说明
|--|--|--|
|code|string|用户登录凭证（有效期五分钟）。开发者可以在开发者服务器调用 [code2Verifyinfo](/miniprogram/dev/platform-capabilities/miniapp/openapi/code2Verifyinfo)，使用 code 换取用户标识信息等|
|errCode|number|错误码|
|errMsg|string|错误提示|

**res.errCode**

|errCode|说明|
|--|--|
|-1|system error|
|10001021|获取 1 次手机号，只能登录 1 次|

## 示例代码

```wxml
<button bindphoneoneclicklogin="onHandleLogin" open-type="phoneOneClickLogin">一键登录按钮</button>
```

```js
Page({
  onHandleLogin(e) {
    const detail = e.detail;
    console.log('phoneOneClickLogin errCode', detail.errCode)
  },
})

```