这期菜鸟教程我们会用一个具体的产品方案来为大家解答以下这些问题——
1. 小游戏基于关系链的互动玩法有哪些？
2. 邀请好友的后续互动，
3. 开放数据域UI绘制太麻烦了，怎么办？
产品方案
· 在游戏内，定向邀请未注册的特定微信好友加入游戏;（也可以是游戏自定义条件的已注册好友，例如7天未登陆游戏的好友）
· 成功邀请后，开发者可监听成功事件。
· 邀请者可获取已邀请的好友信息。
案例实现
1
邀请好友
| 获取未玩过该游戏的好友
开发者需要在开放数据域通过 wx.getPotentialFriendList接口获取可能对游戏感兴趣的未注册的好友名单。该接口可以一次获取至多5个非同玩好友,每次拉去都会刷新名单。开发者拿到好友的openid、昵称和头像等数据，然后就可以开始提示玩家邀请啦！
wx.getPotentialFriendList({ success: (data) => { let list = data.list || []; console.log('getPotentialFriendList', data); }}); |
| 向指定用户发起分享
获取到好友数据之后，在开放数据域，通过wx.shareMessageToFriend接口可以给指定好友定向分享。
wx.shareMessageToFriend({ openId : '', // 这里填写好友的openid title : '快来探索浩瀚星空', imageUrl: 'https://mmocgame.qpic.cn/wechatgame/TKicR7oWel4znvwMdwOpuwoy1ntVB44kT9ZSse2u0xNcO5SaxIS2UwU0GdUfA2Al0/0'}) |
| 设置分享参数
wx.shareMessageToFriend的分享参数，只能从主域传入。
故拉起开放数据域前，开发者需要先通过wx.setMessageToFriendQuery
接口设置。目前该接口只允许传入一个参数 shareMessageToFriendScene，并且仅可以在游戏域使用。
// 设置定向分享参数（这里假设1代表的是邀请新玩家场景值）wx.setMessageToFriendQuery({ shareMessageToFriendScene: 1}); |
| 监听邀请成功事件
用户发起定向分享之后，在基础库2.9.4以上支持通过接口wx.onShareMessageToFriend监听邀请成功事件（链接待补充），给予邀请者激励。
wx.onShareMessageToFriend && wx.onShareMessageToFriend((res) => { console.log('wx.shareMessageToFriend', res); let tips = res.success ? '分享成功' : '分享失败'; wx.showToast({ title : tips, icon : 'none', duration: 2000 }); // 这里可触发游戏逻辑})； |
| 小结
至此，拉取好友、定向分享、监听成功通知的操作就完成了，几个接口的调用顺序如下，我们通过一个图来简单梳理这里的流程：
2
新玩家加入游戏，双方领奖励
| STEP1: 接受邀请
新玩家点击卡片进入游戏，开发者可通过 wx.getLaunchOptionsSync接口获取启动时候的信息，返回的对象中会有 query 参数，之前邀请者设置的 shareMessageToFriendScene 就会出现在 query 里了。我们直接判断这个值是否为 1（前文，我们设置了1为邀请新玩家场景值），然后发送事件给开放数据域，表明接收到了邀请。
wx.onShow((options) => { console.log('onShow options', options); // 玩家通过被邀请的卡片进入，向子域发送消息，要求修改开放数据域消息 if (options && options.query.shareMessageToFriendScene === '1' ) { this.openDataContext.postMessage({ event: 'reciveInvite', }); }}); |
| STEP2: 修改卡片分享人的托管数据
敲小黑板了！关键点来了！最多人问就是这里了！分享点进来不知道谁分享的，怎么办？
开放数据域收到 event 为 ‘reciveInvite’ 的消息之后，开发者可通过wx.modifyFriendInteractiveStorage接口修改邀请者的托管数据来做回馈。这个时候需要带上一个特别的参数 quiet: true 来表示修改卡片分享人的数据。设置了quiet:true的互动，开发者无需填入touser，用户侧也无需确认噢。
wx.modifyFriendInteractiveStorage({ // 这里定义key“2”代表邀请玩家的数量 key :'2', opNum : 1, operation: 'add', // 静默修改需要用户通过快捷分享消息卡片进入才有效，代表分享反馈操作，无需填写 toUser，直接修改分享者与被分享者交互数据 quiet : true, complete:(res) => { console.log('modifyFriendInteractiveStorage', res); }}); |
| STEP3: 数据校验 及 记录赠送关系
通过wx.modifyFriendInteractiveStorage我们可以修改卡片分享人的互动型托管数据，但是这个API看起来并没有记录邀请人和被邀请人，只是简单修改卡片分享人的数据，如果我想校验下哪些用户是已经邀请过的，或者想展示邀请记录该怎么做呢？
这里我们需要了解下JSServer：
wx.modifyFriendInteractiveData接口在具体写入操作之前会默认执行开发者托管在JSServer上的一段代码，要求开发者使用开发者工具上传文件checkInteractiveData.js。
而在JSServer运行环境下，可以调用wx.getOpenId()、wx.getFriendUserStorage()和wx.setFriendUserStorage()这几个接口，此外还可以拿到用户本人openid:wx.getOpenId()、目标好友openid:toUser和增加的数据opNum，这样除了执行校验，还可以顺带将邀请和被邀请记录写入普通托管数据，如下图所示（JSServer的校验逻辑可以参考本文附上的源码）：
|| TIPS：游戏过审发布后，记得在工具上将checkInteractiveData.js文件发布上线，校验才会在正式环境生效。否则，修改互动型托管数据也会失败。
| STEP4: 触发邀请成功后游戏逻辑
按照上面的步骤，互动型托管数据和邀请记录都已经记录起来了。
但这些数据都是在开放数据域才能拿到的，如果想在主域根据这些邀请记录来做发放奖励逻辑该怎么做呢？这里我们在主域提供了wx.getUserInteractiveStorage接口，可以拉取互动性关系链数据。
// 获取用户的加密交互数据wx.getUserInteractiveStorage({ keyList: ['2'], success: ({cloudID}) => { // 该接口拿到的是加密数据，数据解密可以通过开发者自己的后台也可以通过云函数，这里演示云函数 wx.cloud.callFunction({ name: 'getUserInteractiveStorage', data: { userInteractive: wx.cloud.CloudID(cloudID), } }).then(res => { console.log('cloud getUserInteractiveStorage', res); }); }}); |
通过上述接口拿到的最终数据如下，代表邀请了3个玩家，开发者根据这个数据就可以给玩家发放奖励了！
{ "data":{ "kv_list":[ { "key":"2", "value":"3" } ] }, "openid":"xxxxx"} |
至此，如何实现邀请好友，双方激励的案例实践讲完啦！而且，我们的开发GG还把上面的示例代码提供给大家，下载换个APPID，做个UI就可以跑咯，源码链接
上面的case能力都是在开放数据域实现，但我们有收到很多反馈：在开放数据域做UI界面太难了！！
“我只是想绘制一个简单的好友列表，最多加个赠送或者邀请按钮，在开放数据域做UI界面太难了！！”
“开放数据域引入一个独立的游戏引擎会占据好多代码包体积”
“纯canvas开发真的太麻烦，代码可读性差，事件处理也很麻烦”
这是很多开发者的心声。
为此，开发哥哥们也提供了开放数据域UI绘制的解决方案——轻量级的canvas渲染引擎。
体积小！性能还杠杠的！上面的demo就是用它完成的。
轻量级的canvas渲染引擎
这款轻量级的canvas渲染引擎，它具有以下特点：
· 引擎体积很小，压缩之后仅~50kb；
· 类Web开发，只需提供XML + CSS即可渲染界面，提高代码可维护性；
· 性能强大：长列表滚动可跑满60帧；
| 使用教程：
· step 1：克隆本项目到合适的文件夹，引用引擎
// 通过Git的方式安装git clone https://github.com/wechat-miniprogram/minigame-canvas-engine// 引用渲染引擎import Layout from 'minigame-canvas-engine' |
· step 2：为UI界面编写模板和样式
let template = `<view > <text value="hello canvas"> </text></view>`let style = { container: { width: 200, height: 100, backgroundColor: '#ffffff', justContent: 'center', alignItems: 'center', }, testText: { color: '#ff0000', width: 200, height: 100, lineHeight: 100, fontSize: 30, textAlign: 'center', }} |
· step 3：调用渲染API，执行真正的渲染
// 将模板和样式传给渲染引擎，渲染引擎会生成布局树和渲染树等，准备渲染到canvas上面Layout.init(template, style); // sharedContext自行创建Layout.layout(sharedContext);/** * 设置sharedCancas在主域绘制的物理尺寸和位置信息，这一步非常重要， * 因为子域渲染引擎并不关心外部使用的引擎是什么，而是自己监听触摸事件来进行事件处理， * 因此需要拿到真实的物理尺寸、位置信息来执行事件处理。 */Layout.updateViewPort({ width : 200, height: 100, x : 100, y : 100}); |
· step 4：效果预览
|| TIPS：
详细的教程可以查看文档；
为了方便调试，还可以使用在线编辑功能；
上面的邀请好友获得激励的demo示例，也是用这个canvas渲染引擎实现的喔。
对定向分享奖励还有什么疑问或者经验分享？希望了解哪些方面的实践教程？欢迎在评论区留言。
可不可以提供个轻量级的canvas渲染引擎在小游戏里的demo，这个例子没法在小游戏里跑，一般做游戏开发的都用的h5的引擎，对这种用代码来做界面的一窍不通，希望是整个demo，否则太难调试了
比如这串代码，在小游戏里，直接报Please set width and height property for root element，无从下手啊
在线编辑模板里的代码拿到小游戏里，也这的错那的错
希望能有个在小游戏里跑的通的demo，这样能省很多时间，这种轻量级的引擎，实在让人头痛
这个邀请按钮是子域的吗？ 子域按钮还能响应吗
现在这种功能是不是不让做了？我看到运营规范里 滥用分享行为 明确禁止这样的分享了。
违规内容
小程序提供的服务中，不得存在滥用分享违规行为。如强制用户分享行为；分享立即获得利益的诱导行为；通过明示或暗示的样式来达到诱导分享目的；以及蹭流量诱导分享获得红包封面的行为等。
在游戏内，定向邀请未注册的特定微信好友加入游戏;（也可以是游戏自定义条件的已注册好友，例如7天未登陆游戏的好友）
wx.getPotentialFriendList这个接口只能回去未注册的
请问游戏自定义条件的已注册好友 这个怎么获取
请问这个是否会影响到canvas.toTempFilePath的使用？我用这种方式加了开放域之后，自己截图分享出来的都是黑图，请问有啥解决方法吗
你好，这个邀请好用的功能写完了，可是不好测试，没有那么多账号。。。官方有木有什么便捷的方法，方便我们测试，比如小游戏的体验成员不会从getPotentialFriendList列表里面移除之类的。。。。
checkInteractiveData.js
这个文件里面的
const giftStorageKey = now.toDateString() const friendsStorage = wx.getFriendUserStorage([giftStorageKey])这个的key为什么是时间呢，另外这个getFriendUserStorage方法取不到数据，这个数据怎么存进去的呢通过自己后台解密 用户的加密交互数据，一直报 -41003的错误，求解，返回的加密数据长度很短
我在定向分享后，又发起一次普通分享（非定向），结果发出去的普通分享是定向分享，再发起一次普通分享才正常，这是为什么？
（2）接着发起普通分享，发送出去的卡片是第一次定向分享的卡片，内容完全相同；
（3）再次发起普通分享，发送出去的卡片正确，为普通分享的卡片
调用接口不同，是需要什么清理操作么
新帖子 https://developers.weixin.qq.com/community/develop/doc/0002ee8c6048c82a13a958dd156400?fromCreate=0
jsServer 怎么调试呢？