IMAPSエージェントと作成したIMAPSアプリの間のインタフェースです。IMAPSアプリがバックグランド状態に遷移したなどのイベント処理や、スマートデバイス上に保存していたデータの削除を行うためのAPIが提供されています。
IMAPSアプリ実行制御が提供している機能には、以下のようなものがあります。
IMAPSアプリのイベントリスナーの登録（addEventListner）
IMAPSアプリが使用していたデータの削除（removeAppData）
IMAPSアプリの強制終了（abortApp）
使用例
addEventListenerの使用例を以下に示します。
<!DOCTYPE HTML>
<html lang="ja">
<head>
<script type="text/javascript" src="js/cordova.js"></script>
<script type="text/javascript" src="js/imaps.js"></script>
<script type="text/javascript">
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
imaps.app.addEventListener("background", onBackground);
imaps.app.addEventListener("foreground", onForeground);
}
function onBackground() {
console.log("background event");
}
function onForeground() {
console.log("foreground event");
}
</script>
</head>
<body>
</body>
</html>removeAppDataの使用例を以下に示します。
<!DOCTYPE HTML>
<html lang="ja">
<head>
<script type="text/javascript" src="js/cordova.js"></script>
<script type="text/javascript" src="js/imaps.js"></script>
<script type="text/javascript">
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {}
function removeAppData() {
imaps.app.removeAppData(onSuccess, onFailure);
}
function onSuccess() {
alert("removeAppData success");
}
function onFailure() {
alert("removeAppData fail");
}
</script>
</head>
<body>
<button onclick="removeAppData()">removeAppData</button>
</body>
</html>abortAppの使用例を以下に示します。
<!DOCTYPE HTML>
<html lang="ja">
<head>
<script type="text/javascript" src="js/cordova.js"></script>
<script type="text/javascript" src="js/imaps.js"></script>
<script type="text/javascript">
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {}
function abortApp() {
imaps.app.abortApp();
}
</script>
</head>
<body>
<button onclick="abortApp()">abortApp</button>
</body>
</html>注意
addEventListener、removeAppData、abortAppメソッドは、IMAPSアプリでのみ正常動作します。