すべてのプロダクト
Search
ドキュメントセンター

SuperApp:デバイス環境の検出

最終更新日:Apr 21, 2026

このドキュメントでは、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));
});