مكتبة عميل Azure iotHub ل JavaScript - الإصدار 6.3.0

  • مقالة

تحتوي هذه الحزمة على SDK غير متحول (يعمل في كل من Node.js والمستعرضات) لعميل Azure iotHub.

استخدم واجهة برمجة التطبيقات هذه لإدارة مراكز IoT في اشتراك Azure الخاص بك.

التعليمات البرمجية | المصدرالحزمة (NPM) | الوثائق | المرجعية لواجهة برمجة التطبيقاتعينات

الشروع في العمل

البيئات المعتمدة حاليًا

راجع سياسة الدعم الخاصة بنا لمزيد من التفاصيل.

المتطلبات الأساسية

تثبيت @azure/arm-iothubالحزمة

قم بتثبيت مكتبة عميل Azure iotHub ل JavaScript باستخدام npm:

npm install @azure/arm-iothub

إنشاء ومصادقة IotHubClient

لإنشاء كائن عميل للوصول إلى واجهة برمجة تطبيقات Azure iotHub، ستحتاج إلى endpoint مورد Azure iotHub الخاص بك و credential. يمكن لعميل Azure iotHub استخدام بيانات اعتماد Azure Active Directory للمصادقة. يمكنك العثور على نقطة النهاية لمورد Azure iotHub في مدخل Microsoft Azure.

يمكنك المصادقة باستخدام Azure Active Directory باستخدام بيانات اعتماد من مكتبة @azure/الهوية أو رمز AAD مميز موجود.

لاستخدام موفر DefaultAzureCredential الموضح أدناه، أو موفري بيانات الاعتماد الآخرين المقدمين مع Azure SDK، يرجى تثبيت الحزمة @azure/identity :

npm install @azure/identity

ستحتاج أيضا إلى تسجيل تطبيق AAD جديد ومنح حق الوصول إلى Azure iotHub عن طريق تعيين الدور المناسب لمدير الخدمة (ملاحظة: لن تمنح الأدوار مثل "Owner" الأذونات اللازمة). قم بتعيين قيم معرف العميل ومعرف المستأجر وسر العميل لتطبيق AAD كمتغيرات بيئة: AZURE_CLIENT_ID، ، AZURE_TENANT_ID. AZURE_CLIENT_SECRET

لمزيد من المعلومات حول كيفية إنشاء تطبيق Azure AD، راجع هذا الدليل.

const { IotHubClient } = require("@azure/arm-iothub");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new IotHubClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new IotHubClient(credential, subscriptionId);

حزمة JavaScript

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

المفاهيم الرئيسية

IotHubClient

IotHubClient هي الواجهة الأساسية للمطورين الذين يستخدمون مكتبة عميل Azure iotHub. استكشف الأساليب الموجودة على كائن العميل هذا لفهم الميزات المختلفة لخدمة Azure iotHub التي يمكنك الوصول إليها.

استكشاف الأخطاء وإصلاحها

تسجيل الدخول

قد يساعد تمكين التسجيل في الكشف عن معلومات مفيدة حول حالات الفشل. للاطلاع على سجل لطلبات HTTP واستجاباته، قم بتعيين AZURE_LOG_LEVELمتغير البيئة إلى info. بدلًا من ذلك، يمكن تمكين التسجيل في وقت التشغيل عن طريق الاتصال setLogLevelبـ @azure/logger:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

للحصول على إرشادات أكثر تفصيلا حول كيفية تمكين السجلات، يمكنك إلقاء نظرة على مستندات حزمة @azure/المسجل.

الخطوات التالية

يرجى إلقاء نظرة على دليل العينات للحصول على أمثلة مفصلة حول كيفية استخدام هذه المكتبة.

المساهمة

إذا كنت ترغب في المساهمة في هذه المكتبة، يرجى قراءة دليل المساهمة لمعرفة المزيد حول كيفية إنشاء التعليمات البرمجية واختبارها.

مرات الظهور