このドキュメントでは、H5 アプリケーションまたはミニプログラムを作成する際に使用できる `WVNativeDetector` クラスの JavaScript API について説明します。これらの API は、デバイスモデル、CPU 使用率、メモリ使用量などのデバイス関連情報を取得します。
WVNativeDetector.isSimulator
現在の環境がシミュレーターであるかどうかをチェックします。
入力パラメーター
このメソッドには入力パラメーターはありません。
コールバックパラメーター
シミュレーターのステータスの取得に成功した場合、結果とともに `success` コールバックが呼び出されます。失敗した場合は、`failure` コールバックが呼び出されます。
[
boolean] isSimulator: 現在の環境がシミュレーターの場合は `true`、そうでない場合は `false` です。
window.WindVane.call('WVNativeDetector', 'isSimulator', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});
WVNativeDetector.getCurrentUsage
現在の CPU 使用率とメモリ使用量を取得します。
この API を呼び出すと、パフォーマンスオーバーヘッドが発生します。必要な場合にのみ呼び出してください。
入力パラメーター
このメソッドには入力パラメーターはありません。
コールバックパラメーター
使用量情報の取得に成功した場合、結果とともに `success` コールバックが呼び出されます。失敗した場合は、`failure` コールバックが呼び出されます。
[
number] cpuUsage: 現在の CPU 使用率です。[
number] memoryUsage: 現在のメモリ使用量です。値は `usedMemory / totalMemory` として計算されます。[
number] usedMemory: デバイスで使用中の合計メモリです。現在のアプリケーションや他の開いているアプリケーションが使用するメモリを含みます。単位は MB です。[
number] totalMemory: デバイスの総メモリです。単位は MB です。
window.WindVane.call('WVNativeDetector', 'getCurrentUsage', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});
WVNativeDetector.getDeviceYear
デバイスのリリース年を取得します。これは、デバイスのパフォーマンスを推定するのに役立ちます。iOS では、このメソッドはリリース年を正確に決定します。Android では、このメソッドは推定値を提供します。
一般的に、2012 年以降にリリースされたデバイスは、ほとんどのパフォーマンス要件を満たします。
入力パラメーター
このメソッドには入力パラメーターはありません。
コールバックパラメーター
デバイスのリリース年の取得に成功した場合、結果とともに `success` コールバックが呼び出されます。失敗した場合は、`failure` コールバックが呼び出されます。
[
number] deviceYear: デバイスのリリース年です (例: `2012`)。
window.WindVane.call('WVNativeDetector', 'getDeviceYear', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});
WVNativeDetector.getModelInfo
モデルなどのデバイス情報を取得します。
入力パラメーター
このメソッドには入力パラメーターはありません。
コールバックパラメーター
デバイス情報の取得に成功した場合、結果とともに `success` コールバックが呼び出されます。失敗した場合は、`failure` コールバックが呼び出されます。
[
string] brand: デバイスのブランドです (例: `"Apple"`、`"Google"`)。[
string] model: デバイスのモデルです (例: `"iPhone"`、`"iPod touch"`、`"Nexus 5"`)。[
string] platform: デバイスのプラットフォーム識別子です (例: `"iPhone5,2"`)。`VER.WindVane iOS` でのみ利用可能です。[
string] platformName: 人間が判読可能な `platform` 識別子のバージョンです (例: `"iPhone 5 (CDMA)"`)。`VER.WindVane iOS` でのみ利用可能です。
window.WindVane.call('WVNativeDetector', 'getModelInfo', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});
WVNativeDetector.getSafeAreaInsets
この API は WindVane iOS でのみ利用可能です。
現在のページのセーフエリアインセットを取得します。この API はフルスクリーンページにのみ適用されます。iOS 11 および iPhone X との互換性を確保するために使用してください。
入力パラメーター
このメソッドには入力パラメーターはありません。
コールバックパラメーター
セーフエリア情報の取得に成功した場合、結果とともに `success` コールバックが呼び出されます。失敗した場合は、`failure` コールバックが呼び出されます。
[
number] top: セーフエリアの上部インセットです。[
number] left: セーフエリアの左側インセットです。[
number] bottom: セーフエリアの下部インセットです。[
number] right: セーフエリアの右側インセットです。[
boolean] cssAvaliable: このパラメーターは、`constant(safe-area-inset-*)` CSS 関数が利用可能な場合に `true` になります。これは、オペレーティングシステムが `VER.iOS 11` 以降であり、クライアントアプリケーションが Xcode でビルドされたかどうかをチェックすることと同じです。
window.WindVane.call('WVNativeDetector', 'getSafeAreaInsets', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});