مشاركة عبر


azure-iothub package

الفصول

Client

يتم استخدام عميل خدمة IoT Hub للاتصال بالأجهزة من خلال مركز Azure IoT. يتيح لمستخدم SDK:

  • إرسال السحابة إلى الجهاز (المعروفة أيضا بالأوامر) إلى الأجهزة: يتم وضع الأوامر في قائمة الانتظار على IoT Hub ويتم تسليمها بشكل غير متزامن فقط عند توصيل الجهاز. يمكن وضع 50 أمر فقط في قائمة الانتظار لكل جهاز.
  • استدعاء أساليب مباشرة على الأجهزة (والتي ستعمل فقط إذا كان الجهاز متصلا حاليا: إنها طريقة متزامنة للتواصل مع الجهاز)
  • استمع إلى رسائل الملاحظات المرسلة بواسطة الأجهزة للأوامر السابقة.
  • استمع إلى إعلامات تحميل الملفات من الأجهزة.

يجب على المستخدمين إنشاء مثيلات Client جديدة عن طريق استدعاء أحد أساليب المصنع، منConnectionString أو منSharedAccessSignature، لإنشاء عميل خدمة IoT Hub.

Device

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

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

JobClient

يوفر أساليب لإنشاء وتحديث ومراقبة وإلغاء المهام طويلة الأمد على مثيل IoT Hub، بالإضافة إلى الاستعلام عن الوظائف الموجودة. تسمح واجهة برمجة تطبيقات الوظائف في Azure IoT Hub بجدولة استدعاءات الأسلوب المباشر والتحديثات المزدوجة على أجهزة متعددة.

من المتوقع أن يقوم مستخدمو SDK بإنشاء مثيلات JobClient باستخدام أساليب المصنع fromConnectionString(string)fromSharedAccessSignature(string).

Registry

توفر فئة التسجيل الوصول إلى خدمة هوية جهاز IoT Hub. يجب على مستخدمي SDK إنشاء مثيل لهذه الفئة باستخدام إحدى أساليب المصنع: منConnectionString أو منSharedAccessSignature.

البروتوكول المستخدم لعمليات تسجيل هوية الجهاز هو HTTPS.

Amqp

فئة النقل المستخدمة من قبل عميل خدمة للاتصال بمركز Azure IoT باستخدام بروتوكول AMQP عبر مأخذ توصيل آمن (TLS). لا يجب استخدام هذه الفئة مباشرة وبدلا من ذلك يتم تمريرها إلى إحدى أساليب المصنع Client: منConnectionString أو منSharedAccessSignature.

AmqpWs

فئة النقل المستخدمة من قبل عميل خدمة للاتصال بمركز Azure IoT باستخدام بروتوكول AMQP عبر websockets الآمنة. لا يجب استخدام هذه الفئة مباشرة وبدلا من ذلك يتم تمريرها إلى إحدى أساليب المصنع Client: منConnectionString أو منSharedAccessSignature.

DigitalTwinClient
IoTHubTokenCredentials

إنشاء توقيعات وصول مشتركة استنادا إلى سلسلة الاتصال التي تم تمريرها إلى الدالة الإنشائية. يتم استخدام هذه الفئة من قبل طبقة البروتوكول من SDK لإضافة عناوين المصادقة إلى كل طلب.

Twin

Device Twin هو مستند يصف حالة الجهاز المخزن بواسطة مركز Azure IoT وهو متوفر حتى إذا كان الجهاز غير متصل. وهو مبني حول 3 أقسام:

  • العلامات: أزواج المفاتيح/القيم التي يمكن الوصول إليها فقط من جانب الخدمة
  • الخصائص المطلوبة: تم تحديثها بواسطة خدمة وتلقيها من قبل الجهاز
  • الخصائص المبلغ عنها: تم تحديثها بواسطة الجهاز وتلقيها بواسطة الخدمة.

لاحظ أنه على الرغم من أنه احتمال، لا يجب أن تتطابق الخصائص المطلوبة والمبلغ عنها وأن المنطق لمزامنة هاتين المجموعتين، إذا لزم الأمر، يترك لمستخدم SDK.

لمزيد من المعلومات، راجع فهم توائم الجهاز.

الطريقة الموصى بها للحصول على Twin لجهاز معين هي استخدام أسلوب getTwin(string, HttpResponseCallback<Twin>).

الواجهات

ServiceReceiver
Transport
TransportConfigOptions
Authentication
Capabilities
X509Thumbprints
BulkRegistryOperationResult
DeviceDescription
DeviceRegistryOperationError
JobStatus
QueryDescription
RegistryStatistics
TransportConfig
Configuration

يمثل كائن التكوين تكوين جهاز واحد أو يمكن أن يمثل توزيعا يمكن تطبيقه كتكوين على الأجهزة استنادا إلى targetCondition.

ConfigurationContent
ConfigurationMetrics
DeviceMethodParams

توضح هذه المقالة المعلمات المتوفرة للاستخدام مع الأساليب المباشرة (تسمى أيضا أساليب الجهاز)

Module

النوع أسماء مستعارة

TransportCtor
ConnectionState
DeviceStatus
JobCallback
BulkRegistryOperationType
JobCallback
ResponseCallback