مشاركة عبر

Device class

  • ‏‏المرجع
الحزمة:
azure-iothub

تحذير

واجهة برمجة التطبيقات هذه مهملة الآن.

إنشاء تمثيل لجهاز للاستخدام مع سجل هوية الجهاز واجهات برمجة التطبيقات.

هذه الفئة مهملة لأن سجل هوية الجهاز يمكن أن يعمل مباشرة مع كائنات JSON التي تحتوي على وصف جزئي للجهاز، وليس بالضرورة العنصر الكامل. علاوة على ذلك في البداية تم شحن هذه الفئة مع خطأ مطبعي على اسم الخاصية symmetricKey (كان pascal-cased بدلا من camel-cased). يحتفظ SDK بهذه الفئة من أجل عدم قطع التعليمات البرمجية الموجودة ولكن ستتم إزالة هذا في تحديث إصدار رئيسي مستقبلي ويجب على العملاء بدلا من ذلك استخدام كائنات JSON العادية.

المنشئون

Device(any)

إنشاء مثيل لكائن Device جديد.

الخصائص

authentication

يحتوي على المفاتيح المتماثلة المستخدمة لمصادقة هذا الجهاز.
capabilities

يحتوي على قدرات هذا الجهاز.
cloudToDeviceMessageCount

عدد الرسائل c2d التي تنتظر تسليمها إلى الجهاز.
connectionState

سواء كان الجهاز "متصلا" أو "غير متصل". لا ينصح باستخدام هذه الخاصية لتحديد ما إذا كان الجهاز متصلا بالفعل في الوقت الحالي، نظرا لأن اتصال الجهاز قد انقضى وقته وربما لم يكتشفه مركز IoT، أو إذا كان الجهاز يستخدم HTTPS للاتصال. إذا كانت لديك حاجة لمراقبة اتصالات الجهاز، فإن الطريقة المعاد الالتزام بها هي استخدام ميزة مراقبة عمليات المركز.
connectionStateUpdatedTime

الطابع الزمني الذي يمثل آخر مرة connectionState تغييرها.
deviceId

معرف الجهاز الفريد كما هو موجود في سجل جهاز مركز Azure IoT.
etag

علامة الكيان الضعيفة المعينة لوصف هوية الجهاز هذا
generationId

يستخدم لإزالة الغموض عن الأجهزة التي تم حذفها/إعادة إنشائها بنفس deviceId
lastActivityTime

الطابع الزمني الذي يمثل آخر مرة قام فيها الجهاز بالمصادقة أو إرسال رسالة أو تلقي رسالة.
status

"ممكن" (يمكن للجهاز المخول بالاتصال أو إرسال/تلقي الرسائل) أو "معطل".
statusReason

مجموعة سلسلة مكونة من 128 حرفا عند تعطيل الجهاز.
statusUpdatedTime

الطابع الزمني الذي يمثل آخر مرة status تغييرها.

تفاصيل المنشئ

Device(any)

إنشاء مثيل لكائن Device جديد.

new Device(jsonData?: any)

المعلمات

jsonData

any

تمثيل JSON اختياري للجهاز، والذي سيتم تعيينه إلى خصائص في الكائن. إذا لم يتم توفير أي وسيطة، تعيين قيم افتراضية لخصائص الجهاز.

تفاصيل الخاصية

authentication

يحتوي على المفاتيح المتماثلة المستخدمة لمصادقة هذا الجهاز.

authentication?: Authentication

قيمة الخاصية

Authentication

capabilities

يحتوي على قدرات هذا الجهاز.

capabilities?: Capabilities

قيمة الخاصية

Capabilities

cloudToDeviceMessageCount

عدد الرسائل c2d التي تنتظر تسليمها إلى الجهاز.

cloudToDeviceMessageCount?: string

قيمة الخاصية

string

connectionState

سواء كان الجهاز "متصلا" أو "غير متصل". لا ينصح باستخدام هذه الخاصية لتحديد ما إذا كان الجهاز متصلا بالفعل في الوقت الحالي، نظرا لأن اتصال الجهاز قد انقضى وقته وربما لم يكتشفه مركز IoT، أو إذا كان الجهاز يستخدم HTTPS للاتصال. إذا كانت لديك حاجة لمراقبة اتصالات الجهاز، فإن الطريقة المعاد الالتزام بها هي استخدام ميزة مراقبة عمليات المركز.

connectionState?: ConnectionState

قيمة الخاصية

ConnectionState

connectionStateUpdatedTime

الطابع الزمني الذي يمثل آخر مرة connectionState تغييرها.

connectionStateUpdatedTime?: string

قيمة الخاصية

string

deviceId

معرف الجهاز الفريد كما هو موجود في سجل جهاز مركز Azure IoT.

deviceId: string

قيمة الخاصية

string

etag

علامة الكيان الضعيفة المعينة لوصف هوية الجهاز هذا

etag?: string

قيمة الخاصية

string

generationId

يستخدم لإزالة الغموض عن الأجهزة التي تم حذفها/إعادة إنشائها بنفس deviceId

generationId?: string

قيمة الخاصية

string

lastActivityTime

الطابع الزمني الذي يمثل آخر مرة قام فيها الجهاز بالمصادقة أو إرسال رسالة أو تلقي رسالة.

lastActivityTime?: string

قيمة الخاصية

string

status

"ممكن" (يمكن للجهاز المخول بالاتصال أو إرسال/تلقي الرسائل) أو "معطل".

status?: DeviceStatus

قيمة الخاصية

DeviceStatus

statusReason

مجموعة سلسلة مكونة من 128 حرفا عند تعطيل الجهاز.

statusReason?: string

قيمة الخاصية

string

statusUpdatedTime

الطابع الزمني الذي يمثل آخر مرة status تغييرها.

statusUpdatedTime?: string

قيمة الخاصية

string