ダッシュボードの開閉通知を受け取る方法(1.4.4 or later)
Mobage Native SDK 1.4.4 以降では、今まで取得できなかったダッシュボードの開閉通知を受け取ることができます。ダッシュボードとはコミュニティボタンやバランスボタンをタップした際に現れる Mobage 本体の機能を集約した WebView です。
ダッシュボードが開くタイミングには以下の様なケースがあります。
- コミュニティボタンをタップした
- バランスボタンをタップした
- openUserProfile を呼び出した
- launchPortalApp を呼び出した
- showBankUI を呼び出した
- openDocument を呼び出した
上記のタイミングでダッシュボードが開きますので、その瞬間、開いた通知を受け取ることができます。
また、ダッシュボードは右上の「✕」ボタンまたは「ゲームに戻る」ボタンで閉じることができます。閉じた瞬間にも通知を受け取ることができます。
iOS の場合の実装方法
iOS では以下のように実装することで、通知を受け取ることができます。
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onLaunchingDashboard) name:@"MBG_Notification_OnLaunchingDashboard" object:nil];
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onDismissDashboard) name:@"MBG_Notification_OnDismissingDashboard" object:nil];
- (void) onLaunchingDashboard {
// Dashboard opened
}
- (void) onDismissDashboard {
// Dasuboard dismissed
}
上記の実装では、MBG_Notification_OnLaunchingDashboard と MBG_Notification_OnDismissingDashboard という名前の observer を登録することにより、任意のメソッドでダッシュボードの開閉通知を受けることができるようになります。
Android の場合の実装方法
Android では以下のように実装することで、通知を受け取ることができます。
// Sample usage
private MobageDashboardObserver mObserver = null;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Registering observer
mObserver = new MobageDashboardObserver() {
@Override
public void onDashboardOpen() {
// Dashboard opens
}
@Override
public void onDashboardDismiss() {
// Dashboard closes
}
};
NotificationCenter.addObserver(mObserver);
}
@Override
protected void onDestroy() {
super.onDestroy();
// Unregistering observer
if (mObserver != null) {
NotificationCenter.removeObserver(mObserver);
mObserver = null;
}
}
Main の Activity の onCreate で登録した MobageDashboardObserver クラスの onDashboardOpen メソッド、onDashboardDismiss メソッドにそれぞれ通知されます。Lifecycleメソッドで分岐処理をする場合には、onStart() / onStop()で行ってください。
更新履歴
- 2013/09/12
- 新規作成