## 自定义事件 **自定义事件 支持平台**:微信小程序、微信小游戏 ## ## 一、标准小游戏事件 在开发的过程中,不同游戏引擎对微信API的适配方式不同。阿拉丁小游戏SDK是将自定义类事件挂载到了wx对象上,可通过wx.来访问阿拉丁小游戏SDK的事件功能 ![](https://img.kancloud.cn/c1/8e/c18ec2c8d5498cc1d689a271f1f7ed40_1043x109.png) 格式件如下 ``` 1 // 示例 2 3 wx.aldSendEvent('事件名称',{'参数key' : '参数value'}) 4 // 案例1 5 wx.aldSendEvent("玩家角色死亡",{ 6 "关卡" : "56关", 7 "耗时" : startTime - Date.now() 8 }) 9 // 案例2 10 wx.aldSendEvent("点击商城") ``` ## ## 二、分享统计自定义事件 阿拉丁小游戏SDK提供了对分享事件能力。wx.aldOnShareAppMessage和wx.aldShareAppMessage方法,分别对应这wx.onShareAppMessage和wx.shareAppMessage方法 wx.aldOnShareAppMessage 将微信的wx.OnShareAppMessage替换成wx.aldOnShareAppMessage ``` 1 //分享,监听用户点击右上角菜单的“转发”按钮时触发的事件 2 wx.aldOnShareAppMessage(function(){ 3 return { 4 imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com', //转发显示图片的链接 5 title : '分享title', //转发标题 6 query : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。 7 } 8 }) ``` **wx.aldShareAppMessage** **将微信的wx.shareAppMessage替换成wx.aldShareAppMessage** ``` 1 // 分享,主动拉起转发,进入选择通讯录界面 2 wx.aldShareAppMessage({ 3 imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com',//转发标题 4 title : '分享title',//转发标题 5 query : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。 6 }) Copied! ``` ## ## 三、分享场景事件 针对用户触发某个分享点的分析,比如超级道具、双倍金币奖励等等。 ``` 1 //分享触发分析 2 wx.aldShareAppMessage({ 3 imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com',//转发标题 4 title : '分享title',//转发标题 5 ald\_desc : "5倍分享奖励",//分享功能描述 6 query : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。 7 }) 8 9 wx.aldShareAppMessage({ 10 imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com',//转发标题 11 title : '分享title',//转发标题 12 ald\_desc : "超级道具", //分享功能描述 13 query : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。 14 }) ```