本ドキュメントでは、H5 アプリケーションまたはミニプログラムを作成するための WVApplication クラスの JS API について説明します。これらの API を使用すると、アプリケーションの状態の取得や、アプリケーション設定ページを開くことができます。
WVApplication.appState
本 API は WindVane for iOS にのみ適用されます。
現在のアプリケーションの状態を返します。
入力パラメーター
なし。
コールバックパラメーター
呼び出しが成功した場合、success コールバックが実行されます。成功しなかった場合は、failure コールバックが実行されます。
state(string):現在のアプリケーションの状態。有効な値は次のとおりです:'active':アプリケーションがアクティブです。'inactive':アプリケーションはフォアグラウンドにありますが、アクティブではありません。たとえば、ユーザーが通知バーを引き下げた場合、ホームボタンをダブルクリックしてタスク管理インターフェイスを開いた場合、またはロック画面が表示された場合に、この状態になります。'background':アプリケーションはバックグラウンドにあります。'unknown':アプリケーションの状態を判別できません。
window.WindVane.call('WVApplication', 'appState', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});
WVApplication.getNotificationSettings
本 API は WindVane for iOS にのみ適用されます。
現在のアプリケーションの通知ステータスを返します。
入力パラメーター
なし。
コールバックパラメーター
呼び出しが成功した場合、success コールバックが実行されます。成功しなかった場合は、failure コールバックが実行されます。
status(string):アプリケーションの通知ステータス。有効な値は次のとおりです:'authorized':ユーザーがアプリケーションに通知を表示する権限を付与しました。'denied':ユーザーがアプリケーションに通知を表示する権限を拒否しました。'notDetermined':ユーザーはまだ通知に関する選択をしていません。この値は、アプリケーションが通知権限をリクエストする前の iOS で返される場合があります。'unknown':アプリケーションの通知ステータスを判別できません。
window.WindVane.call('WVApplication', 'getNotificationSettings', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});
WVApplication.openSettings
本 API は WindVane for iOS にのみ適用されます。
現在のアプリケーションの設定ページを開きます。
入力パラメーター
type(string, optional):開く設定ページを指定します。省略した場合、メソッドはメインのアプリケーション設定ページを開きます。唯一の有効な値は次のとおりです:
'Notification':現在のアプリケーションの通知設定ページを開きます。iOS では、システムは引き続きメインのアプリケーション設定ページを開きます。
コールバックパラメーター
このメソッドにはコールバックパラメーターはありません。呼び出しが成功した場合、success コールバックが実行されます。成功しなかった場合は、failure コールバックが実行されます。
window.WindVane.call('WVApplication', 'openSettings', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});