Partilhar via

Carregue ficheiros dos seus dispositivos para a nuvem

O IoT Central permite carregar mídia e outros arquivos de dispositivos conectados para o armazenamento em nuvem. Configure a capacidade de carregamento de ficheiros na aplicação IoT Central e, em seguida, implemente carregamentos de ficheiros no código do dispositivo.

Você também pode gerenciar e visualizar arquivos carregados por seus dispositivos dentro do aplicativo IoT Central.

Para saber como configurar carregamentos de arquivos usando a API REST do IoT Central, consulte Adicionar uma configuração de conta de armazenamento de carregamento de arquivo.

Pré-requisitos

Você precisa ser um administrador em seu aplicativo IoT Central para configurar carregamentos de arquivos.

Você precisa de uma conta de armazenamento do Azure e um contêiner para armazenar os arquivos carregados. Se você não tiver uma conta de armazenamento e um contêiner, crie uma conta de armazenamento no portal do Azure.

Configurar carregamentos de arquivos de dispositivo

Para configurar carregamentos de arquivos de dispositivo:

  1. Vá para a seção Aplicativo em seu aplicativo.

  2. Selecione Armazenamento de arquivos do dispositivo.

  3. Selecione a conta de armazenamento e o contêiner a serem usados. Se a conta de armazenamento estiver em uma assinatura do Azure diferente do seu aplicativo, insira uma cadeia de conexão de conta de armazenamento.

  4. Se necessário, ajuste o tempo limite de carregamento que define por quanto tempo uma solicitação é válida. Você pode configurá-lo de 1 a 24 horas.

  5. Para permitir que os usuários visualizem e gerenciem arquivos carregados no IoT Central, defina Habilitar acesso como Ativado.

  6. Selecione Guardar. Quando o status mostra Configurado, os dispositivos podem carregar arquivos.

Captura de tela que mostra um upload de arquivo configurado corretamente.

Desativar carregamentos de ficheiros de dispositivo

Para desativar o carregamento de arquivos de dispositivo em seu aplicativo IoT Central:

  1. Navegue até a seção Aplicativo em seu aplicativo.

  2. Selecione Armazenamento de arquivos do dispositivo.

  3. Selecione Eliminar.

Controlar o acesso aos ficheiros carregados

Use funções e permissões para controlar quem pode exibir e excluir arquivos carregados. Para saber mais, consulte Gerenciar usuários e funções em seu aplicativo > IoT Central Gerenciando dispositivos.

Carregar um ficheiro a partir de um dispositivo

O IoT Central usa o recurso de upload de arquivos do Hub IoT para permitir que os dispositivos carreguem arquivos. Para obter um código de exemplo que mostra como carregar arquivos de um dispositivo, consulte o Exemplo de dispositivo de carregamento de arquivos do IoT Central.

Ver e gerir ficheiros carregados

Se você ativar o acesso a arquivos na configuração de upload de arquivos, os usuários com as permissões corretas poderão visualizar e excluir os arquivos carregados.

Importante

Todos os arquivos na pasta de contêiner de blob associada a um dispositivo aparecem na visualização Arquivos desse dispositivo, incluindo todos os arquivos que o dispositivo não carregou.

Para ver e eliminar ficheiros carregados, aceda à vista Ficheiros de um dispositivo. Nesta página, pode ver miniaturas dos ficheiros carregados e alternar entre uma vista de galeria e de lista. Cada arquivo tem opções para baixá-lo ou excluí-lo:

Captura de ecrã que mostra a vista de galeria dos ficheiros carregados.

Gorjeta

O tipo MIME atribuído ao ficheiro quando foi enviado para o armazenamento de blob define o seu tipo de ficheiro. O tipo padrão é binary/octet-stream.

Personalize a exibição de lista filtrando por nome de arquivo e escolhendo as colunas a serem exibidas.

Para visualizar o conteúdo do arquivo e obter mais informações sobre ele, selecione-o. O IoT Central suporta visualizações de tipos de arquivos comuns, como texto e imagens:

Captura de ecrã que mostra uma pré-visualização de um ficheiro de texto.

Upload de arquivo de teste

Depois de configurar os carregamentos de arquivos em seu aplicativo IoT Central, teste-o com o código de exemplo. Use os seguintes comandos para clonar o repositório de exemplo para um local adequado em sua máquina local e instalar as dependências:

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

Criar o modelo de dispositivo e importar o modelo

Para testar o carregamento de ficheiros, execute a aplicação de dispositivo de exemplo. Primeiro, crie um modelo de dispositivo para o dispositivo de exemplo:

  1. Abra seu aplicativo na interface do usuário do IoT Central.

  2. Vá para Modelos de dispositivo no painel esquerdo e selecione + Novo.

  3. Selecione Dispositivo IoT para o tipo de modelo.

  4. Na página Personalizar , insira um nome, como Exemplo de dispositivo de carregamento de arquivo , para o modelo de dispositivo.

  5. Na página Revisão, selecione Criar.

  6. Selecione Importar um modelo e carregue o arquivo de modelo FileUploadDeviceDcm.json da iotc-file-upload-device\setup pasta no repositório que você baixou anteriormente.

  7. Selecione Publicar para concluir a criação do modelo de dispositivo.

Adicionar um dispositivo

Para adicionar um dispositivo ao seu aplicativo do Azure IoT Central:

  1. Vá para Dispositivos no painel esquerdo.

  2. Selecione o modelo de dispositivo File Upload Device Sample criado anteriormente.

  3. Selecione + Novo e, em seguida, selecione Criar.

  4. Selecione o dispositivo que criou e, em seguida, selecione Ligar.

Copie os valores de ID scope, Device IDe Primary key. Use esses valores no código de exemplo do dispositivo.

Execute o código de exemplo

Abra o repositório git que você baixou no VS Code. Crie um arquivo ".env" na raiz do seu projeto e adicione os valores copiados anteriormente. O arquivo deve se parecer com este exemplo, com seus valores:

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

Abra o repositório git que você baixou no VS Code. Para executar ou depurar o exemplo, pressione F5. Na janela do terminal, você vê o registro do dispositivo e se conecta ao 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
}

O projeto de exemplo inclui um arquivo de exemplo chamado datafile.json. Esse arquivo é carregado quando você usa o comando Carregar arquivo em seu aplicativo IoT Central.

Para testar o upload, abra seu aplicativo e selecione o dispositivo que você criou. Selecione a guia Comando e selecione o botão Executar . Quando você seleciona Executar, o aplicativo IoT Central chama um método direto em seu dispositivo para carregar o arquivo. Você pode ver esse método direto no código de exemplo no arquivo /device.ts. O método é chamado uploadFileCommand. Para testar o upload, abra seu aplicativo e selecione o dispositivo que você criou. Selecione a guia Comando e, em seguida, selecione o botão Executar . Quando você seleciona Executar, o IoT Central chama um método direto em seu dispositivo para carregar o arquivo. Você pode ver esse método no código de exemplo no arquivo /device.ts . O método é chamado uploadFileCommand.

Selecione a guia Dados brutos para verificar o status de carregamento do arquivo.

Captura de tela mostrando o U I de como verificar o upload de um arquivo.

Você também pode fazer uma chamada à API REST para verificar o status de carregamento do arquivo no contêiner de armazenamento.

  • Last updated on