azure-iothub package

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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