Przekazywanie plików z urządzeń do chmury

Usługa IoT Central umożliwia przekazywanie multimediów i innych plików z połączonych urządzeń do magazynu w chmurze. Można skonfigurować funkcję przekazywania plików w aplikacji usługi IoT Central, a następnie zaimplementować przekazywanie plików w kodzie urządzenia.

Możesz również zarządzać plikami przekazanymi przez urządzenia i wyświetlać je w wersji zapoznawczej w aplikacji usługi IoT Central.

Aby dowiedzieć się, jak skonfigurować przekazywanie plików przy użyciu interfejsu API REST usługi IoT Central, zobacz Dodawanie konfiguracji konta magazynu przekazywania plików.

Wymagania wstępne

Aby skonfigurować przekazywanie plików, musisz być administratorem w aplikacji usługi IoT Central.

Do przechowywania przekazanych plików potrzebne jest konto usługi Azure Storage i kontener. Jeśli nie masz konta magazynu i kontenera, utwórz konto magazynu w witrynie Azure Portal.

Konfigurowanie przekazywania plików urządzenia

Aby skonfigurować przekazywanie plików urządzenia:

1. Przejdź do sekcji Aplikacja w aplikacji.

2. Wybierz pozycję Magazyn plików urządzenia.

3. Wybierz konto magazynu i kontener do użycia. Jeśli konto magazynu znajduje się w innej subskrypcji platformy Azure niż aplikacja, wprowadź parametry połączenia konta magazynu.

4. Jeśli to konieczne, dostosuj limit czasu dla przesyłania, który określa, jak długo żądanie jest ważne. Można ustawić ją z zakresu od 1 do 24 godzin.

5. Aby umożliwić użytkownikom wyświetlanie przekazanych plików i zarządzanie nimi w usłudze IoT Central, ustaw opcję Włącz dostęp do pozycji Włączone.

6. Wybierz pozycję Zapisz. Gdy stan ma wartość Skonfigurowano, urządzenia mogą przekazywać pliki.

Wyłączanie przekazywania plików urządzenia

Aby wyłączyć przekazywanie plików z urządzenia w aplikacji IoT Central:

1. Przejdź do sekcji Aplikacja w aplikacji.

2. Wybierz pozycję Magazyn plików urządzenia.

3. Wybierz Usuń.

Kontrola dostępu do przekazanych plików

Użyj ról i uprawnień, aby kontrolować, kto może wyświetlać i usuwać przekazane pliki. Aby dowiedzieć się więcej, zobacz Zarządzanie użytkownikami i rolami w aplikacji > usługi IoT Central Zarządzanie urządzeniami.

Przekazywanie pliku z urządzenia

Usługa IoT Central używa funkcji przekazywania plików usługi IoT Hub, aby umożliwić urządzeniom przekazywanie plików. Przykładowy kod pokazujący sposób przekazywania plików z urządzenia można znaleźć w przykładzie urządzenia do przekazywania plików usługi IoT Central.

Wyświetlanie przekazanych plików i zarządzanie nimi

Jeśli włączysz dostęp do plików w konfiguracji przekazywania plików, użytkownicy z odpowiednimi uprawnieniami będą mogli wyświetlać i usuwać przekazane pliki.

Aby wyświetlić i usunąć przekazane pliki, przejdź do widoku Pliki dla urządzenia. Na tej stronie można zobaczyć miniatury przekazanych plików i przełączać się między galerią i widokiem listy. Każdy plik ma opcje pobierania lub usuwania:

Dostosuj widok listy, filtrując według nazwy pliku i wybierając kolumny do wyświetlenia.

Aby wyświetlić podgląd zawartości pliku i uzyskać więcej informacji o nim, wybierz ją. Usługa IoT Central obsługuje podglądy typowych typów plików, takich jak tekst i obrazy:

Testowanie przekazywania plików

Po skonfigurowaniu przekazywania plików w aplikacji usługi IoT Central przetestuj go przy użyciu przykładowego kodu. Użyj następujących poleceń, aby sklonować przykładowe repozytorium do odpowiedniej lokalizacji na komputerze lokalnym i zainstalować zależności:

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

Tworzenie szablonu urządzenia i importowanie modelu

Aby przetestować przekazywanie plików, uruchom przykładową aplikację urządzenia. Najpierw utwórz szablon urządzenia dla przykładowego urządzenia:

1. Otwórz aplikację w interfejsie użytkownika usługi IoT Central.

2. Przejdź do pozycji Szablony urządzeń w okienku po lewej stronie, a następnie wybierz pozycję + Nowy.

3. Wybierz urządzenie IoT dla typu szablonu.

4. Na stronie Dostosuj wprowadź nazwę, taką jak Przykład urządzenia do przesyłania plików dla szablonu urządzenia.

5. Na stronie Przegląd wybierz pozycję Utwórz.

6. Wybierz Importuj model i prześlij plik FileUploadDeviceDcm.json modelu z iotc-file-upload-device\setup folderu w pobranym wcześniej repozytorium.

7. Wybierz pozycję Publikuj , aby zakończyć tworzenie szablonu urządzenia.

Dodawanie urządzenia

Aby dodać urządzenie do aplikacji usługi Azure IoT Central:

1. Przejdź do pozycji Urządzenia w okienku po lewej stronie.

2. Wybierz utworzony wcześniej szablon przykładowego szablonu urządzenia przesyłania plików.

3. Wybierz pozycję + Nowy, a następnie wybierz pozycję Utwórz.

4. Wybierz utworzone urządzenie, a następnie wybierz pozycję Połącz.

Skopiuj wartości dla ID scope, Device IDi Primary key. Te wartości są używane w przykładowym kodzie urządzenia.

Uruchamianie przykładowego kodu

Otwórz repozytorium git pobrane w programie VS Code. Utwórz plik ".env" w katalogu głównym projektu i dodaj skopiowane wcześniej wartości. Plik powinien wyglądać podobnie do tego przykładu z twoimi wartościami:

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

Otwórz repozytorium git pobrane w programie VS Code. Aby uruchomić lub debugować przykład, naciśnij F5. W oknie terminalu zobaczysz rejestrowanie urządzenia i nawiązywanie połączenia z usługą 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
}

Przykładowy projekt zawiera przykładowy plik o nazwie datafile.json. Ten plik jest przekazywany podczas korzystania z polecenia Przekaż plik w aplikacji usługi IoT Central.

Aby przetestować przekazywanie, otwórz aplikację i wybierz utworzone urządzenie. Wybierz kartę Polecenie i wybierz przycisk Uruchom . Po wybraniu opcji Uruchom, aplikacja IoT Central wywołuje bezpośrednią metodę na urządzeniu, aby przesłać plik. Tę metodę bezpośrednią można zobaczyć w przykładowym kodzie w pliku /device.ts. Metoda nosi nazwę uploadFileCommand. Aby przetestować przekazywanie, otwórz aplikację i wybierz utworzone urządzenie. Wybierz kartę Polecenie , a następnie wybierz przycisk Uruchom . Po wybraniu pozycji Uruchom usługa IoT Central wywołuje metodę bezpośrednią na urządzeniu w celu przekazania pliku. Tę metodę można zobaczyć w przykładowym kodzie w pliku /device.ts . Metoda nosi nazwę uploadFileCommand.

Wybierz kartę Nieprzetworzone dane , aby sprawdzić stan przekazywania pliku.

Możesz również wykonać zapytanie do interfejsu API REST, aby sprawdzić stan przesyłania pliku w kontenerze pamięci masowej.