# 用戶信息功能頁

用戶信息功能頁用于幫助插件獲取用戶信息，包括 openid 和昵稱等，相當(dāng)于 wx.login 和 wx.getUserInfo 的功能。

在基礎(chǔ)庫版本 2.3.1 前，用戶信息功能頁是插件中唯一的獲取 code 和用戶信息的方式；

自基礎(chǔ)庫版本 2.3.1 起，用戶在該功能頁中進(jìn)行過授權(quán)后，插件可以直接調(diào)用 wx.login 和 wx.getUserInfo：

• 授權(quán)是以【用戶 + 小程序 + 插件】為維度進(jìn)行授權(quán)的，即同一個用戶在不同小程序中使用同一個插件，或同一個小程序中使用不同插件，都需要單獨(dú)進(jìn)行授權(quán)
• 自基礎(chǔ)庫版本 2.6.3 起，可以使用 wx.getSetting 來查詢用戶是否授權(quán)過

另外，在滿足以下任一條件時，插件可以直接調(diào)用 wx.login：

1. 使用插件的小程序與插件擁有相同的 AppId
2. 使用插件的小程序與插件綁定了同一個 微信開放平臺 賬號，且使用插件的小程序與插件均與開放平臺賬號為同主體或關(guān)聯(lián)主體

不滿足以上條件時，wx.login 和 wx.getUserInfo 將返回失敗。

# 調(diào)用參數(shù)

用戶信息功能頁使用 functional-page-navigator 進(jìn)行跳轉(zhuǎn)時，對應(yīng)的參數(shù) name 應(yīng)為固定值 loginAndGetUserInfo，其余參數(shù)與 wx.getUserInfo 相同，具體來說：

args 參數(shù)說明：

注：當(dāng) withCredentials 為 true 時，返回的數(shù)據(jù)會包含 encryptedData, iv 等敏感信息。

bindsuccess 返回參數(shù)說明：

userInfo 參數(shù)說明：

# 示例代碼

<!--plugin/components/hello-component.wxml-->
  <functional-page-navigator
    name="loginAndGetUserInfo"
    args="{{ args }}"
    version="develop"
    bind:success="loginSuccess"
    bind:fail="loginFail"
  >
    <button class="login">登錄到插件</button>
  </functional-page-navigator>

// plugin/components/hello-component.js
Component({
  properties: {},
  data: {
    args: {
      withCredentials: true,
      lang: 'zh_CN'
    }
  },
  methods: {
    loginSuccess: function (res) {
      console.log(res.detail);
    },
    loginFail: function (res) {
      console.log(res);
    }
  }
});

用戶點(diǎn)擊該 navigator 后，將跳轉(zhuǎn)到如下的用戶信息功能頁：

在微信開發(fā)者工具中查看示例：

1. 由于插件需要 appid 才能工作，請?zhí)钊胍粋€ appid；
2. 由于當(dāng)前代碼片段的限制，打開該示例后請 手動將 appid 填寫到 miniprogram/app.json 中（如下圖）使示例正常運(yùn)行。