デバイス環境の検出 - SuperApp - Alibaba Cloud ドキュメントセンター

このトピックでは、WVNativeDetector の JavaScript API について説明します。 HTML5 アプリまたはミニアプリを作成する際に、このトピックを参照できます。 WVNativeDetector の JavaScript 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 操作はパフォーマンスの低下を引き起こします。この API は必要な場合にのみ呼び出してください。

入力パラメーター

入力パラメーターはありません。

コールバックパラメーター

コールバックパラメーターは、コールバックメソッドを使用して渡されます。 CPU 使用率とメモリ使用率が取得された場合は、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"）。このパラメーターは、WindVane iOS が使用されている場合にのみ使用できます。
[string]platformName: デバイスのプラットフォーム名（例："iPhone 5 (CDMA)"）。このパラメーターは、platform と比較して理解しやすいです。このパラメーターは、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: カスケードスタイルシート（CSS）が使用可能かどうか、つまり、オペレーティングシステムが iOS 11 以降であり、Xcode を使用してアプリまたはミニアプリが開発されているかどうかを指定します。 constant(safe-area-inset-*) を使用して CSS の可用性を確認することもできます。

window.WindVane.call('WVNativeDetector', 'getSafeAreaInsets', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});