# Events

• 方法
  • addEventListener 绑定监听事件
  • removeEventListener移除监听事件
  • APPEnterBackgroundapp进入后台事件
  • APPEnterForegroundapp进入前台事件

# addEventListener

绑定监听事件

• 参数说明

  参数名	类型	必填	说明
  eventName	String	是	监听事件名称，见下表
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发
  isGlobal	String	可选	全局标识"0":该注册webview不管是否在栈顶可见，都能在消息发生时收到消息通知，"1":该注册webView在栈顶且可见时，消息发生能收到通知

• 参数eventName字段列表说明

  • "background": 应用切换到后台运行事件
  • "foreground": 应用切换到前台运行事件
  • "pushMessage" 推送消息事件，收到在线消息，收到离线消息,点击离线消息打开app时触发
  • "locationDidChanged":位置信息变化监听
  • "netchange":网络发生变化
  • "backbutton":安卓返回物理按钮被按下
  • "KeyboardHeightChange":系统键盘高度变化

• completedCB返回参数说明

  参数名	类型	说明
  status	Number	调用状态码 0成功, 1：失败
  message	String	调用结果信息
  payload	Object	详细结果

• 返回payload(事件为：netchange)参数说明

  参数名	类型	说明
  status	Number	网络变化到哪个状态,0:Unknown,1:无网络,2:蜂窝网络,3:WIFI,4：其他

• 返回payload(事件为：pushMessage)参数说明

  参数名	类型	说明
  messageType	String	区分是点击消息还是接受到消息。值为:receive表示此时接收到一条推送消息,值为:click表示此时用户打开一条推送消息。包括在系统中心点击推送消息启动app和用户使用app在应用内点击了一条推送消息
  messageData	Object	pp收到的推送消息体完整内容,即是业务数据,透传数据
  body	String	内容,iOS 10及之后支持此字段个推:app打开在前台时收到推送消息，无此字段
  title	String	标题，iOS 10及之后支持此字段个推:app打开在前台时收到推送消息，无此字段
  subtitle	String	子标题，iOS 10及之后支持此字段个推:app打开在前台时收到推送消息，无此字段

• 示例代码

foxsdk.events.addEventListener('background', ret => {
    console.log('events/addEventListener===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# removeEventListener

移除监听事件

• 参数说明

  参数名	类型	必填	说明
  eventName	String	是	监听事件名称，见下表
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• 参数eventName字段列表说明

  • background": 应用切换到后台运行事件
  • "foreground": 应用切换到前台运行事件
  • "pushMessage" 推送消息事件，收到在线消息，收到离线消息,点击离线消息打开app时触发
  • "locationDidChanged":位置信息变化监听
  • "netchange":网络发生变化
  • "backbutton":安卓返回物理按钮被按下
  • "KeyboardHeightChange":系统键盘高度变化

• completedCB返回参数说明

  参数名	类型	说明
  status	Number	调用状态码 0成功, 1：失败
  message	String	调用结果信息
  payload	Object	详细结果

• 示例代码

foxsdk.events.removeEventListener('background', ret => {
    console.log('events/removeEventListener===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# APPEnterBackground

app进入后台事件

• 示例代码

var registerEnterBackground = false
function addAPPEnterBackgroundListener(callback) {
    if (registerEnterBackground == false) {
        document.addEventListener('APPEnterBackground', function (e) {
            var res = e.tmf;
            callback(e)
        }, false);
        registerEnterBackground = true
    }
}

# APPEnterForeground

app进入前台事件

• 示例代码

var registerAPPEnterForeground = false
function addAPPEnterForegroundListener(callback) {
    if (registerAPPEnterForeground == false) {
        document.addEventListener('APPEnterForeground', function (e) {
            var res = e.tmf;
            callback(e)
        }, false);
        registerAPPEnterForeground = true
    }
}