Sdílet prostřednictvím

Nahrání souborů ze zařízení do cloudu

IoT Central umožňuje nahrát média a další soubory z připojených zařízení do cloudového úložiště. V aplikaci IoT Central nakonfigurujete funkci nahrávání souborů a pak implementujete nahrávání souborů do kódu zařízení.

Můžete také spravovat a zobrazit náhled souborů nahraných zařízeními v aplikaci IoT Central.

Informace o konfiguraci nahrávání souborů pomocí rozhraní IoT Central REST API najdete v tématu Přidání konfigurace účtu úložiště pro nahrání souboru.

Požadavky

Abyste mohli konfigurovat nahrávání souborů, musíte být ve své aplikaci IoT Central správcem.

K uložení nahraných souborů potřebujete účet úložiště Azure a kontejner. Pokud nemáte účet úložiště a kontejner, vytvořte účet úložiště na webu Azure Portal.

Konfigurace nahrávání souborů zařízení

Konfigurace nahrávání souborů zařízení:

  1. Přejděte do části Aplikace ve vaší aplikaci.

  2. Vyberte Úložiště souborů zařízení.

  3. Vyberte účet úložiště a kontejner, který chcete použít. Pokud je účet úložiště v jiném předplatném Azure než vaše aplikace, zadejte připojovací řetězec účtu úložiště.

  4. V případě potřeby upravte časový limit nahrávání, který nastaví, jak dlouho je požadavek platný. Můžete ho nastavit od 1 do 24 hodin.

  5. Pokud chcete uživatelům umožnit zobrazování a správu nahraných souborů v IoT Central, nastavte Povolit přístup na zapnuto.

  6. Zvolte Uložit. Když se zobrazí stav Konfigurace, můžou zařízení nahrávat soubory.

Snímek obrazovky znázorňující správně nakonfigurované nahrávání souborů

Zakázání nahrávání souborů zařízení

Vypnutí nahrávání souborů zařízení v aplikaci IoT Central:

  1. Přejděte do části Aplikace ve vaší aplikaci.

  2. Vyberte Úložiště souborů zařízení.

  3. Vyberte Odstranit.

Řízení přístupu k nahraných souborů

Pomocí rolí a oprávnění můžete určit, kdo může zobrazovat a odstraňovat nahrané soubory. Další informace najdete v tématu Správa uživatelů a rolí v aplikaci > IoT Central Správa zařízení.

Nahrání souboru ze zařízení

IoT Central používá funkci nahrávání souborů služby IoT Hub, která umožňuje zařízením nahrávat soubory. Ukázkový kód, který ukazuje, jak nahrát soubory ze zařízení, najdete v ukázce zařízení pro nahrání souboru IoT Central.

Zobrazení a správa nahraných souborů

Pokud v konfiguraci nahrávání souborů zapnete přístup k souborům, můžou uživatelé se správnými oprávněními zobrazovat a odstraňovat nahrané soubory.

Důležité

Všechny soubory ve složce kontejneru objektů blob přidružené k zařízení se zobrazí v zobrazení Soubory pro toto zařízení, včetně všech souborů, které zařízení nenahrálo.

Pokud chcete zobrazit a odstranit nahrané soubory, přejděte do zobrazení Soubory pro zařízení. Na této stránce můžete zobrazit miniatury nahraných souborů a přepínat mezi zobrazením galerie a seznamu. Každý soubor má možnosti stáhnout nebo odstranit:

Snímek obrazovky znázorňující zobrazení galerie pro nahrané soubory

Návod

Typ MIME přiřazený k souboru při nahrání do úložiště objektů blob určuje jeho typ souboru. Výchozí typ je binary/octet-stream.

Přizpůsobte zobrazení seznamu filtrováním podle názvu souboru a výběrem sloupců, které se mají zobrazit.

Pokud chcete zobrazit náhled obsahu souboru a získat o něm další informace, vyberte ho. IoT Central podporuje náhledy běžných typů souborů, jako je text a obrázky:

Snímek obrazovky znázorňující náhled textového souboru

Nahrání testovacího souboru

Jakmile nakonfigurujete nahrávání souborů v aplikaci IoT Central, otestujte ho pomocí ukázkového kódu. Pomocí následujících příkazů naklonujte ukázkové úložiště do vhodného umístění na místním počítači a nainstalujte závislosti:

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

Vytvoření šablony zařízení a import modelu

Pokud chcete otestovat nahrání souboru, spusťte ukázkovou aplikaci zařízení. Nejprve vytvořte šablonu zařízení pro ukázkové zařízení:

  1. Otevřete aplikaci v uživatelském rozhraní IoT Central.

  2. V levém podokně přejděte na Šablony zařízení a pak vyberte + Nový.

  3. Jako typ šablony vyberte zařízení IoT .

  4. Na stránce Přizpůsobit zadejte název, například ukázka zařízení pro nahrání souboru pro šablonu zařízení.

  5. Na stránce Revize vyberte Vytvořit.

  6. Vyberte Importovat model a nahrajte soubor modelu FileUploadDeviceDcm.json ze iotc-file-upload-device\setup složky v úložišti, které jste si stáhli dříve.

  7. Výběrem možnosti Publikovat dokončete vytváření šablony zařízení.

Přidání zařízení

Přidání zařízení do aplikace Azure IoT Central:

  1. V levém podokně přejděte na Zařízení .

  2. Vyberte šablonu zařízení File Upload Device Sample, kterou jste vytvořili dříve.

  3. Vyberte + Nový a pak vyberte Vytvořit.

  4. Vyberte zařízení, které jste vytvořili, a pak vyberte Připojit.

Zkopírujte hodnoty pro ID scope, Device IDa Primary key. Tyto hodnoty použijete v ukázkovém kódu zařízení.

Spuštění ukázkového kódu

Otevřete úložiště Git, které jste stáhli ve VS Code. Vytvořte soubor .env v kořenovém adresáři projektu a přidejte hodnoty, které jste zkopírovali dříve. Soubor by měl vypadat jako v této ukázce s vašimi hodnotami:

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

Otevřete úložiště Git, které jste stáhli ve VS Code. Pokud chcete ukázku spustit nebo ladit, stiskněte klávesu F5. V okně terminálu se zobrazí registrace zařízení a připojení k 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
}

Ukázkový projekt obsahuje ukázkový soubor s názvem datafile.json. Tento soubor se nahraje, když v aplikaci IoT Central použijete příkaz Nahrát soubor .

Pokud chcete nahrávání otestovat, otevřete aplikaci a vyberte zařízení, které jste vytvořili. Vyberte kartu Příkaz a vyberte tlačítko Spustit . Když vyberete Spustit, aplikace IoT Central zavolá přímou metodu na vašem zařízení pro nahrání souboru. Tuto přímou metodu si můžete prohlédnout v ukázkovém kódu v souboru /device.ts. Metoda má název uploadFileCommand. Pokud chcete nahrávání otestovat, otevřete aplikaci a vyberte zařízení, které jste vytvořili. Vyberte kartu Příkaz a pak vyberte tlačítko Spustit . Když vyberete Spustit, IoT Central zavolá přímou metodu na vašem zařízení pro nahrání souboru. Tuto metodu můžete zobrazit v ukázkovém kódu v souboru /device.ts . Metoda má název uploadFileCommand.

Vyberte kartu Nezpracovaná data a zkontrolujte stav nahrání souboru.

Snímek obrazovky znázorňující, jak ověřit nahrání souboru U

Můžete také uskutečnit volání na rozhraní REST API a zkontrolovat stav nahrání souboru v kontejneru úložiště.

  • Last updated on