自定义事件

自定义事件 支持平台:微信小程序、微信小游戏

一、标准小游戏事件

在开发的过程中,不同游戏引擎对微信API的适配方式不同。阿拉丁小游戏SDK是将自定义类事件挂载到了wx对象上,可通过wx.来访问阿拉丁小游戏SDK的事件功能

参数

类型

描述

事件名称

string

描述用户的动作名称,不超过255个字符,支持特殊字符

参数

string

动作的参数,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .)

参数值

string

动作的参数值,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .)

格式件如下

// 示例
wx.aldSendEvent('事件名称',{'参数key' : '参数value'})
// 案例1
wx.aldSendEvent("玩家角色死亡",{
"关卡" : "56关",
"耗时" : startTime - Date.now()
})
// 案例2
wx.aldSendEvent("点击商城")

二、分享统计自定义事件

阿拉丁小游戏SDK提供了对分享事件能力。wx.aldOnShareAppMessagewx.aldShareAppMessage方法,分别对应这wx.onShareAppMessagewx.shareAppMessage方法

wx.aldOnShareAppMessage

将微信的wx.OnShareAppMessage替换成wx.aldOnShareAppMessage

//分享,监听用户点击右上角菜单的“转发”按钮时触发的事件
wx.aldOnShareAppMessage(function(){
return {
imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com', //转发显示图片的链接
title : '分享title', //转发标题
query : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。
}
})

wx.aldShareAppMessage

将微信的wx.shareAppMessage替换成wx.aldShareAppMessage

// 分享,主动拉起转发,进入选择通讯录界面
wx.aldShareAppMessage({
imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com',//转发标题
title : '分享title',//转发标题
query : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。
})

三、分享场景事件

针对用户触发某个分享点的分析,比如超级道具、双倍金币奖励等等。

//分享触发分析
wx.aldShareAppMessage({
imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com',//转发标题
title : '分享title',//转发标题
ald_desc : "5倍分享奖励",//分享功能描述
query : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。
})
wx.aldShareAppMessage({
imageUrl : 'https://favicon.yandex.net/favicon/aldwx.com',//转发标题
title : '分享title',//转发标题
ald_desc : "超级道具", //分享功能描述
query : 'id=89&select=2'//查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionSync() 或 wx.onShow() 获取启动参数中的 query。
})