小程序分享及用户信息授权等接口能力的调整通知

针对近期部分小程序接口能力使用不合理的情况，微信公众平台将对下列能力进行调整。开发者可在最新版开发者工具内，选择最新基础库版本体验。调整方案具体如下，请开发者尽快完成适配。

1、分享监听接口

10月10日起新提交的版本，用户从小程序、小游戏中分享消息给好友时，开发者将无法获知用户是否分享完成，也无法在分享后立即获得群ID。请参考调整指引

近期我们收到了很多用户对小程序/小游戏中分享功能的投诉：在某些小程序/小游戏中，分享并非是用户主动自发的行为，而是受到了某类利益的诱惑，或是被迫分享。这样的内容充斥在群里、小程序里，对用户造成了骚扰。

分享功能，旨在帮助用户更流畅地与好友分享内容和服务，应是用户自发的行为。在原来的分享接口中，用户发起分享动作之后，可以通过 success 、fail、complete等回调来判断用户是否完成了最后的分享动作。通过这个能力，开发者可以将产品交互在分享这个能力上做得比较自然和顺畅。现在为鼓励用户自发分享喜爱的内容，减少“强制分享至不同群”等滥用分享能力，破坏用户体验的行为，在我们权衡了分享功能带来的利弊后，分享功能将进行以下调整：

10月10日起新提交发布的版本，不再支持分享回调参数 success 、fail 、complete，即用户从小程序/小游戏中分享消息给好友时，开发者将无法获知用户是否分享完成，也无法在分享后立即获得分享成功后的回调参数shareTicket。该调整可以在基础库 2.3.0及以上版本体验。

此次调整可能影响到三种分享功能的用法。

• 第一种:判断用户是否分享成功，进而给予用户奖励。

例如：小程序提示用户“分享到5个群，可以获得一张20元的优惠券”。

这类诱导用户分享的行为是我们平台所不倡导的，后续将没有办法实现。

• 第二种:分享完成后变更当前的页面状态

例如：赠送礼品场景下，用户点击“赠送”按钮，将礼品分享出去，分享成功后，界面展示“等待领取”。

这类场景，我们建议可以适当调整交互方案。例如在分享后继续保留“赠送”按钮，但在页面上提示用户一个礼品只能被一人领取，重复赠送无效。

• 第三种：通过用户分享之后的 shareTicket 获取群唯一标识 openGId ，以显示对应群的相关信息。

例如：通过分享小程序到某个群里，可以查看该群内成员的排行榜。

此次调整后，用户分享完成后无法立刻显示该群的排行榜信息，但仍可在用户从群消息点击进入小程序时显示该群的排行榜信息。

10月10日起新提交发布的版本将会受到此调整的影响。

需要各位开发者注意，10月10日起新提交发布的版本将会受到此策略的影响，请及时调整分享相关能力，考虑兼容上述调整带来的影响。

调整策略在基础库 2.3.0 及以上版本生效，该基础库版本对应微信客户端6.7.2版本。另外，考虑到兼容性等问题，在基础库版本 2.3.0 以下的环境中不受此策略影响，小程序/小游戏可继续获取分享回调事件。

2、getUserInfo接口

10月10日起新提交的版本，用户在小程序、小游戏中需要点击组件后，才可以触发登录授权弹窗、授权自己的昵称头像等数据。请参考调整指引

为了优化用户的使用体验，平台将回收“使用 wx.getUserInfo 接口直接弹出授权框”的能力，开发者需要使用组件方式唤起登录授权弹窗。

2018年10月10日后发布新版本的小程序，将无法在线上版本中使用接口直接弹出授权框。开发者可结合平台设计建议，提前做好兼容，合理使用微信登录能力。

1. 能力调整背景
   

2. 怎么合理使用微信登录能力

3. 小程序登录流程设计建议

01

能力调整背景

推出微信登录能力的初衷是希望：当用户使用小程序时，可以便捷地使用微信身份登录小程序。但在实际使用场景中，我们发现：很多开发者在打开小程序时直接弹出授权框，如果用户点击拒绝授权，无法使用小程序。

在用户无法获知当前小程序服务内容的情况下，很多用户就会选择拒绝授权并离开当前小程序。所以“一进入小程序就要求用户授权”的做法打断了用户正常使用小程序的流程，同时也不利于小程序获取新用户。

所以平台调整登录接口，回收“使用 wx.getUserInfo 接口直接弹出授权框”的能力，并鼓励开发者参照以下指引合理改造小程序内的登录流程。

02

怎么合理使用微信登录能力

平台分别提供多种方式实现微信登录：

1. 调用wx.login接口，静默获取openid

适用场景：无需使用用户头像、昵称、Unionid信息

2. 使用 open-data （小程序）或者开放数据域（小游戏）的方式展示用户信息（无需用户授权）

适用场景：需要在前端“展示”用户头像、昵称信息，但不需要获取Unionid

3.使用button（小程序）或UserInfoButton（小游戏）组件，用户点击后弹窗请求用户授权

适用场景：需要获取用户头像、昵称、Unionid等基本信息

开发建议

第一步：获取openID

当用户访问小程序时，先通过wx.login，获取用户openID 。这时无需弹框授权，开发者拿到 openID 可以建立自身的帐号 ID。

第二步： 使用open-data方式或开放数据域方式展示头像昵称

如需要在前端展示用户头像、昵称信息， 使用open-data 方式或者开放数据域的方式展示用户信息

第三步：根据实际使用场景，使用组件，引导用户登录

在关键操作中，如必须获取用户头像、昵称、UnionID信息，可根据第一步获取的openID判断是新用户还是旧用户：

    如果是旧用户，可以直接登录，也可定期使用wx.getUserInfo更新用户的信息；

    如果是新用户，使用button（小程序）或UserInfoButton（小游戏）组件，在用户点击后弹窗请求获取用户基本信息。

03

小程序登录流程设计建议

a. 在必须用到登录信息的环节引导用户登录

在用户必须登录时才引导用户登录（如：购买前需要获取会员信息，用于同步积分数据），而不是用户一进入小程序就弹窗要求用户授权。如只需要在前端展示用户头像、昵称，无需要求用户授权，可直接展示。

b.清晰、准确地引导用户登录

在登录页面中，清晰、准确地告知用户当前操作是登录，说明获取登录信息的目的（如：用于同步会员积分数据等）

c. 不强制用户必须登录后才能使用小程序服务

提供游客模式，不强制用户必须登录后才能进入小程序。如要求必须授权头像昵称等信息才能继续使用小程序，会导致某些用户放弃使用该小程序。

3、openSetting接口

10月10日起新提交的版本，用户在小程序、小游戏中需要点击行为后，才可以跳转打开设置页，管理授权信息。请参考调整指引

开发者可以通过 wx.openSetting 接口来打开小程序设置界面并返回用户的设置结果。在原来的 wx.openSetting 接口中，我们允许开发者直接调用此接口，但目前我们发现有不少开发者滥用此接口，使用户在无任何操作时，不断地强行跳转至设置页，导致用户无法正常使用甚至无法退出小程序。

为保证用户获得更顺畅的小程序使用体验，避免此类滥用情况，我们对该接口进行了调整。

调整后“打开小程序设置页”将支持以下两种实现方式：

• 方法1：使用 button 组件来使用此功能，示例代码如下：

  <button open-type="openSetting" bindopensetting="callback">打开设置页</button>

• 方法2:由点击行为触发wx.openSetting接口的调用，示例代码如下：

  <button bindtap="openSetting">打开设置页</button>  openSetting() {  wx.openSetting()}

  方法2已在最新版开发者工具中支持（基础库切到2.2.4及以上），开发者可以尽早适配。

此次调整会对直接调用wx.openSetting接口造成影响

• 原无需用户点击即可直接调用wx.openSetting接口的实现方式将不再支持，即将废弃的错误使用方式示例如下：

  onShow() {  wx.openSetting()}

10月10日起新提交发布的版本将会受到此调整的影响。

需要各位开发者注意，10月10日起新提交发布的小程序版本将不再支持无需用户点击即可直接调用的“打开小程序设置页”接口，请开发者尽早适配。

调整策略在基础库 2.3.0 及以上版本生效，该基础库版本对应微信客户端6.7.2版本。另外，考虑到兼容性等问题，在基础库版本 2.3.0 以下的环境中不受此策略影响。