إضافة حالة الجهاز في كوردوفا

 تُعرّف هذه الإضافة كائنًا عامًّا device، والذي يوفر معلومات حول عتاد وبرامج الجهاز. على الرغم من أن الكائن موجود في النطاق العام (global scope)، إلا أنه لن يكون متوفرًا إلا بعد إطلاق الحدث deviceready.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(device.cordova);
}‎

الإبلاغ عن مشكلات في هذا الإضافة على Apache Cordova issue tracker

التثبيت

cordova plugin add cordova-plugin-device‎

خاصيات

• device.cordova
• device.model
• device.platform
• device.uuid
• device.version
• device.manufacturer
• device.isVirtual
• device.serial

device.cordova

الحصول على إصدار كوردوفا المُثبَّت على الجهاز.

المنصات المدعومة

• أندرويد
• Browser
• iOS
• ويندوز
• OSX

device.model

تعيد device.model اسم طراز الجهاز أو المنتج. يتم تعيين القيمة من قِبل الشركة المصنعة للجهاز، وقد تختلف بين مختلف إصدارات المنتج.

المنصات المدعومة

• أندرويد
• Browser
• iOS
• ويندوز
• OSX

مثال سريع

// Android:    Nexus One       returns "Passion" (Nexus One code name)
//             Motorola Droid  returns "voles"
// BlackBerry: Torch 9800      returns "9800"
// Browser:    Google Chrome   returns "Chrome"
//             Safari          returns "Safari"
// iOS:     for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models
// OSX:                        returns "x86_64"
//
var model = device.model;‎

ملاحظات خاصة بمنصة أندرويد

• في منصة أندرويد يُعاد اسم المنتج product name بدلا من اسم الطراز model name، والذي غالبا ما يكون اسم كود الإنتاج (production code). على سبيل المثال، يُعيد الهاتف Nexus One القيمة Passion، وبعبد Motorola Droid القيمة voles.

device.platform

تعيد هذه الخاصية اسم نظام التشغيل الخاص بالجهاز.

var string = device.platform;‎

المنصات المدعومة

• أندرويد
• Browser
• iOS
• ويندوز
• OSX

مثال سريع

// Depending on the device, a few examples are:
//   - "Android"
//   - "BlackBerry 10"
//   - "browser"
//   - "iOS"
//   - "WinCE"
//   - "Tizen"
//   - "Mac OS X"
var devicePlatform = device.platform;‎

device.uuid

تعيد الخاصية المعرف الفريد العالمي للجهاز (UUID).

var string = device.uuid;‎

الوصف

يتم تحديد تفاصيل توليد قيمة المعرف الفريد العالمي للجهاز (UUID) من طرف الشركة المصنعة للجهاز، وتتعلق بمنصة للجهاز أو طرازه.

المنصات المدعومة

• أندرويد
• iOS
• ويندوز
• OSX

مثال سريع

// Android: Returns a random 64-bit integer (as a string, again!)
//          The integer is generated on the device's first boot
//
// BlackBerry: Returns the PIN number of the device
//             This is a nine-digit unique integer (as a string, though!)
//
// iPhone: (Paraphrased from the UIDevice Class documentation)
//         Returns the [UIDevice identifierForVendor] UUID which is unique and the same for all apps installed by the same vendor. However the UUID can be different if the user deletes all apps from the vendor and then reinstalls it.
// Windows Phone 7 : Returns a hash of device+current user,
// if the user is not defined, a guid is generated and will persist until the app is uninstalled
// Tizen: returns the device IMEI (International Mobile Equipment Identity or IMEI is a number
// unique to every GSM and UMTS mobile phone.
var deviceID = device.uuid;‎

ملاحظات خاصة بمنصة iOS

يستخدم المعرف الفريد العالمي للجهاز uuid على منصة iOS الخاصية identifierForVendor. فقيمتها واحدة لكل جهاز من الأجهزة المُصنعة من قبل نفس الشركة، ولكنها قيمتها تختلف بين الأجهزة المصنعة من بائعين مختلفين وستتغير إذا تم حذف جميع التطبيقات القادمة من البائع ثم إعادة تثبيتها. ارجع إلى هذه الصفحة here لمزيد من التفاصيل. ستكون قيمة UUID هي نفسها إذا استعيد التطبيق من نسخة احتياطية أو من السحابة iCloud لأنها تُحفظ في التفضيلات. الذين يستخدمون إصدارات قديمة من هذه الإضافة سيضلون يتلقون نفس قيمة UUID السابق المُولّد بوسائل أخرى، إذ أنه سيُسترد من التفضيلات.

ملاحظات خاصة بمنصة OSX

يتم إنشاء uuid على منصة OSX تلقائيًا إذا لم يكن موجودًا بعد، وسيُخزّن في standardUserDefaults في الخاصية CDVUUID.

device.version

تعيد هذه الخاصية إصدار نظام التشغيل.

var string = device.version;‎

المنصات المدعومة

• أندرويد 2.1 وما بعده
• Browser
• iOS
• ويندوز
• OSX

مثال سريع

// Android:    Froyo OS would return "2.2"
//             Eclair OS would return "2.1", "2.0.1", or "2.0"
//             Version can also return update level "2.1-update1"
//
// BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
//
// Browser:    Returns version number for the browser
//
// iPhone:     iOS 3.2 returns "3.2"
//
// Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
// Windows 8: return the current OS version, ex on Windows 8.1 returns 6.3.9600.16384
// Tizen: returns "TIZEN_20120425_2"
// OSX:        El Capitan would return "10.11.2"
//
var deviceVersion = device.version;‎

device.manufacturer

تعيد هذه الخاصية اسم الشركة المصنعة للجهاز.

var string = device.manufacturer;‎

المنصات المدعومة

• أندرويد
• iOS
• ويندوز

مثال سريع

// Android:    Motorola XT1032 would return "motorola"
// BlackBerry: returns "BlackBerry"
// iPhone:     returns "Apple"
//
var deviceManufacturer = device.manufacturer;‎

device.isVirtual

تحدد هذه الخاصية ما إذا كان الجهاز يعمل على جهاز محاكاة.

var isSim = device.isVirtual;‎

المنصات المدعومة

• أندرويد 2.1 وما بعده
• Browser
• iOS
• ويندوز
• OSX

ملاحظات خاصة بمنصتي OSX و Browser

تعيد الخاصية isVirtual على منصتي OS X و Browser القيمة false دائمًا.

device.serial

تعيد هذه الخاصية الرقم التسلسلي للجهاز (SERIAL).

var string = device.serial;‎

المنصات المدعومة

• أندرويد
• OSX

مصادر

• صفحة cordova-plugin-device في توثيق كوردوفا الرسمي.