Mengunggah file dari perangkat Anda ke cloud

Artikel
06/24/2024

IoT Central memungkinkan Anda mengunggah media dan file lain dari perangkat yang tersambung ke penyimpanan cloud. Anda mengonfigurasi kemampuan pengunggahan file di aplikasi IoT Central Anda, lalu menerapkan pengunggahan file di kode perangkat Anda.

Secara opsional, Anda dapat mengelola dan mempratinjau file yang diunggah oleh perangkat Anda di dalam aplikasi IoT Central Anda.

Untuk mempelajari cara mengonfigurasi unggahan file dengan menggunakan IoT Central REST API, lihat Menambahkan konfigurasi akun penyimpanan unggahan file.

Prasyarat

Anda harus menjadi administrator di aplikasi IoT Central Anda untuk mengonfigurasi pengunggahan file.

Anda memerlukan akun penyimpanan dan kontainer Azure untuk menyimpan file yang diunggah. Jika Anda tidak memiliki akun penyimpanan dan kontainer yang sudah ada untuk digunakan, buat akun penyimpanan baru di portal Azure.

Mengonfigurasi pengunggahan file perangkat

Untuk mengonfigurasi pengunggahan file perangkat:

Navigasi ke bagian Aplikasi di aplikasi Anda.
Pilih Penyimpanan file perangkat.
Pilih akun penyimpanan dan kontainer yang akan digunakan. Jika akun penyimpanan berada dalam langganan Azure yang berbeda dari aplikasi Anda, masukkan string koneksi akun penyimpanan.
Jika perlu, sesuaikan batas waktu upload yang menetapkan berapa lama permintaan upload tetap berlaku. Nilai yang valid adalah dari 1 hingga 24 jam.
Untuk memungkinkan pengguna melihat dan mengelola file yang diunggah di dalam IoT Central, atur Aktifkan akses ke Aktif.
Pilih Simpan. Saat status menampilkan Dikonfigurasi, Anda siap mengunggah file dari perangkat.

Menonaktifkan pengunggahan file perangkat

Jika Anda ingin menonaktifkan pengunggahan file perangkat ke aplikasi IoT Central Anda:

Navigasi ke bagian Aplikasi di aplikasi Anda.
Pilih Penyimpanan file perangkat.
Pilih Hapus.

Mengontrol akses ke file yang diunggah

Gunakan peran dan izin untuk mengontrol siapa yang dapat melihat dan menghapus file yang diunggah. Untuk mempelajari selengkapnya, lihat Mengelola pengguna dan peran di aplikasi > IoT Central Anda Mengelola perangkat.

Mengunggah file dari perangkat

IoT Central menggunakan kemampuan pengunggahan file IoT Hub untuk memungkinkan perangkat mengunggah file. Untuk contoh kode yang menunjukkan cara mengunggah file dari perangkat, lihat sampel perangkat pengunggahan file IoT Central.

Menampilkan dan mengelola file yang diunggah

Jika Anda mengaktifkan akses ke file dalam konfigurasi unggahan file, pengguna dengan izin yang benar dapat melihat dan menghapus file yang diunggah.

Penting

Semua file dalam folder kontainer blob yang terkait dengan perangkat terlihat dalam tampilan File untuk perangkat tersebut. Ini termasuk file apa pun yang tidak diunggah oleh perangkat.

Untuk melihat dan menghapus file yang diunggah, navigasikan ke tampilan File untuk perangkat. Di halaman ini, Anda dapat melihat gambar mini file yang diunggah dan beralih antara galeri dan tampilan daftar. Setiap file memiliki opsi untuk mengunduh atau menghapusnya:

Tip

Jenis file ditentukan oleh jenis mime yang ditetapkan ke file ketika diunggah ke penyimpanan blob. Jenis defaultnya adalah binary/octet-stream.

Anda bisa mengkustomisasi tampilan daftar dengan memfilter berdasarkan nama file dan memilih kolom yang akan ditampilkan.

Untuk mempratinjau konten file dan mendapatkan informasi selengkapnya tentang file, pilih. IoT Central mendukung pratinjau jenis file umum seperti teks dan gambar:

Uji unggahan file

Setelah mengonfigurasi unggahan file di aplikasi IoT Central, Anda dapat mengujinya dengan kode sampel. Jika Anda belum mengkloning repositori sampel unggahan file, gunakan perintah berikut untuk mengkloningnya ke lokasi yang sesuai di komputer lokal Anda dan instal paket dependen:

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

Membuat templat perangkat dan mengimpor model

Untuk menguji unggahan file, Anda menjalankan aplikasi perangkat sampel. Buat templat perangkat untuk perangkat sampel yang akan digunakan.

Buka aplikasi Anda di UI IoT Central.
Navigasi ke tab Templat Perangkat di panel kiri, pilih + Baru:
Pilih perangkat IoT sebagai jenis templat.
Pada halaman Kustomisasi wizard, masukkan nama seperti Sampel Perangkat Unggah File untuk templat perangkat.
Pada halaman Tinjau, pilih Buat.
Pilih Impor model dan unggah file model FileUploadDeviceDcm.json dari folder iotc-file-upload-device\setup di repositori yang Anda unduh sebelumnya.
Pilih Terbitkan untuk menerbitkan templat perangkat.

Menambahkan perangkat

Untuk menambahkan perangkat ke aplikasi Azure IoT Central Anda:

Pilih Perangkat di panel kiri.
Pilih templat perangkat Sampel Perangkat Unggah File yang Anda buat sebelumnya.
Pilih + Baru dan pilih Buat.
Pilih perangkat yang Anda buat dan Pilih Sambungkan

Salin nilai untuk ID scope, Device ID, dan Primary key. Anda menggunakan nilai-nilai ini dalam kode sampel perangkat.

Jalankan kode sampel

Buka repositori git yang Anda unduh di Visual Studio Code. Buat file ".env" di akar proyek Anda dan tambahkan nilai yang Anda salin sebelumnya. File akan terlihat seperti sampel berikut dengan nilai yang Anda catat sebelumnya.

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

Buka repositori git yang Anda unduh di Visual Studio Code. Tekan F5 untuk menjalankan/men-debug sampel. Di jendela terminal Anda, Anda melihat bahwa perangkat terdaftar dan terhubung ke 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
}

Proyek sampel dilengkapi dengan file sampel bernama datafile.json. File ini diunggah saat Anda menggunakan perintah Unggah File di aplikasi IoT Central Anda.

Untuk menguji unggahan, buka aplikasi Anda dan pilih perangkat yang Anda buat. Pilih tab Perintah dan Anda melihat tombol bernama Jalankan. Saat Anda memilih tombol tersebut, aplikasi IoT Central memanggil metode langsung di perangkat Anda untuk mengunggah file. Anda dapat melihat metode langsung ini dalam kode sampel dalam file /device.ts. Metode ini diberi nama uploadFileCommand.

Pilih tab Data mentah untuk memverifikasi status unggahan file.

Cuplikan layar memperlihatkan U I tentang cara memverifikasi unggahan file.

Anda juga dapat melakukan panggilan REST API untuk memverifikasi status unggahan file di kontainer penyimpanan.

Bagikan melalui