IMAPS Application Available Time Control

IMAPS Application Available Time Controlプラグインとは、利用可能な時間を制御するためのプラグインです。

利用時間の制御を開始するにはimaps.appmanager.initWithDefUrlメソッドを使用します。利用時間外であることはコールバック関数で通知されます。

注意

Windowsアプリの場合、cordova compile/build/runを--archsオプションを指定して実行してください。詳細は、2.2.4.3.2 プロセッサアーキテクチャを参照してください。

使用例

以下の場合に、それぞれ別の処理をする使用例を示しています。

利用時間の制御の開始処理で利用時間外であった場合
利用時間の制御の開始処理後に利用時間外となった場合
利用時間の制御の開始処理で利用不可能な日であった場合
利用時間の制御の開始処理後に利用不可能な日となった場合

function checkTime() {
    imaps.appmanager.initWithDefUrl(resultHandler, errorHandler, execAtInValidTime);
}


function execAtInValidTime(result) {
    var startTime = result.startTime;
    var endTime = result.endTime;
    var isStarted = result.isStarted;
    var status = result.status;
    
    if(isStarted == true) {
      if(status == 1) {
      	// 開始処理後に利用時間外となった場合の処理
      } else {
      	// 開始処理後に利用不可能な日となった場合の処理
      }
    } else {
      if(status == 1) {
      	// 開始処理で利用時間外であった場合の処理
      } else {
      	// 開始処理で利用不可能な日であった場合の処理
      }
    }
}

function resultHandler(result){
	// 開始処理が成功した場合の処理
}

function errorHandler(error) {
	// 開始処理で例外が発生した場合の処理
}

利用時間の情報を取得します。利用時間の制御の開始処理後に使用します。

function getStartTime() {
    imaps.appmanager.getStartTime(resultHandler, errorHandler); // 利用時間の開始時間を取得する場合
}

function resultHandler(result){
	alert("result: \r\n"+result );
}

function errorHandler(error) {
    alert("Error: \r\n"+error );
}

利用時間の制御を終了します。利用時間制御の開始処理後に利用時間外になる前に、終了する場合に使用します。

 function destroy() {
    imaps.appmanager.destroy(resultHandler, errorHandler);
}

function resultHandler(result){
	alert("result: \r\n"+result );
}

function errorHandler(error) {
    alert("Error: \r\n"+error );
}

注意

クライアント設定ファイルのappmgr.strictPolicyModeの値がfalseの場合は、端末がオフラインでポリシー設定ファイルが更新されない場合や、クライアントの時計が間違っている場合は、設定した時間外にアプリケーションが利用可能になる場合があります。詳細は、付録C クライアント設定ファイルを参照してください。

2.3.26 IMAPS Application Available Time Control