You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

206 lines
7.6 KiB

8 years ago
  1. <!---
  2. Licensed to the Apache Software Foundation (ASF) under one
  3. or more contributor license agreements. See the NOTICE file
  4. distributed with this work for additional information
  5. regarding copyright ownership. The ASF licenses this file
  6. to you under the Apache License, Version 2.0 (the
  7. "License"); you may not use this file except in compliance
  8. with the License. You may obtain a copy of the License at
  9. http://www.apache.org/licenses/LICENSE-2.0
  10. Unless required by applicable law or agreed to in writing,
  11. software distributed under the License is distributed on an
  12. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  13. KIND, either express or implied. See the License for the
  14. specific language governing permissions and limitations
  15. under the License.
  16. -->
  17. # cordova-plugin-device
  18. このプラグインをグローバル定義します `device` オブジェクトは、デバイスのハードウェアとソフトウェアについて説明します。 それは後まで利用可能なオブジェクトがグローバル スコープでは、 `deviceready` イベント。
  19. document.addEventListener("deviceready", onDeviceReady, false);
  20. function onDeviceReady() {
  21. console.log(device.cordova);
  22. }
  23. ## インストール
  24. cordova plugin add cordova-plugin-device
  25. ## プロパティ
  26. * device.cordova
  27. * device.model
  28. * device.platform
  29. * device.uuid
  30. * device.version
  31. ## device.cordova
  32. デバイスで実行されているコルドバのバージョンを取得します。
  33. ### サポートされているプラットフォーム
  34. * アマゾン火 OS
  35. * アンドロイド
  36. * ブラックベリー 10
  37. * ブラウザー
  38. * Firefox の OS
  39. * iOS
  40. * Tizen
  41. * Windows Phone 7 と 8
  42. * Windows 8
  43. ## device.model
  44. `device.model`、デバイスのモデルまたは製品の名前を返します。値は、デバイスの製造元によって設定され、同じ製品のバージョン間で異なる可能性があります。
  45. ### サポートされているプラットフォーム
  46. * アンドロイド
  47. * ブラックベリー 10
  48. * ブラウザー
  49. * iOS
  50. * Tizen
  51. * Windows Phone 7 と 8
  52. * Windows 8
  53. ### 簡単な例
  54. // Android: Nexus One returns "Passion" (Nexus One code name)
  55. // Motorola Droid returns "voles"
  56. // BlackBerry: Torch 9800 returns "9800"
  57. // Browser: Google Chrome returns "Chrome"
  58. // Safari returns "Safari"
  59. // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Http://theiphonewiki.com/wiki/index.php?title=Models を参照してください//var モデル = device.model;
  60. ### Android の癖
  61. * 生産コード名は[モデル名][1]の代わりに[製品名][2]を取得します。 たとえば、ネクサス 1 つを返します `Passion` 、Motorola のドロイドを返します`voles`.
  62. [1]: http://developer.android.com/reference/android/os/Build.html#MODEL
  63. [2]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
  64. ### Tizen の癖
  65. * たとえば、ベンダーによって割り当てられているデバイスのモデルを返します`TIZEN`
  66. ### Windows Phone 7 と 8 癖
  67. * 製造元によって指定されたデバイスのモデルを返します。たとえば、三星フォーカスを返します`SGH-i917`.
  68. ## device.platform
  69. デバイスのオペレーティング システム名を取得します。
  70. var string = device.platform;
  71. ### サポートされているプラットフォーム
  72. * アンドロイド
  73. * ブラックベリー 10
  74. * Browser4
  75. * Firefox の OS
  76. * iOS
  77. * Tizen
  78. * Windows Phone 7 と 8
  79. * Windows 8
  80. ### 簡単な例
  81. // Depending on the device, a few examples are:
  82. // - "Android"
  83. // - "BlackBerry 10"
  84. // - Browser: returns "MacIntel" on Mac
  85. // returns "Win32" on Windows
  86. // - "iOS"
  87. // - "WinCE"
  88. // - "Tizen"
  89. var devicePlatform = device.platform;
  90. ### Windows Phone 7 の癖
  91. Windows Phone 7 デバイスとプラットフォームを報告します。`WinCE`.
  92. ### Windows Phone 8 癖
  93. Windows Phone 8 デバイスとプラットフォームを報告します。`Win32NT`.
  94. ## device.uuid
  95. デバイスのユニバーサル ・ ユニーク識別子 ([UUID][3]を取得します。).
  96. [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
  97. var string = device.uuid;
  98. ### 説明
  99. UUID を生成する方法の詳細は、デバイスの製造元によって決定され、デバイスのプラットフォームやモデルに固有です。
  100. ### サポートされているプラットフォーム
  101. * アンドロイド
  102. * ブラックベリー 10
  103. * iOS
  104. * Tizen
  105. * Windows Phone 7 と 8
  106. * Windows 8
  107. ### 簡単な例
  108. //アンドロイド: ランダムな 64 ビットの整数 (を文字列として返します、再び !)/デバイスの最初の起動時に生成される整数/////ブラックベリー: デバイスのピン番号を返します//これは 9 桁の一意な整数 (を文字列としても !)////iPhone: (UIDevice クラスのドキュメントから言い換え)//識別複数のハードウェアから作成されたハッシュ値の文字列を返します。。
  109. //それはすべてのデバイスに対して一意であることが保証され、接続することはできません//ユーザー アカウント。
  110. //Windows Phone 7: デバイス + 現在のユーザーのハッシュを返します//ユーザーが定義されていない場合 guid が生成され、アプリがアンインストールされるまで保持されます//Tizen: デバイスの IMEI を返します (国際モバイル機器アイデンティティまたは IMEI は番号です//すべての GSM および UMTS の携帯電話に固有です。
  111. var deviceID = device.uuid;
  112. ### iOS の気まぐれ
  113. `uuid`IOS で、デバイスに固有ではないインストールごと、アプリケーションごとに異なります。 削除、アプリを再インストールした場合に変更と多分またときアップグレード iOS の, またはもアップグレードするアプリ (iOS の 5.1 で明らかに) バージョンごと。 `uuid`は信頼性の高い値ではありません。
  114. ### Windows Phone 7 と 8 癖
  115. `uuid`のために Windows Phone 7 には、権限が必要です `ID_CAP_IDENTITY_DEVICE` 。 Microsoft はすぐにこのプロパティを廃止して可能性があります。 機能が利用できない場合、アプリケーションはデバイスへのアプリケーションのインストールの持続期間のために保持されている永続的な guid を生成します。
  116. ## device.version
  117. オペレーティング システムのバージョンを取得します。
  118. var string = device.version;
  119. ### サポートされているプラットフォーム
  120. * アンドロイド 2.1 +
  121. * ブラックベリー 10
  122. * ブラウザー
  123. * iOS
  124. * Tizen
  125. * Windows Phone 7 と 8
  126. * Windows 8
  127. ### 簡単な例
  128. // Android: Froyo OS would return "2.2"
  129. // Eclair OS would return "2.1", "2.0.1", or "2.0"
  130. // Version can also return update level "2.1-update1"
  131. //
  132. // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
  133. //
  134. // Browser: Returns version number for the browser
  135. //
  136. // iPhone: iOS 3.2 returns "3.2"
  137. //
  138. // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
  139. // Tizen: returns "TIZEN_20120425_2"
  140. var deviceVersion = device.version;