تحميل الملفات من أجهزتك إلى السحابة

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

اختياريا، يمكنك إدارة الملفات التي تم تحميلها بواسطة أجهزتك داخل تطبيق IoT Central الخاص بك ومعاينتها.

لمعرفة كيفية تكوين تحميلات الملفات باستخدام واجهة برمجة تطبيقات REST ل IoT Central، راجع إضافة تكوين حساب تخزين تحميل ملف.

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

يجب أن تكون مسؤولا في تطبيق IoT Central لتكوين تحميلات الملفات.

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

تكوين تحميلات ملفات الجهاز

لتكوين تحميلات ملفات الجهاز:

1. انتقل إلى قسم التطبيق في التطبيق الخاص بك.

2. حدد تخزين ملفات الجهاز.

3. حدد حساب التخزين والحاوية لاستخدامها. إذا كان حساب التخزين في اشتراك Azure مختلف عن التطبيق الخاص بك، أدخل حساب تخزين سلسلة الاتصال.

4. إذا لزم الأمر، اضبط مهلة التحميل التي تحدد المدة التي يظل فيها طلب التحميل صالحا. تتراوح القيم الصالحة من 1 إلى 24 ساعة.

5. لتمكين المستخدمين من عرض الملفات التي تم تحميلها وإدارتها داخل IoT Central، قم بتعيين تمكين الوصول إلى تشغيل.

6. حدد حفظ. عندما تظهر الحالة Configured، تكون جاهزا لتحميل الملفات من الأجهزة.

تعطيل تحميلات ملفات الجهاز

إذا كنت ترغب في تعطيل تحميلات ملفات الجهاز إلى تطبيق IoT Central الخاص بك:

1. انتقل إلى قسم التطبيق في التطبيق الخاص بك.

2. حدد تخزين ملفات الجهاز.

3. حدد حذف.

التحكم في الوصول إلى الملفات التي تم تحميلها

استخدم الأدوار والأذونات للتحكم في من يمكنه عرض الملفات التي تم تحميلها وحذفها. لمعرفة المزيد، راجع إدارة المستخدمين والأدوار في أجهزة إدارة تطبيقات > IoT Central.

تحميل ملف من جهاز

يستخدم IoT Central إمكانية تحميل الملفات في IoT Hub لتمكين الأجهزة من تحميل الملفات. للحصول على نموذج التعليمات البرمجية الذي يوضح لك كيفية تحميل الملفات من جهاز، راجع نموذج جهاز تحميل ملف IoT Central.

عرض الملفات التي تم تحميلها وإدارتها

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

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

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

لمعاينة محتوى الملف والحصول على مزيد من المعلومات حول الملف، حدده. يدعم IoT Central معاينات أنواع الملفات الشائعة مثل النصوص والصور:

اختبار تحميل الملف

بعد تكوين تحميلات الملفات في تطبيق IoT Central، يمكنك اختباره باستخدام نموذج التعليمات البرمجية. إذا لم تكن قد نسخت بالفعل مستودع عينة تحميل الملف، فاستخدم الأوامر التالية لاستنساخه إلى موقع مناسب على جهازك المحلي وتثبيت الحزم التابعة:

git clone https://github.com/azure-Samples/iot-central-file-upload-device
cd iotc-file-upload-device
npm i
npm build

إنشاء قالب الجهاز واستيراد النموذج

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

1. افتح تطبيقك في واجهة مستخدم IoT Central.

2. انتقل إلى علامة التبويب Device Templates في الجزء الأيمن، وحدد + New:

3. اختر جهاز IoT كنوع القالب.

4. في صفحة تخصيص المعالج، أدخل اسما مثل File Upload Device Sample لقالب الجهاز.

5. في صفحة مراجعة+ إنشاء حدد إنشاء.

6. حدد استيراد نموذج وتحميل ملف نموذج FileUploadDeviceDcm.json من المجلد iotc-file-upload-device\setup في المستودع الذي قمت بتنزيله مسبقا.

7. حدد نشر لنشر قالب الجهاز.

أضف جهاز

لإضافة جهاز إلى تطبيق Azure IoT Central:

1. اختر الأجهزة في الجزء الأيمن.

2. حدد قالب File Upload Device Sample الذي قمت بإنشائه سابقا.

3. حدد + جديد وحدد إنشاء.

4. حدد الجهاز الذي قمت بإنشائه وحدد اتصال

انسخ قيم ID scopeو Device IDو.Primary key يمكنك استخدام هذه القيم في نموذج التعليمات البرمجية للجهاز.

شغل التعليمات البرمجية النموذجية

افتح مستودع git الذي قمت بتنزيله في VS Code. أنشئ ملف ".env" في جذر المشروع وأضف القيم التي نسختها مسبقا. يجب أن يبدو الملف مثل النموذج التالي مع القيم التي قمت بتدوينها مسبقا.

scopeId=<YOUR_SCOPE_ID>
deviceId=<YOUR_DEVICE_ID>
deviceKey=<YOUR_PRIMARY_KEY>
modelId=dtmi:IoTCentral:IotCentralFileUploadDevice;1

افتح مستودع git الذي قمت بتنزيله في VS Code. اضغط على F5 لتشغيل/تصحيح العينة. في نافذة المحطة الطرفية، ترى أن الجهاز مسجل ومتصل ب IoT Central:

Starting IoT Central device...
 > Machine: Windows_NT, 8 core, freemem=6674mb, totalmem=16157mb
Starting device registration...
DPS registration succeeded
Connecting the device...
IoT Central successfully connected device: 7z1xo26yd8
Sending telemetry: {
    "TELEMETRY_SYSTEM_HEARTBEAT": 1
}
Sending telemetry: {
    "TELEMETRY_SYSTEM_HEARTBEAT": 1
}
Sending telemetry: {
    "TELEMETRY_SYSTEM_HEARTBEAT": 1
}

يأتي نموذج المشروع مع نموذج ملف يسمى datafile.json. يتم تحميل هذا الملف عند استخدام الأمر تحميل ملف في تطبيق IoT Central.

لاختبار التحميل، افتح التطبيق الخاص بك وحدد الجهاز الذي أنشأته. حدد علامة التبويب Command وشاهد زرا يسمى Run. عند تحديد هذا الزر، يستدعي تطبيق IoT Central أسلوبا مباشرا على جهازك لتحميل الملف. يمكنك مشاهدة هذا الأسلوب المباشر في نموذج التعليمات البرمجية في ملف /device.ts. يسمى الأسلوب uploadFileCommand.

حدد علامة التبويب Raw data للتحقق من حالة تحميل الملف.

يمكنك أيضا إجراء استدعاء REST API للتحقق من حالة تحميل الملف في حاوية التخزين.