自定义事件

一、标准小游戏事件

在开发的过程中,不同游戏引擎对微信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。
  })

最后更新于