azure-iot-device package

يتم استخدام الكائن Message لبيانات تتبع الاستخدام (من جهاز إلى سحابة) والأوامر (من السحابة إلى الجهاز) المراسلة غير المتزامنة بين الجهاز وخدمة IoT Hub. وهو غير محدد النقل، ما يعني أنه يعمل بنفس الطريقة عبر AMQP وMQTT وHTTP.

يستخدم عميل جهاز IoT Hub لتوصيل جهاز بمركز Azure IoT.

يجب على مستخدمي SDK استدعاء أحد أساليب المصنع، منConnectionString أو منSharedAccessSignature لإنشاء عميل جهاز IoT Hub.

يمثل البيانات التي تم تمريرها من الخدمة إلى الجهاز عند استدعاء أسلوب جهاز من السحابة. يتم تمرير مثيل هذه الفئة إلى رد الاتصال المسجل عبر onDeviceMethod(string, (request: DeviceMethodRequest, response: DeviceMethodResponse) => void).

يتم توفير كائن DeviceMethodResponse للمستخدم مع كل DeviceMethodRequest مما يسمح للمستخدم بإنشاء وإرسال استجابة منسقة بشكل جيد مرة أخرى إلى الخدمة لكل استدعاء أسلوب جهاز. يتم تمرير مثيل هذه الفئة كمعلمة ثانية إلى رد الاتصال المسجل عبر onDeviceMethod(string, (request: DeviceMethodRequest, response: DeviceMethodResponse) => void).

يوفر تنفيذا AuthenticationProvider يفوض إنشاء الرمز المميز إلى iotedged. من المفترض استخدام هذا التنفيذ عند استخدام عميل الوحدة النمطية مع Azure IoT Edge.

يرث هذا النوع من SharedAccessKeyAuthenticationProvider ويتطابق وظيفيا مع هذا النوع باستثناء جزء إنشاء الرمز المميز الذي يتجاوزه عن طريق تنفيذ أسلوب _sign.

يستخدم عميل جهاز IoT Hub لتوصيل جهاز بمركز Azure IoT.

يجب على مستخدمي SDK استدعاء أحد أساليب المصنع، منConnectionString أو منSharedAccessSignature لإنشاء عميل جهاز IoT Hub.

يوفر كائن AuthenticationProvider يمكن إنشاؤه ببساطة باستخدام سلسلة اتصال ثم يستخدمه عميل الجهاز وينقل للمصادقة مع مثيل مركز Azure IoT.

يهتم الكائن SharedAccessKeyAuthenticationProvider بإنشاء رموز مميزة لتوقيع الوصول المشترك على إيقاع منتظم ويبعث الحدث newTokenAvailable للنقل لتجديد بيانات الاعتماد الخاصة بهم باستخدام مثيل مركز Azure IoT والبقاء على اتصال.

يوفر كائن AuthenticationProvider يمكن إنشاؤه ببساطة بتوقيع وصول مشترك ثم يستخدمه عميل الجهاز وينقل للمصادقة مع مثيل مركز Azure IoT.

لا يجدد الكائن SharedAccessSignatureAuthenticationProvider الرمز المميز لتوقيع الوصول المشترك تلقائيا، لذلك يحتاج المستخدم إلى تغذية رموز توقيع الوصول المشترك غير المنتهية الصلاحية إليه باستخدام أسلوب updateSharedAccessSignature. لكل استدعاء لهذا الأسلوب، سيبعث SharedAccessSignatureAuthenticationProvider حدث newTokenAvailable الذي سيستخدمه النقل للمصادقة مع مثيل مركز Azure IoT.

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

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

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

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

يوفر كائن AuthenticationProvider يمكن إنشاؤه ببساطة باستخدام شهادة ومفتاح X509 ثم يستخدمه عميل الجهاز وينقل للمصادقة مع مثيل مركز Azure IoT.

على عكس SharedAccessSignatureAuthenticationProvider والكائنات SharedAccessKeyAuthenticationProvider، لا يصدر X509AuthenticationProvider حدث newTokenAvailable نظرا لعدم وجود رمز مميز مضمن في مصادقة X509. ستحصل عمليات النقل على بيانات الاعتماد باستخدام أسلوب getDeviceCredentials.

الخيارات الخاصة بنقل AMQP.

يتم تمرير هذا إلى setOptions كخاصية تسمى http داخل كائن DeviceClientOptions.

رأى

خيارات لكائن العميل. تم تمريرها إلى وظيفة setOptions.

المثال

 var options = {
   cert: myX509Certificate,
   key: myX509Key,
   http: {
     receivePolicy: {
       interval: 10
     }
   }
 }
 client.setOptions(options, callback);

بنية الخيارات المستخدمة لتكوين عدد مرات استقصاء مستقبل HTTP للرسائل. كل خيار من هذه الخيارات حصري بشكل متبادل، باستثناء drain المنطقية. يجب أن يكون هناك intervalأو atأو cron أو manualPolling واحد فقط في بنية الخيارات.

يتم تكوين هذا عن طريق استدعاء setOptions مع هذا كخاصية تسمى receivePolicy داخل كائن httpTransportOptions الموجود داخل كائن DeviceClientOptions.

رأى

بنية الخيارات لتمرير معلمات التكوين الاختيارية إلى نقل Http.

يتم تمرير هذا إلى setOptions كخاصية تسمى http داخل كائن DeviceClientOptions.

رأى

الخيارات الخاصة بنقل MQTT

يتم تمرير هذا إلى setOptions كخاصية تسمى mqtt داخل كائن DeviceClientOptions.

يحتوي على الخصائص المطلوبة والمبلغ عنها للتوائم.