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.

202 lines
7.0 KiB

8 years ago
  1. <!--
  2. # license: 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. #
  10. # http://www.apache.org/licenses/LICENSE-2.0
  11. #
  12. # Unless required by applicable law or agreed to in writing,
  13. # software distributed under the License is distributed on an
  14. # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  15. # KIND, either express or implied. See the License for the
  16. # specific language governing permissions and limitations
  17. # under the License.
  18. -->
  19. # cordova-plugin-device
  20. [![Build Status](https://travis-ci.org/apache/cordova-plugin-device.svg?branch=master)](https://travis-ci.org/apache/cordova-plugin-device)
  21. 이 플러그인 정의 전역 `device` 개체, 디바이스의 하드웨어 및 소프트웨어에 설명 합니다. 개체는 전역 범위에서 비록 그것은 후까지 사용할 수 있는 `deviceready` 이벤트.
  22. document.addEventListener("deviceready", onDeviceReady, false);
  23. function onDeviceReady() {
  24. console.log(device.cordova);
  25. }
  26. ## 설치
  27. cordova plugin add cordova-plugin-device
  28. ## 속성
  29. * device.cordova
  30. * device.model
  31. * device.platform
  32. * device.uuid
  33. * device.version
  34. ## device.cordova
  35. 코르도바는 장치에서 실행 중인 버전을 얻을.
  36. ### 지원 되는 플랫폼
  37. * 아마존 화재 운영 체제
  38. * 안 드 로이드
  39. * 블랙베리 10
  40. * 브라우저
  41. * Firefox 운영 체제
  42. * iOS
  43. * Tizen
  44. * Windows Phone 7과 8
  45. * 윈도우 8
  46. ## device.model
  47. `device.model`소자의 모델 또는 제품의 이름을 반환 합니다. 값 장치 제조업체에서 설정 되 고 동일 제품의 버전 간에 다를 수 있습니다.
  48. ### 지원 되는 플랫폼
  49. * 안 드 로이드
  50. * 블랙베리 10
  51. * 브라우저
  52. * iOS
  53. * Tizen
  54. * Windows Phone 7과 8
  55. * 윈도우 8
  56. ### 빠른 예제
  57. // Android: Nexus One returns "Passion" (Nexus One code name)
  58. // Motorola Droid returns "voles"
  59. // BlackBerry: Torch 9800 returns "9800"
  60. // Browser: Google Chrome returns "Chrome"
  61. // Safari returns "Safari"
  62. // 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;
  63. ### 안 드 로이드 단점
  64. * 어떤은 종종 프로덕션 코드 이름 대신 [제품 모델 이름](http://developer.android.com/reference/android/os/Build.html#MODEL), [제품 이름](http://developer.android.com/reference/android/os/Build.html#PRODUCT) 을 가져옵니다. 예를 들어 넥서스 하나 반환 합니다 `Passion` , 모토로라 Droid를 반환 합니다`voles`.
  65. ### Tizen 특수
  66. * 예를 들어, 공급 업체에 의해 할당 된 디바이스 모델을 반환 합니다.`TIZEN`
  67. ### Windows Phone 7, 8 특수
  68. * 제조업체에서 지정 하는 장치 모델을 반환 합니다. 예를 들어 삼성 포커스를 반환 합니다.`SGH-i917`.
  69. ## device.platform
  70. 장치의 운영 체제 이름을 얻을.
  71. var string = device.platform;
  72. ### 지원 되는 플랫폼
  73. * 안 드 로이드
  74. * 블랙베리 10
  75. * Browser4
  76. * Firefox 운영 체제
  77. * iOS
  78. * Tizen
  79. * Windows Phone 7과 8
  80. * 윈도우 8
  81. ### 빠른 예제
  82. // Depending on the device, a few examples are:
  83. // - "Android"
  84. // - "BlackBerry 10"
  85. // - Browser: returns "MacIntel" on Mac
  86. // returns "Win32" on Windows
  87. // - "iOS"
  88. // - "WinCE"
  89. // - "Tizen"
  90. var devicePlatform = device.platform;
  91. ### Windows Phone 7 단점
  92. Windows Phone 7 장치 보고 플랫폼으로`WinCE`.
  93. ### Windows Phone 8 단점
  94. Windows Phone 8 장치 보고 플랫폼으로`Win32NT`.
  95. ## device.uuid
  96. 소자의 보편적으로 고유 식별자 ([UUID](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. * 윈도우 8
  107. ### 빠른 예제
  108. / / 안 드 로이드: (문자열로 다시!) 임의의 64 비트 정수를 반환 합니다 / / 정수 장치의 첫 번째 부팅에서 생성 / / / / 블랙베리: 디바이스의 핀 번호를 반환 합니다 / / 이것은 9 자리 고유 정수 (문자열로 비록!) / / / / 아이폰: (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. * 윈도우 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;