mobage.event
概要
此模块中的功能,用于对非同步发生的事件进行监控。
功能列表
在mobage.event模块中,有以下方法。
方法
mobage.event.subscribe
监控特定事件所需的Listener函数注册方法。
在教程中也有样例介绍。
语法
可使用 event_name (string 型),指定各种监控事件。event_name 中可以有或无 args 指定选项,有或无时的指定方法有所不同。
-
无 args 指定时
subscriberId = mobage.event.subscribe (``"event_name"``, callback); -
有 args 指定时
subscriberId = mobage.event.subscribe (``"event_name"``, args, callback);
event_name
string 型的参数。需要从以下列表中指定想要监控事件所对应的 event_name。
args
可按不同 event_name 值进行指定的可变参数。不同 event_name 的设置值如下。
| event_name | args | description |
|---|---|---|
| modal.beforeOpen | 无 | 在Mobage JS SDK的 modal window 临打开前执行。 为了防止Game 端打开的 modal window 与 Mobage JS SDK 打开的 mobdal window 重复,请使用此方法。 |
| modal.afterOpen | 无 | 在Mobage JS SDK的 modal window 打开后立即执行。 |
| modal.beforeClose | 无 | 在Mobage JS SDK的 modal window 临关闭前执行。 |
| modal.afterClose | 无 | 在Mobage JS SDK的 modal window 关闭后立即执行。 为防止Game 端打开的 modal window 与 Mobage JS SDK 打开的 mobdal window 重复,请使用此方法。 |
| oauth.sessionStateChange | session_state | 对从Authorization Response获取的Game Server登录会话绑定的session_state值进行指定,对退出事件进行监控。 |
| bank.paymentBacklog | 无 | 对未确定的事务进行监控。 |
| platform.unsupportedBrowser | 无 | 对是否已在iOS 的UIWebView 中打开进行监控。 |
| analytics.userActivity | 无 | 对用户在游戏内的活动事件进行监控。 |
callback
是function型的参数,从SDK 进行调用的 callback 函数。
callback 函数的参数因设置的 evet_name 而异。对应表格如下。
| event_name | callback 函数的参数 |
|---|---|
| modal.beforeOpen | 无 |
| modal.afterOpen | 无 |
| modal.beforeClose | 无 |
| modal.afterClose | 无 |
| oauth.sessionStateChange | string 型的参数。通过字符串传递有无更改。 |
| bank.paymentBacklog | array 型的参数。传递未确定的事务ID值的数组。 |
| platform.unsupportedBrowser | object 型的参数。作为对象,传递是否已在 iOS的UIWebView中打开的真假值。 |
| analytics.userActivity | object 型的参数。对用户的活动事件,传递带有以下属性的对象。 |
subscriberId
string型的反馈值。是在mobage.event.unsubscribe() 方法中使用Listener函数的标识符。
mobage.event.unsubscribe
解除mobage.event.subscribe()中注册的Listener函数的事件监控。
语法
mobage.event.unsubscribe (subscriberId); |
subscriberId
string 型的参数,是mobage.event.subscribe()的反馈值。