michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.device
michael@0: 
michael@0: このプラグインをグローバル定義します `device` オブジェクトは、デバイスのハードウェアとソフトウェアについて説明します。 それは後まで利用可能なオブジェクトがグローバル スコープでは、 `deviceready` イベント。
michael@0: 
michael@0:     document.addEventListener("deviceready", onDeviceReady, false);
michael@0:     function onDeviceReady() {
michael@0:         console.log(device.cordova);
michael@0:     }
michael@0:     
michael@0: 
michael@0: ## インストール
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.device
michael@0:     
michael@0: 
michael@0: ## プロパティ
michael@0: 
michael@0: *   device.cordova
michael@0: *   device.model
michael@0: *   device.platform
michael@0: *   device.uuid
michael@0: *   device.version
michael@0: 
michael@0: ## device.cordova
michael@0: 
michael@0: デバイスで実行されているコルドバのバージョンを取得します。
michael@0: 
michael@0: ### サポートされているプラットフォーム
michael@0: 
michael@0: *   アマゾン火 OS
michael@0: *   アンドロイド
michael@0: *   ブラックベリー 10
michael@0: *   ブラウザー
michael@0: *   Firefox の OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 と 8
michael@0: *   Windows 8
michael@0: 
michael@0: ## device.model
michael@0: 
michael@0: `device.model`、デバイスのモデルまたは製品の名前を返します。値は、デバイスの製造元によって設定され、同じ製品のバージョン間で異なる可能性があります。
michael@0: 
michael@0: ### サポートされているプラットフォーム
michael@0: 
michael@0: *   アンドロイド
michael@0: *   ブラックベリー 10
michael@0: *   ブラウザー
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 と 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### 簡単な例
michael@0: 
michael@0:     // Android:    Nexus One       returns "Passion" (Nexus One code name)
michael@0:     //             Motorola Droid  returns "voles"
michael@0:     // BlackBerry: Torch 9800      returns "9800"
michael@0:     // Browser:    Google Chrome   returns "Chrome"
michael@0:     //             Safari          returns "Safari"
michael@0:     // 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;
michael@0:     
michael@0: 
michael@0: ### Android の癖
michael@0: 
michael@0: *   生産コード名は[モデル名][1]の代わりに[製品名][2]を取得します。 たとえば、ネクサス 1 つを返します `Passion` 、Motorola のドロイドを返します`voles`.
michael@0: 
michael@0:  [1]: http://developer.android.com/reference/android/os/Build.html#MODEL
michael@0:  [2]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
michael@0: 
michael@0: ### Tizen の癖
michael@0: 
michael@0: *   たとえば、ベンダーによって割り当てられているデバイスのモデルを返します`TIZEN`
michael@0: 
michael@0: ### Windows Phone 7 と 8 癖
michael@0: 
michael@0: *   製造元によって指定されたデバイスのモデルを返します。たとえば、三星フォーカスを返します`SGH-i917`.
michael@0: 
michael@0: ## device.platform
michael@0: 
michael@0: デバイスのオペレーティング システム名を取得します。
michael@0: 
michael@0:     var string = device.platform;
michael@0:     
michael@0: 
michael@0: ### サポートされているプラットフォーム
michael@0: 
michael@0: *   アンドロイド
michael@0: *   ブラックベリー 10
michael@0: *   Browser4
michael@0: *   Firefox の OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 と 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### 簡単な例
michael@0: 
michael@0:     // Depending on the device, a few examples are:
michael@0:     //   - "Android"
michael@0:     //   - "BlackBerry 10"
michael@0:     //   - Browser:         returns "MacIntel" on Mac
michael@0:     //                      returns "Win32" on Windows
michael@0:     //   - "iOS"
michael@0:     //   - "WinCE"
michael@0:     //   - "Tizen"
michael@0:     var devicePlatform = device.platform;
michael@0:     
michael@0: 
michael@0: ### Windows Phone 7 の癖
michael@0: 
michael@0: Windows Phone 7 デバイスとプラットフォームを報告します。`WinCE`.
michael@0: 
michael@0: ### Windows Phone 8 癖
michael@0: 
michael@0: Windows Phone 8 デバイスとプラットフォームを報告します。`Win32NT`.
michael@0: 
michael@0: ## device.uuid
michael@0: 
michael@0: デバイスのユニバーサル ・ ユニーク識別子 ([UUID][3]を取得します。).
michael@0: 
michael@0:  [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
michael@0: 
michael@0:     var string = device.uuid;
michael@0:     
michael@0: 
michael@0: ### 説明
michael@0: 
michael@0: UUID を生成する方法の詳細は、デバイスの製造元によって決定され、デバイスのプラットフォームやモデルに固有です。
michael@0: 
michael@0: ### サポートされているプラットフォーム
michael@0: 
michael@0: *   アンドロイド
michael@0: *   ブラックベリー 10
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 と 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### 簡単な例
michael@0: 
michael@0:     //アンドロイド: ランダムな 64 ビットの整数 (を文字列として返します、再び ！）/デバイスの最初の起動時に生成される整数/////ブラックベリー: デバイスのピン番号を返します//これは 9 桁の一意な整数 (を文字列としても ！)////iPhone: (UIDevice クラスのドキュメントから言い換え）//識別複数のハードウェアから作成されたハッシュ値の文字列を返します。。
michael@0:     //それはすべてのデバイスに対して一意であることが保証され、接続することはできません//ユーザー アカウント。
michael@0:     //Windows Phone 7: デバイス + 現在のユーザーのハッシュを返します//ユーザーが定義されていない場合 guid が生成され、アプリがアンインストールされるまで保持されます//Tizen: デバイスの IMEI を返します （国際モバイル機器アイデンティティまたは IMEI は番号です//すべての GSM および UMTS の携帯電話に固有です。
michael@0:     var deviceID = device.uuid;
michael@0:     
michael@0: 
michael@0: ### iOS の気まぐれ
michael@0: 
michael@0: `uuid`IOS で、デバイスに固有ではないインストールごと、アプリケーションごとに異なります。 削除、アプリを再インストールした場合に変更と多分またときアップグレード iOS の, またはもアップグレードするアプリ (iOS の 5.1 で明らかに） バージョンごと。 `uuid`は信頼性の高い値ではありません。
michael@0: 
michael@0: ### Windows Phone 7 と 8 癖
michael@0: 
michael@0: `uuid`のために Windows Phone 7 には、権限が必要です `ID_CAP_IDENTITY_DEVICE` 。 Microsoft はすぐにこのプロパティを廃止して可能性があります。 機能が利用できない場合、アプリケーションはデバイスへのアプリケーションのインストールの持続期間のために保持されている永続的な guid を生成します。
michael@0: 
michael@0: ## device.version
michael@0: 
michael@0: オペレーティング システムのバージョンを取得します。
michael@0: 
michael@0:     var string = device.version;
michael@0:     
michael@0: 
michael@0: ### サポートされているプラットフォーム
michael@0: 
michael@0: *   アンドロイド 2.1 +
michael@0: *   ブラックベリー 10
michael@0: *   ブラウザー
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 と 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### 簡単な例
michael@0: 
michael@0:     // Android:    Froyo OS would return "2.2"
michael@0:     //             Eclair OS would return "2.1", "2.0.1", or "2.0"
michael@0:     //             Version can also return update level "2.1-update1"
michael@0:     //
michael@0:     // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
michael@0:     //
michael@0:     // Browser:    Returns version number for the browser
michael@0:     //
michael@0:     // iPhone:     iOS 3.2 returns "3.2"
michael@0:     //
michael@0:     // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
michael@0:     // Tizen: returns "TIZEN_20120425_2"
michael@0:     var deviceVersion = device.version;