react native device info

反応ネイティブデバイス情報

React Native のデバイス情報。

目次

• インストール
• リンクする
• 使用法
• API
• フックとイベント
• トラブルシューティング
• リリースノート
• 反応ネイティブダム / 反応ネイティブウェブ

v6 から v7 へのアップグレード

iOS Podfile は iOS 10 以上に移行する必要があります。このモジュールの v7 では iOS9 はサポートされなくなりました。

インストール

npm の使用:

npm install --save react-native-device-info

または糸を使用して:

yarn add react-native-device-info

プロガード

インストールリファラー追跡を使用したい場合は、この構成を Proguard 構成に追加する必要があります。

 -keep class com.android.installreferrer.api.** {
  *;
}

リリース APK で hasGms() に関する問題が発生している場合は、Proguard 構成に次のルールを追加してください。

 -keep class com.google.android.gms.common.** {*;}

AndroidXのサポート

このモジュールのデフォルトは AndroidX です。android android/build.gradleファイルの「ext」ブロックでこれと同様のライブラリ バージョンを設定する必要があります。

アンドロイド

 .. .
  ext {
    // dependency versions

    We have 3 options for deviceId :
    // Option 1 (latest):
    firebaseIidVersion = " 19.0.1 " // default: "19.0.1"
    // Option 2 (legacy GooglePlay dependency but using AndroidX):
    googlePlayServicesIidVersion = " 17.0.0 " // default: "17.0.0" - AndroidX
    // Option 3 (legacy GooglePlay dependency before AndroidX):
    googlePlayServicesIidVersion = " 16.0.1 "


    // include as needed:
    compileSdkVersion = " 28 " // default: 28 (28 is required for AndroidX)
    targetSdkVersion = " 28 " // default: 28 (28 is required for AndroidX)
    supportLibVersion = ' 1.0.2 ' // Use '28.0.0' or don't specify for old libraries, '1.0.2' or similar for AndroidX
    mediaCompatVersion = ' 1.0.1 ' // Do not specify if using old libraries, specify '1.0.1' or similar for androidx.media:media dependency
    supportV4Version = ' 1.0.0 ' // Do not specify if using old libraries, specify '1.0.0' or similar for androidx.legacy:legacy-support-v4 dependency
  }
.. .

AndroidX 以外が必要な場合は、Jetifier パッケージをリバース モードで使用する必要があります。ドキュメントはそのパッケージで入手できます。

リンクする

ネイティブ モジュールでのリンクは、新しい反応ネイティブ開発者にとって頻繁にトラブルの原因となり、「RNDeviceInfo が null です」などのエラーが発生します。このため、自動リンクが実装されており、プロジェクトで使用する必要があります。

自動リンクはすべてのプラットフォームでサポートされています (React ネイティブ >= 0.63 の Windows でも!)

以前のバージョンでは手動でリンクを行う必要があります。これらの以前の反応ネイティブ バージョンに対するサポートは提供されていませんが、必要に応じてこの README の古いバージョンを参照してください。最新バージョンの反応ネイティブにアップグレードします。必要に応じて、インターネット上のupgrade-helperツールを使用します。

使用法

 import DeviceInfo from 'react-native-device-info' ;

// or ES6+ destructured imports

import { getUniqueId , getManufacturer } from 'react-native-device-info' ; 

API

多くの API はプラットフォーム固有であることに注意してください。プラットフォームに実装がない場合、受け取る「デフォルト」の戻り値は、文字列の場合は"unknown" 、数値の場合は-1 、ブール値の場合はfalseです。配列とオブジェクトは空になります (それぞれ[]と{} )。

ほとんどの API は Promise を返しますが、同期的に動作するSync備えた対応する API も末端にあります。たとえば、アプリの起動の最初の部分での非同期呼び出しを避けるために、アプリのブートストラップ中にisCameraPresentSync()を呼び出すことをお勧めします。

getUserAgentSync に関する注意事項

非同期メソッドgetUserAgent両方のプラットフォームで使用できますが、 getUserAgentSyncは Android でのみサポートされます。

このリポジトリのサンプル アプリは、すべての API の使用例を示しています。質問がある場合はサンプル アプリを参照してください。問題があると思われる場合は、報告する前にサンプル アプリを使用して再現できることを確認してください。ありがとうございます。

方法	戻り値の型	iOS	アンドロイド	窓	ウェブ	ビジョンOS
getAndroidId()	Promise		✅
getApiLevel()	Promise		✅
getアプリケーション名()	string	✅	✅	✅		✅
getAvailableLocationProviders()	Promise	✅	✅			✅
getBaseOs()	Promise		✅	✅	✅
getBuildId()	Promise	✅	✅	✅		✅
getBatteryLevel()	Promise	✅	✅	✅	✅	✅
getBootloader()	Promise		✅
ブランドを取得()	string	✅	✅	✅		✅
getBuildNumber()	string	✅	✅	✅		✅
getBundleId()	string	✅	✅	✅		✅
isCameraPresent()	Promise		✅	✅	✅
getキャリア()	Promise	✅	✅
getコード名()	Promise		✅
getDevice()	Promise		✅
getDeviceId()	string	✅	✅	✅		✅
getDeviceType()	string	✅	✅			✅
getDisplay()	Promise		✅
getデバイス名()	Promise	✅	✅	✅		✅
getDeviceToken()	Promise	✅				✅
getFirstInstallTime()	Promise	✅	✅	✅		✅
get指紋()	Promise		✅
getFontScale()	Promise	✅	✅	✅
getFreeDiskStorage()	Promise	✅	✅	✅	✅	✅
getFreeDiskStorageOld()	Promise	✅	✅	✅	✅	✅
getハードウェア()	Promise		✅
getホスト()	Promise		✅	✅
getHostNames()	Promise			✅
getIpアドレス()	Promise	✅	✅	✅		✅
getIncremental()	Promise		✅
getInstallerPackageName()	Promise	✅	✅	✅		✅
getInstallReferrer()	Promise		✅	✅	✅
getInstanceId()	Promise		✅
getLastUpdateTime()	Promise		✅
getMacAddress()	Promise	✅	✅			✅
getメーカー()	Promise	✅	✅	✅		✅
getMaxMemory()	Promise		✅	✅	✅
getModel()	string	✅	✅	✅		✅
getPowerState()	Promise	✅	✅	✅	✅	✅
getProduct()	Promise		✅
getPreviewSdkInt()	Promise		✅
getReadableVersion()	string	✅	✅	✅		✅
getシリアル番号()	Promise		✅	✅
getSecurityPatch()	Promise		✅
getStartupTime()	Promise	✅	✅			✅
getSystemAvailableFunctions()	Promise		✅
getシステム名()	string	✅	✅	✅		✅
getSystemVersion()	string	✅	✅	✅		✅
getTags()	Promise		✅
getType()	Promise		✅
getTotalDiskCapacity()	Promise	✅	✅	✅	✅	✅
getTotalDiskCapacityOld()	Promise	✅	✅	✅	✅	✅
getTotalMemory()	Promise	✅	✅		✅	✅
getUniqueId()	Promise	✅	✅	✅		✅
getusedMemory()	Promise	✅	✅	✅	✅	✅
getUserAgent()	Promise	✅	✅		✅	✅
getUserAgentSync()	string		✅		✅
getVersion()	string	✅	✅	✅		✅
getBrightness()	Promise	✅
hasGms()	Promise		✅
hasHms()	Promise		✅
hasNotch()	boolean	✅	✅	✅		✅
hasDynamicIsland()	boolean	✅	✅	✅		✅
hasSystemFeature()	Promise		✅
isAirplaneMode()	Promise		✅		✅
isBatteryCharging()	Promise	✅	✅	✅	✅	✅
isEmulator()	Promise	✅	✅	✅		✅
isKeyboardConnected()	Promise			✅
isLandscape()	Promise	✅	✅	✅		✅
isLocationEnabled()	Promise	✅	✅		✅	✅
isMouseConnected()	Promise			✅
isHeadphonesConnected()	Promise	✅	✅			✅
isWiredHeadphonesConnected()	Promise	✅	✅			✅
isBluetoothHeadphonesConnected()	Promise	✅	✅			✅
isPinOrFingerprintSet()	Promise	✅	✅	✅		✅
isタブレット()	boolean	✅	✅	✅		✅
isLowRamDevice()	boolean		✅
isDisplayZoomed()	boolean	✅
isタブレットモード()	Promise			✅
サポートされる32BitAbis()	Promise		✅
サポートされる64BitAbis()	Promise		✅
サポートされるAbis()	Promise	✅	✅	✅		✅
syncUniqueId()	Promise	✅				✅
getSupportedMediaTypeList()	Promise		✅

---

getApiLevel()

APIレベルを取得します。

例

 DeviceInfo . getApiLevel ( ) . then ( ( apiLevel ) => {
  // iOS: ?
  // Android: 25
  // Windows: ?
} ) ; 

注意事項

API レベルを参照

---

getAndroidId()

ANDROID_IDを取得します。適切な使用方法については、API ドキュメントを参照してください。

例

 DeviceInfo . getAndroidId ( ) . then ( ( androidId ) => {
  // androidId here
} ) ;

---

getアプリケーション名()

アプリケーション名を取得します。

例

 let appName = DeviceInfo . getApplicationName ( ) ;
// AwesomeApp

---

getBaseOs()

製品のベースとなる基本 OS ビルド。

例

 DeviceInfo . getBaseOs ( ) . then ( ( baseOs ) => {
  // "Windows", "Android" etc
} ) ;

---

getBatteryLevel()

デバイスのバッテリー レベルを 0 から 1 までの浮動小数点数として取得します。

例

 DeviceInfo . getBatteryLevel ( ) . then ( ( batteryLevel ) => {
  // 0.759999
} ) ; 

注意事項

実際のバッテリーレベルを取得できるようにするには、アプリケーションのバッテリー監視モードを有効にします。このコードを追加します。

[UIDevice currentDevice ].batteryMonitoringEnabled = true ;

AppDelegate.m アプリケーション:didFinishLaunchingWithOptions:

iOS シミュレータでは -1 を返します

---

getBootloader()

システム ブートローダーのバージョン番号。

例

 DeviceInfo . getBootloader ( ) . then ( ( bootloader ) => {
  // "mw8998-002.0069.00"
} ) ;

---

ブランドを取得()

デバイスのブランドを取得します。

例

 let brand = DeviceInfo . getBrand ( ) ;
// iOS: "Apple"
// Android: "xiaomi"
// Windows: ?

---

getBuildNumber()

アプリケーションのビルド番号を取得します。

例

 let buildNumber = DeviceInfo . getBuildNumber ( ) ;
// iOS: "89"
// Android: "4"
// Windows: ?

---

getBundleId()

アプリケーションバンドル識別子を取得します。

例

 let bundleId = DeviceInfo . getBundleId ( ) ;
// "com.example.AwesomeApp"

---

isCameraPresent()

デバイスに現在カメラが搭載されているかどうかを示します。

例

 DeviceInfo . isCameraPresent ( )
  . then ( ( isCameraPresent ) => {
    // true or false
  } )
  . catch ( ( cameraAccessException ) => {
    // is thrown if a camera device could not be queried or opened by the CameraManager on Android
  } ) ; 

注意事項

• カメラのホット追加/削除がサポートされています。
• カメラの物理的な存在のステータスを返します。カメラは存在するが、アプリにそれを使用する権限がない場合でも、isCameraPresent は true を返します。

---

getキャリア()

通信事業者名（通信事業者）を取得します。

例

 DeviceInfo . getCarrier ( ) . then ( ( carrier ) => {
  // "SOFTBANK"
} ) ;

---

getコード名()

現在の開発コードネーム、またはこれがリリース ビルドの場合は文字列「REL」。

例

 DeviceInfo . getCodename ( ) . then ( ( codename ) => {
  // "REL"
} ) ;

---

getDevice()

工業デザインの名前。

例

 DeviceInfo . getDevice ( ) . then ( ( device ) => {
  // "walleye"
} ) ;

---

getDeviceId()

デバイスIDを取得します。

例

 let deviceId = DeviceInfo . getDeviceId ( ) ;
// iOS: "iPhone7,2"
// Android: "goldfish"
// Windows: "Y3R94UC#AC4"

---

getDisplay()

ユーザーに表示するためのビルド ID 文字列。

例

 DeviceInfo . getDisplay ( ) . then ( ( display ) => {
  // "OPM2.171026.006.G1"
} ) ;

---

getデバイス名()

デバイス名を取得します。

例

 DeviceInfo . getDeviceName ( ) . then ( ( deviceName ) => {
  // iOS: "Becca's iPhone 6"
  // Android: ?
  // Windows: ?
} ) ;

これには android.permission.BLUETOOTH が必要でしたが、v3 の新しい実装では必要ありません。この API 用に AndroidManifest.xml があった場合は、それを AndroidManifest.xml から削除できます。 iOS 16 以降では、ユーザー定義のデバイス名にアクセスするための資格が必要です。そうでない場合は、一般的な値 (例: 「iPad」、「iPhone」) が返されます。

---

getDeviceToken()

デバイス トークンを取得します (DeviceCheck を参照)。実際のデバイスでは iOS 11.0 以降でのみ利用可能です。 getDeviceToken がサポートされていない場合、これにより Promise が拒否されます。例外処理には注意してください。

例

 DeviceInfo . getDeviceToken ( ) . then ( ( deviceToken ) => {
  // iOS: "a2Jqsd0kanz..."
} ) ;

---

getFirstInstallTime()

アプリが最初にインストールされた時間をミリ秒単位で取得します。

例

 DeviceInfo . getFirstInstallTime ( ) . then ( ( firstInstallTime ) => {
  // Android: 1517681764528
} ) ;

---

get指紋()

このビルドを一意に識別する文字列。

例

 DeviceInfo . getFingerprint ( ) . then ( ( fingerprint ) => {
  // "google/walleye/walleye:8.1.0/OPM2.171026.006.G1/4820017:user/release-keys"
} ) ;

---

getFontScale()

デバイスのフォントスケールを取得します。フォント スケールは、現在のシステム フォントと「通常の」フォント サイズの比率です。したがって、通常のテキストが 10 ポイントでシステム フォントが現在 15 ポイントの場合、フォント スケールは 1.5 になります。これは、アクセシビリティ設定が有効になっているかどうかを判断するために使用できます。デバイス用に変更されました。フォント スケールが大幅に大きい ( > 2.0 ) 場合は、特定のビューを再レイアウトする必要がある場合があります。

例

 DeviceInfo . getFontScale ( ) . then ( ( fontScale ) => {
  // 1.2
} ) ;

---

getFreeDiskStorage()

ルート ファイル システムとデータ ファイル システムの両方の計算を考慮して、利用可能なストレージ サイズをバイト単位で取得するメソッド。

iOSでは、このメソッドは次のオプションの引数を受け入れます。

• 'total' : volumeAvailableCapacityKeyを使用します
• 'important' : volumeAvailableCapacityForImportantUsageKeyを使用します
• 'opportunistic' : volumeAvailableCapacityForOpportunisticUsageKeyを使用します

詳細については、ボリューム ストレージ容量の確認に関する Apple ドキュメントを参照してください。

例

 DeviceInfo . getFreeDiskStorage ( ) . then ( ( freeDiskStorage ) => {
  // Android: 17179869184
  // iOS: 17179869184
} ) ;

DeviceInfo . getFreeDiskStorage ( 'important' ) . then ( ( freeDiskStorage ) => {
  // iOS: 18198219342 (important storage)
} ) ; 

注意事項

Android のこのメソッドで使用される API は v6.0.0 で変更されました。古いバージョンはgetFreeDiskStorageOld()として以下に維持されています。 iOS では、 getFreeDiskStorage()とgetFreeDiskStorageOld()同じ値を返します。

---

getFreeDiskStorageOld()

利用可能なストレージ サイズをバイト単位で取得するメソッドの古い実装。

例

 DeviceInfo . getFreeDiskStorageOld ( ) . then ( ( freeDiskStorage ) => {
  // Android: 17179869184
  // iOS: 17179869184
} ) ; 

注意事項

開発者.android.com から:

このメソッドは API レベル 29 で非推奨になりました。

プライマリ共有/外部ストレージ ディレクトリを返します。

注: ここでの「外部」という言葉に混同しないでください。このディレクトリは、メディア/共有ストレージとして考えることができます。これは、比較的大量のデータを保持でき、すべてのアプリケーション間で共有される (アクセス許可を強制しない) ファイル システムです。従来、これは SD カードですが、保護された内部ストレージとは別のデバイスの内蔵ストレージとして実装することもでき、コンピューター上のファイルシステムとしてマウントできます。

---

getハードウェア()

ハードウェアの名前 (カーネル コマンド ラインまたは /proc から)。

例

 DeviceInfo . getHardware ( ) . then ( hardware => {
  // "walleye"
} ) ;

---

getホスト()

ホスト名

例

 DeviceInfo . getHost ( ) . then ( ( host ) => {
  // "wprd10.hot.corp.google.com"
} ) ;

---

getIpアドレス()

非推奨デバイスの現在の IP アドレスを取得します。 （Wi-Fi のみ）react-native-netinfo/netinfo または reverse-native-network-info に切り替えます

例

 DeviceInfo . getIpAddress ( ) . then ( ( ip ) => {
  // "92.168.32.44"
} ) ; 

Androidの権限

• android.permission.ACCESS_WIFI_STATE

注意事項

iOS のサポートは 0.22.0 で追加されました

---

getIncremental()

このビルドを表すために基礎となるソース管理によって使用される内部値。

例

 DeviceInfo . getIncremental ( ) . then ( ( incremental ) => {
  // "4820017"
} ) ;

---

getInstallerPackageName()

このビルドを表すために基礎となるソース管理によって使用される内部値。

例

 DeviceInfo . getInstallerPackageName ( ) . then ( ( installerPackageName ) => {
  // Play Store: "com.android.vending"
  // Amazon: "com.amazon.venezia"
  // Samsung App Store: "com.sec.android.app.samsungapps"
  // iOS: "AppStore", "TestFlight", "Other"
} ) ;

---

getInstallReferrer()

アプリケーションのインストール時にリファラー文字列を取得します。

例

 DeviceInfo . getInstallReferrer ( ) . then ( ( installReferrer ) => {
  // If the app was installed from https://play.google.com/store/apps/details?id=com.myapp&referrer=my_install_referrer
  // the result will be "my_install_referrer"
} ) ;

---

getInstanceId()

アプリケーションインスタンスIDを取得します。

これは、次の順序でこれらのソースからインスタンス ID を取得しようとします。

• SharedPreferencesファイルのキーinstanceIdの値react-native-device-info
• Firebase IID ( firebaseBomVersionまたはfirebaseIidVersionが gradle ext で定義されている場合 -非推奨)
• GMS IID ( googlePlayServicesIidVersionまたはgooglePlayServicesVersionが gradle ext で定義されている場合 -非推奨)
• java.util.UUID.randomUUID() から生成され、SharedPreferences に保存されるランダムな UUID

非推奨のソースを使用している場合、生成されたインスタンス ID は共有設定に保存されるため、react-native-device-info のこのメジャー バージョンの間は安定しています。

React-native-device-info の将来のバージョンでは、Firebase IID と GMS IID の実装は削除され、将来のすべての値は SharedPreferences に保存された値 (存在する場合)、またはその後保存される新しいランダム UUID になります。将来そのアプリのインストールに使用されます。

例

 DeviceInfo . getInstanceId ( ) . then ( ( instanceId ) => {
  // Android: da4e0245-5d6c-402a-a07c-0c5349f229e2
} ) ; 

注意事項

https://developers.google.com/instance-id/ を参照してください。

---

getLastUpdateTime()

アプリが最後に更新された時刻をミリ秒単位で取得します。

例

 DeviceInfo . getLastUpdateTime ( ) . then ( ( lastUpdateTime ) => {
  // Android: 1517681764992
} ) ;

---

getMacAddress()

ネットワークアダプターのMACアドレスを取得します。

例

 DeviceInfo . getMacAddress ( ) . then ( ( mac ) => {
  // "E5:12:D8:E5:69:97"
} ) ; 

Androidの権限

• android.permission.ACCESS_WIFI_STATE

注意事項

iOS: iOS 7 以降、MAC アドレスの取得が無効になっているため、このメソッドは常に「02:00:00:00:00:00」を返します。

---

getメーカー()

デバイスの製造元を取得します。

例

 DeviceInfo . getManufacturer ( ) . then ( ( manufacturer ) => {
  // iOS: "Apple"
  // Android: "Google"
  // Windows: ?
} ) ;

---

getMaxMemory()

VM が使用しようとするメモリの最大量をバイト単位で返します。

例

 DeviceInfo . getMaxMemory ( ) . then ( ( maxMemory ) => {
  // 402653183
} ) ;

---

getModel()

デバイスのモデルを取得します。

iOS の警告:デバイス名のリストはコミュニティによって管理されているため、新しいデバイスに遅れが生じる可能性があります。 getDeviceId()を使用することをお勧めします。新しい iOS デバイスをデバイス名とともにリストに追加するプル リクエストは受け付けます。

例

 let model = DeviceInfo . getModel ( ) ;
// iOS: ?
// Android: ?
// Windows: ?

---

get電話番号()

getPhoneNumber() は削除されました。このメソッドは、非推奨の Android API を使用します。電話番号を取得するには、react-native-sim-cards-manager を使用します。

---

getPowerState()

バッテリーレベル、接続されているかどうか、システムが現在低電力モードで動作しているかどうかなど、デバイスの電源状態を取得します。バッテリー監視が有効になっていない場合、またはエミュレータ上で試行した場合 (監視が不可能な場合)、iOS に警告を表示します。

例

 DeviceInfo . getPowerState ( ) . then ( ( state ) => {
  // {
  //   batteryLevel: 0.759999,
  //   batteryState: 'unplugged',
  //   lowPowerMode: false,
  // }
} ) ;

---

getProduct()

製品全体の名前。

例

 DeviceInfo . getProduct ( ) . then ( ( product ) => {
  // "walleye"
} ) ;

---

getPreviewSdkInt()

プレリリース SDK の開発者プレビュー リビジョン。

例

 DeviceInfo . getPreviewSdkInt ( ) . then ( ( previewSdkInt ) => {
  // 0
} ) ;

---

getReadableVersion()

アプリケーションの人間が読めるバージョンを取得します (getVersion() + '.' + getBuildNumber() と同じ)

例

 let readableVersion = DeviceInfo . getReadableVersion ( ) ;
// iOS: 1.0.1.32
// Android: 1.0.1.234
// Windows: ?

---

getシリアル番号()

デバイスのシリアル番号を取得します。特権のあるアプリを使用していて、自分が何をしているのかを知っている場合を除き、ほとんどの場合、「不明」になります。

例

 DeviceInfo . getSerialNumber ( ) . then ( ( serialNumber ) => {
  // iOS: unknown
  // Android: ? (maybe a serial number, if your app is privileged)
  // Windows: ? (a serial number, if your app has the "capability smbios")
} ) ; 

注意事項

機能 smbios

Windows でこの方法を使用したい場合は、アプリケーションに smbios 機能を追加する必要があります。マニフェスト ファイルに機能を追加するには、このドキュメントに従ってください。

---

getSecurityPatch()

ユーザーに表示されるセキュリティ パッチ レベル。

例

 DeviceInfo . getSecurityPatch ( ) . then ( ( securityPatch ) => {
  // "2018-07-05"
} ) ;

---

getシステム名()

デバイスのOS名を取得します。

例

 let systemName = DeviceInfo . getSystemName ( ) ;
// iOS: "iOS" on newer iOS devices "iPhone OS" on older devices (including older iPad models), "iPadOS" for iPads using iPadOS 15.0 or higher.
// Android: "Android"
// Windows: ?

---

getStartupTime()

現在のアプリプロセスが開始された時刻をミリ秒単位で取得します。

例

 DeviceInfo . getStartupTime ( ) . then ( ( startupTime ) => {
  // Android: 1517681764528
  // iOS: 1517681764528
} ) ;

---

getSystemVersion()

デバイスのOSバージョンを取得します。

例

 let systemVersion = DeviceInfo . getSystemVersion ( ) ;
// iOS: "11.0"
// Android: "7.1.1"
// Windows: ?

---

getBuildId()

オペレーティング システムのビルド番号を取得します。

例

 DeviceInfo . getBuildId ( ) . then ( ( buildId ) => {
  // iOS: "12A269"
  // tvOS: not available
  // Android: "13D15"
  // Windows: not available
} ) ;

---

getTags()

ビルドを説明するカンマ区切りのタグ。

例

 DeviceInfo . getTags ( ) . then ( ( tags ) => {
  // "release-keys, unsigned, debug",
} ) ;

---

getType()

ビルドのタイプ。

例

 DeviceInfo . getType ( ) . then ( ( type ) => {
  // "user", "eng"
} ) ;

---

getTotalDiskCapacity()

ルート ファイル システムとデータ ファイル システムの両方の計算を考慮して、完全なディスク ストレージ サイズをバイト単位で取得するメソッド。

例

 DeviceInfo . getTotalDiskCapacity ( ) . then ( ( capacity ) => {
  // Android: 17179869184
  // iOS: 17179869184
} ) ; 

注意事項

Android のこのメソッドで使用される API は v6.0.0 で変更されました。古いバージョンはgetTotalDiskCapacityOld()として以下に維持されています。 iOS では、 getTotalDiskCapacity()とgetTotalDiskCapacityOld()同じ値を返します。

---

getTotalDiskCapacityOld()

完全なディスク ストレージ サイズ (バイト単位) を取得するメソッドの古い実装。

例

 DeviceInfo . getTotalDiskCapacityOld ( ) . then ( ( capacity ) => {
  // Android: 17179869184
  // iOS: 17179869184
} ) ;

---

getTotalMemory()

デバイスの合計メモリをバイト単位で取得します。

例

 DeviceInfo . getTotalMemory ( ) . then ( ( totalMemory ) => {
  // 1995018240
} ) ;

---

getUniqueId()

この識別子は一部のアプリ ストア (Huawei や Google Play など) では機密情報とみなされ、ユーザーの同意なしに、または未承認の目的で使用された場合、アプリが削除または拒否される可能性があります。詳細については、ストア ポリシーを参照してください (以下の注を参照)。

デバイス固有のIDを取得します。 Android では、現時点ではこのモジュールのgetAndroidId()と同じです。 iOS では、 DeviceUID uid 識別子が使用されます。 Windows では、 Windows.Security.ExchangeActiveSyncProvisioning.EasClientDeviceInformation.idを使用します。

例

 DeviceInfo . getUniqueId ( ) . then ( ( uniqueId ) => {
// iOS: "FCDBD8EF-62FC-4ECB-B2F5-92C9E79AC7F9"
// Android: "dd96dec43fb81c97"
// Windows: "{2cf7cb3c-da7a-d508-0d7f-696bb51185b4}"
} ) ; 

注意事項

• iOS: これはIDFV 、または IDFV が使用できない場合はランダムな文字列です。 UID が生成されると、iOS キーチェーンと NSUserDefaults に保存されます。そのため、アプリを削除したりIDFVをリセットしたりしても、状況は変わりません。これは永続的な一意の ID であると慎重に考えることができます。これは、誰かが Keychain/NSUserDefaults の値を手動でオーバーライドする場合、または Apple が Keychain と NSUserDefaults の実装を変更する場合にのみ変更できます。注意: IDFV はバンドル識別子を使用して計算されるため、アプリ拡張機能では異なります。
• android: Oreo より前は、この ID (ANDROID_ID) は、一度携帯電話をセットアップすると常に同じになります。
• android: Google Play ポリシー、「永続的なデバイス識別子」を参照してください。 Huawei - AppGallery レビューガイドラインでは、「永続的なデバイス識別子」と「ユーザーの同意の取得」を参照してください。

---

syncUniqueId()

このメソッドは iOS を対象としています。

これにより、uniqueId がIDFVと同期されるか、ランダムな文字列が新たに設定されます。

iOS では、 DeviceUID uid 識別子が使用されます。他のプラットフォームでは、このモジュールでgetUniqueId()を呼び出すだけです。

例

 DeviceInfo . syncUniqueId ( ) . then ( ( uniqueId ) => {
  // iOS: "FCDBD8EF-62FC-4ECB-B2F5-92C9E79AC7F9"
  // Android: "dd96dec43fb81c97"
  // Windows: ?
} ) ; 

注意事項

• ユーザーが 1 台の iOS デバイスから 2 台目の iOS デバイスにデータを移動または復元した場合、Keychain/NSUserDefaults に同じuniqueId持つ 2 つの異なるデバイスが存在することになります。ユーザーは新しい iOS デバイスでsyncUniqueId()を呼び出すことができます。これにより、 IDFVまたはランダムな文字列からuniqueId更新されます。

---

getusedMemory()

アプリのメモリ使用量をバイト単位で取得します。

️ Android ドキュメントからのメモ。

注: このメソッドは、ユーザー向けのプロセス管理 UI のデバッグまたは構築のみを目的としています。

例

 DeviceInfo . getUsedMemory ( ) . then ( ( usedMemory ) => {
  // 23452345
} ) ;

---

getSupportedMediaTypeList()

このメソッドは、サポートされているメディア コーデックのリストを取得します。

例

 DeviceInfo . getSupportedMediaTypeList ( ) . then ( ( string [ ] ) => {
  // ["audio/mpeg", "audio/mp4a-latm", "audio/mp4a-latm", "audio/mp4a-latm", "audio/mp4a-latm", "video/avc", "video/3gpp", "video/hevc", "video/mp4v-es", "video/av01", "video/avc", "video/avc", "video/avc", "video/avc"]
} ) ;

---

getUserAgent()

デバイスのユーザー エージェントを取得します。

例

 DeviceInfo . getUserAgent ( ) . then ( ( userAgent ) => {
  // iOS: "Mozilla/5.0 (iPhone; CPU iPhone OS 9_1 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Version/9.0 Mobile/13B143"
  // tvOS: not available
  // Android: "Mozilla/5.0 (Linux; Android 12; sdk_gphone64_arm64 Build/SE1A.220630.001; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/91.0.4472.114 Mobile Safari/537.36"
  // Windows: ?
} ) ;

---

getVersion()

アプリケーションのバージョンを取得します。バージョン文字列はデバイス/OS 形式であり、追加データ (ビルド番号など) を含めることができることを考慮してください。バージョン形式を確認したい場合は、正規表現を使用して、返されたバージョン文字列の必要な部分を取得できます。

例

 let version = DeviceInfo . getVersion ( ) ;
// iOS: "1.0"
// Android: "1.0" or "1.0.2-alpha.12"
// Windows: ?

---

isAirplaneMode()

デバイスが機内モードかどうかを示します。

例

 DeviceInfo . isAirplaneMode ( ) . then ( ( airplaneModeOn ) => {
  // false
} ) ; 

注意事項

• これは、リモート デバッガーが無効になっている場合にのみ機能します。

---

isBatteryCharging()

バッテリーが現在充電中かどうかを示します。

例

 DeviceInfo . isBatteryCharging ( ) . then ( ( isCharging ) => {
  // true or false
} ) ;

---

isEmulator()

アプリケーションがエミュレータで実行されているかどうかを示します。

例

 DeviceInfo . isEmulator ( ) . then ( ( isEmulator ) => {
  // false
} ) ;

---

isKeyboardConnected()

デバイスにキーボードが接続されているかどうかを示します。

例

 let isKeyboardConnected = DeviceInfo . isKeyboardConnected ( ) ;
// true

---

isPinOrFingerprintSet()

デバイスに PIN 番号または指紋が設定されているかどうかを示します。

例

 DeviceInfo . isPinOrFingerprintSet ( ) . then ( ( isPinOrFingerprintSet ) => {
  if ( ! isPinOrFingerprintSet ) {
    // ...
  }
} ) ;

---

isタブレット()

デバイスがタブレットかどうかを示します。

例

 let isTablet = DeviceInfo . isTablet ( ) ;
// true

---

isLowRamDevice()

デバイスの RAM が少ないかどうかを示します。

例

 let isLowRamDevice = DeviceInfo . isLowRamDevice ( ) ;
// true

---

isDisplayZoomed()

ユーザーが表示ズームをズームに変更したかどうかを示します

例

 let isDisplayZoomed = DeviceInfo . isDisplayZoomed ( ) ;
// true

---

isタブレットモード()

デバイスがタブレット モードかどうかを示します。

例

 let isTabletMode = DeviceInfo . isTabletMode ( ) ;
// true

---

isLandscape()

デバイスが現在横向きモードであるかどうかを示します。

例

 DeviceInfo . isLandscape ( ) . then ( ( isLandscape ) => {
  // true
} ) ;

---

isMouseConnected()

デバイスにマウスが接続されているかどうかを示します。

例

 let isMouseConnected = DeviceInfo . isMouseConnected ( ) ;
// true

---

hasGms()

デバイスが Google モバイル サービスをサポートしているかどうかを示します。

例

 DeviceInfo . hasGms ( ) . then ( ( hasGms ) => {
  // true
} ) ;

---

hasHms()

デバイスが Huawei モバイル サービスをサポートしているかどうかを示します。

例

 DeviceInfo . hasHms ( ) . then ( ( hasHms ) => {
  // true
} ) ;

---

hasNotch()

デバイスにノッチがあるかどうかを示します。

例

 let hasNotch = DeviceInfo . hasNotch ( ) ;
// true

---

hasDynamicIsland()

デバイスに動的アイランドがあるかどうかを示します。

例

 let hasDynamicIsland = DeviceInfo . hasDynamicIsland ( ) ;
// true

---

getDeviceType()

デバイスのタイプを文字列として返します。これは次のいずれかになります。

• Handset
• Tablet
• Tv
• Desktop
• GamingConsole
• Headset
• unknown

例

 let type = DeviceInfo . getDeviceType ( ) ;
// 'Handset'

---

サポートされる32BitAbis()

このデバイスでサポートされる 32 ビット ABI の順序付きリスト。

例

 DeviceInfo . supported32BitAbis ( ) . then ( ( abis ) => {
  // ["armeabi-v7a", "armeabi"]
} ) ;

---

サポートされる64BitAbis()

このデバイスでサポートされる 64 ビット ABI の順序付きリスト。

例

 DeviceInfo . supported64BitAbis ( ) . then ( ( abis ) => {
  // ["arm64-v8a"]
} ) ;

---

サポートされるAbis()

サポートされているプロセッサ アーキテクチャのバージョンのリストを返します。

例

 DeviceInfo . supportedAbis ( ) . then ( ( abis ) => {
  // [ "arm64 v8", "Intel x86-64h Haswell", "arm64-v8a", "armeabi-v7a", "armeabi", "win_x86", "win_arm", "win_x64" ]
} ) ;

---

hasSystemFeature(機能)

デバイスに特定のシステム機能があるかどうかを示します。

例

 DeviceInfo . hasSystemFeature ( 'amazon.hardware.fire_tv' ) . then ( ( hasFeature ) => {
  // true or false
} ) ;

---

getSystemAvailableFunctions()

Android で利用可能なシステム機能のリストを返します。

例

 DeviceInfo . getSystemAvailableFeatures ( ) . then ( ( features ) => {
  // ["android.software.backup", "android.hardware.screen.landscape", "android.hardware.wifi", ...]
} ) ;

isLocationEnabled()

デバイスの位置情報サービスがデバイスレベルでオフになっているかどうかを示します (アプリ固有の権限とは関係ありません)。

例

 DeviceInfo . isLocationEnabled ( ) . then ( ( enabled ) => {
  // true or false
} ) ;

isHeadphonesConnected()

デバイスが有線ヘッドセットまたは Bluetooth ヘッドフォンに接続されているかどうかを示します

例

 DeviceInfo . isHeadphonesConnected ( ) . then ( ( enabled ) => {
  // true or false
} ) ;

isWiredHeadphonesConnected()

デバイスが有線ヘッドセットに接続されているかどうかを示します

例

 DeviceInfo . isWiredHeadphonesConnected ( ) . then ( ( enabled ) => {
  // true or false
} ) ;

isBluetoothHeadphonesConnected()

デバイスが Bluetooth ヘッドセットに接続されているかどうかを示します

例

 DeviceInfo . isBluetoothHeadphonesConnected ( ) . then ( ( enabled ) => {
  // true or false
} ) ;

getAvailableLocationProviders()

プラットフォーム固有の位置プロバイダー/サービスのオブジェクトを、現在利用可能かどうかに関係なくboolean値とともに返します。

注: この機能には、Android の位置情報権限へのアクセスが必要です。

Android の例

 DeviceInfo . getAvailableLocationProviders ( ) . then ( ( providers ) => {
  // {
  //   gps: true
  //   network: true
  //   passive: true
  // }
} ) ; 

iOSの例

 DeviceInfo . getAvailableLocationProviders ( ) . then ( ( providers ) => {
  // {
  //   headingAvailable: false
  //   isRangingAvailable: false
  //   locationServicesEnabled: true
  //   significantLocationChangeMonitoringAvailable: true
  // }
} ) ;

getBrightness()

デバイスのメイン画面の現在の輝度レベルを取得します。現在iOSのみです。 0.0 ～ 1.0 の数値を返します。

例

 DeviceInfo . getBrightness ( ) . then ( ( brightness ) => {
  // iOS: 0.6
} ) ; 

フックとイベント

Windows、iOS、Android でサポートされています (バッテリー/充電関連 API の Web サポート)。

useBatteryLevel または RNDeviceInfo_batteryLevelDidChange

バッテリーレベルが変化すると発生します。 1 分に 1 回以上の頻度で送信されません。

例

 import { useBatteryLevel } from 'react-native-device-info' ;

const batteryLevel = useBatteryLevel ( ) ; // 0.759999

< Text > { batteryLevel } < / Text > ; 

 import { NativeEventEmitter , NativeModules } from 'react-native' ;
const deviceInfoEmitter = new NativeEventEmitter ( NativeModules . RNDeviceInfo ) ;

deviceInfoEmitter . addListener ( 'RNDeviceInfo_batteryLevelDidChange' , ( level ) => {
  // 0.759999
} ) ;

---

useBatteryLevelIsLow または RNDeviceInfo_batteryLevelIsLow

バッテリーレベルが低いと考えられるときに発生します（充電されるまで複数回）

プラットフォーム	パーセンテージ
iOS	20
アンドロイド	15
ウェブ	20
窓	20

例

 import { useBatteryLevelIsLow } from 'react-native-device-info' ;

const batteryLevelIsLow = useBatteryLevelIsLow ( ) ; // 0.19

< Text > { batteryLevelIsLow } < / Text > ; 

 import { NativeEventEmitter , NativeModules } from 'react-native' ;
const deviceInfoEmitter = new NativeEventEmitter ( NativeModules . RNDeviceInfo ) ;

deviceInfoEmitter . addListener ( 'RNDeviceInfo_batteryLevelIsLow' , ( level ) => {
  // 0.19
} ) ;

---

usePowerState または RNDeviceInfo_powerStateDidChange

バッテリーの状態が変化したとき、またはデバイスが省電力モードになったときに発生します。たとえば、デバイスが充電モードに入ったときやプラグが抜かれたときなどです。

例

 import { usePowerState } from 'react-native-device-info' ;

const powerState = usePowerState ( ) ;
  // {
  //   batteryLevel: 0.759999,
  //   batteryState: 'unplugged',
  //   lowPowerMode: false,
  // }

< Text > { powerState } < / Text > ; 

 import { NativeEventEmitter , NativeModules } from 'react-native'
const deviceInfoEmitter = new NativeEventEmitter ( NativeModules . RNDeviceInfo )

deviceInfoEmitter . addListener ( 'RNDeviceInfo_powerStateDidChange' , { powerState } = > {
  // {
  //   batteryLevel: 0.759999,
  //   batteryState: 'unplugged',
  //   lowPowerMode: false,
  // }
} ) ;

---

useFirstInstallTime

アプリが最初にインストールされた時間をミリ秒単位で取得します。

例

 import { useFirstInstallTime } from 'react-native-device-info' ;

const { loading , result } = useFirstInstallTime ( ) ; // { loading: true, result: 1517681764528}

< Text > { loading ? 'loading...' : result } < / Text > ;

---

useDeviceName

デバイス名を取得します。

例

{loading ? 'loading...' : result};">

 import { useDeviceName } from 'react-native-device-info' ;

const { loading , result } = useDeviceName ( ) ; // { loading: true, result: "Becca's iPhone 6"}

< Text > { loading ? 'loading...' : result } < / Text > ;

---

useHasSystemFeature

デバイスに特定のシステム機能があるかどうかを示します。

例

 import { useHasSystemFeature } from 'react-native-device-info' ;

const { loading , result } = useHasSystemFeature ( 'amazon.hardware.fire_tv' ) ; // { loading: true, result: false }

< Text > { loading ? 'loading...' : result } < / Text > ;

---

エミュレータを使用する

アプリケーションがエミュレータで実行されているかどうかを取得します。

例

 import { useIsEmulator } from 'react-native-device-info' ;

const { loading , result } = useIsEmulator ( ) ; // { loading: true, result: false }

< Text > { loading ? 'loading...' : result } < / Text > ;

---

使用メーカー

デバイスの製造元を取得します。

例

{loading ? 'loading...' : result};">

 import { useManufacturer } from 'react-native-device-info' ;

const { loading , result } = useManufacturer ( ) ; // { loading: true, result: "Apple"}

< Text > { loading ? 'loading...' : result } < / Text > ;

---

使用するヘッドフォンが接続されています

デバイスが有線ヘッドセットまたは Bluetooth ヘッドフォンに接続されているかどうかを示します。

このフックはイベントRNDeviceInfo_headphoneConnectionDidChangeをサブスクライブし、それに応じてresultフィールドを更新します。

例

 import { useIsHeadphonesConnected } from 'react-native-device-info' ;

const { loading , result } = useIsHeadphonesConnected ( ) ; // { loading: true, result: false}

< Text > { loading ? 'loading...' : result } < / Text > ;

---

有線ヘッドフォンを使用します接続されています

デバイスが有線ヘッドセットに接続されているかどうかを示します。

このフックはイベントRNDeviceInfo_headphoneWiredConnectionDidChangeをサブスクライブし、それに応じてresultフィールドを更新します。

例

 import { useIsWiredHeadphonesConnected } from 'react-native-device-info' ;

const { loading , result } = useIsWiredHeadphonesConnected ( ) ; // { loading: true, result: false}

< Text > { loading ? 'loading...' : result } < / Text > ;

---

使用するBluetoothヘッドフォンが接続されています

デバイスが Bluetooth ヘッドフォンに接続されているかどうかを示します。

このフックはイベントRNDeviceInfo_headphoneBluetoothConnectionDidChangeをサブスクライブし、それに応じてresultフィールドを更新します。

例

 import { useIsBluetoothHeadphonesConnected } from 'react-native-device-info' ;

const { loading , result } = useIsBluetoothHeadphonesConnected ( ) ; // { loading: true, result: false}

< Text > { loading ? 'loading...' : result } < / Text > ;

---

使用明るさ

デバイスのメイン画面の現在の輝度レベルを取得します。現在iOSのみです。 0.0 ～ 1.0 の数値を返します。

このフックはイベントRNDeviceInfo_brightnessDidChangeをサブスクライブし、それに応じてbrightnessフィールドを更新します。

例

 import { useBrightness } from 'react-native-device-info' ;

const brightness = useBrightness ( ) ; // 0.46578987897654567

< Text > { brightness } < / Text > ; 

 import { NativeEventEmitter , NativeModules } from 'react-native' ;

const deviceInfoEmitter = new NativeEventEmitter ( NativeModules . RNDeviceInfo ) ;

deviceInfoEmitter . addListener ( 'RNDeviceInfo_brightnessDidChange' , ( brightness ) => {
  // 0.46578987897654567
} ) ;

=======

ネイティブの相互運用性

ネイティブ側からデバイス タイプを確認する必要がある場合は、次を使用できます。

 import com . learnium . resolver . DeviceTypeResolver

...
deviceTypeResolver = new DeviceTypeResolver ( context );
...
//Check if the device is a Tablet:
if ( deviceTypeResolver . isTablet ){
  ...
} else {
  ...
}

トラブルシューティング

react-native-device-infoインストールまたは使用するときに、次の問題が発生する可能性があります。

[android] - dex をマージできない / 複数の dex ファイル / `com.google.android.gms` の問題

react-native-device-info com.google.android.gms:play-services-gcmを使用して getInstanceId() を提供します。これにより、Android アプリケーションを構築するときに競合が発生する可能性があります。

アプリで別のバージョンのcom.google.android.gms:play-services-gcmを使用している場合は、 build.gradleファイルでgooglePlayServicesVersion gradle 変数を定義して、 react-native-device-infoにバージョンを伝えることができます必要とするはずです。サンプルについては、ここに含まれるサンプル プロジェクトを参照してください。

com.google.android.gms:play-services-gcmと競合する別のライブラリを使用していて、バージョンの競合を回避するために何をしているかを確実に理解している場合は、単純にこの依存関係を無視できます。あなたのgradleファイル:

 compile(project( ' :react-native-device-info ' )) {
    exclude group : ' com.google.android.gms '
}

[ios] - ld: -lRNDeviceInfo-tvOS のライブラリが見つかりません

どうやらreact-native linkによるバグのようです。 Xcode -> [Your iOS build target] -> Build Phrases -> Link Binary with LibrariesでlibRNDeviceInfo-tvOS.a手動で削除できます。

[ios] - [NetworkInfo] 記述子クエリがエラーを返しました: エラー Domain=NSCocoaErrorDomain Code=4099 「com.apple.commcenter.coretelephony.xpc という名前のサービスへの接続が無効になりました。」

これは、 xcrun simctl spawn booted log config --mode "level:off" --subsystem com.apple.CoreTelephony実行することでオフにできるシステム レベルのログです。コマンドを元に戻すには、次のコマンドを実行します。 xcrun simctl spawn booted log config --mode "level:info" --subsystem com.apple.CoreTelephony

[ios] - CocoaPods を使用する場合、複数のバージョンの React が「'react-native' を要求しようとしますが、このモジュールを提供するファイルがいくつかあります」

RN<=59 Cocoapod を使用していて、未定義のシンボルまたは重複した React 定義がある場合は、Podfile を次のように調整する必要がある場合があります。

 target 'yourTargetName' do
  # See http://facebook.github.io/react-native/docs/integration-with-existing-apps.html#configuring-cocoapods-dependencies
  pod 'React' , :path => '../node_modules/react-native' , :subspecs => [
    'Core' ,
    'CxxBridge' , # Include this for RN >= 0.47
    'DevSupport' , # Include this to enable In-App Devmenu if RN >= 0.43
    'RCTText' ,
    'RCTNetwork' ,
    'RCTWebSocket' , # Needed for debugging
    'RCTAnimation' , # Needed for FlatList and animations running on native UI thread
    # Add any other subspecs you want to use in your project
  ]

  # Explicitly include Yoga if you are using RN >= 0.42.0
  pod 'yoga' , :path => '../node_modules/react-native/ReactCommon/yoga'

  # Third party deps podspec link - you may have multiple pods here, just an example
  pod 'RNDeviceInfo' , path : '../node_modules/react-native-device-info'

end

# if you see errors about React duplicate definitions, this fixes it. The same works for yoga.
post_install do | installer |
  installer . pods_project . targets . each do | target |
    if target . name == "React"
      target . remove_from_project
    end
  end
end

[テスト] - このライブラリを使用するとテスト スイートを実行できません

react-native-device-infoにはネイティブ コードが含まれているため、モックする必要があります。ただし、Jest スナップショットのサポートは機能する可能性があります。

Jest セットアップ ファイルが構成されていない場合は、Jest 設定に次の内容を追加し、プロジェクト ルートに jest.setup.js ファイルを作成する必要があります。

setupFiles: [ '/jest.setup.js' ] ;

次に、Jest セットアップ ファイルに次のコードを追加して、DeviceInfo ネイティブ モジュールをモックする必要があります。

 import mockRNDeviceInfo from 'react-native-device-info/jest/react-native-device-info-mock' ;

jest . mock ( 'react-native-device-info' , ( ) => mockRNDeviceInfo ) ;

詳細については、サンプル プロジェクトを確認してください。

[警告] - 警告が多すぎます (バッテリー状態など)

一部の API (getBatteryState など) は、tvOS や iOS エミュレーターなどの特定の状況で警告をスローします。これは本番環境では表示されませんが、開発中でもイライラする可能性があります。これらのデバイスは状態を返さないため、警告があると便利ですが、これは驚くべきことであり、github サポートの問題につながる可能性があります。警告は、開発者としての教育を目的としています。警告が煩わしい場合は、コード内でこれを試して警告を抑制してください。

 import { LogBox } from 'react-native' ;
LogBox . ignoreLogs ( [ 'Battery state' ] ) ; 

リリースノート

CHANGELOG.mdを参照してください。

貢献する

contributing guide参照してください。

反応ネイティブダム

開発者への好意として、このライブラリは v0.21.6 で、ビルドの中断を避けるために空のポリフィルを提供することにより、react-native-dom および React-native-web と互換性を持つようになりました。

getUserAgent() のみが正しい値を返します。他のすべての API メソッドは、文書化された戻り値の型の「空」の値を返します。数値の場合は0 、文字列の場合は'' 、ブール値の場合はfalse 。