Introdução
Introdução ao FlightHub Sync
O FlightHub Sync permite a integração entre as versões pública ou local do FlightHub e plataformas em nuvem de terceiros, possibilitando a sincronização de arquivos, transmissões ao vivo, telemetria de dispositivos e outros dados. Os principais recursos estão listados abaixo:
| Recurso | Versão pública do FlightHub | Versão local do FlightHub |
|---|---|---|
| Encaminhamento de transmissão ao vivo | Suportado | Suportado |
| Sincronização de arquivos | Suportado | Suportado |
| Sincronização de informações do dispositivo | Via dados de telemetria | Via MQTT Bridge |
| EventAPI | Suportado | Suportado |
| OAuth de terceiros | Não suportado | Suportado |
| Gerenciamento de espaço aéreo de terceiros | Suportado | Suportado |

Sincronização de informações do dispositivo (MQTT Bridge)
A sincronização de informações do dispositivo envia dados relevantes do dock e da aeronave para uma plataforma em nuvem de terceiros durante a operação.
Dados de telemetria da versão pública (envio via protocolo MQTT)
Os usuários da versão pública podem enviar dados de telemetria de dispositivos para servidores de terceiros por meio do protocolo MQTT. As etapas de configuração são as seguintes:
- Nas configurações do FlightHub Sync, navegue até a página de Encaminhamento de Dados de Telemetria.
- Configure os detalhes de conexão do MQTT Broker:
- Protocolo: TCP
- Host: É possível usar um endereço IP ou nome de domínio
- Port: Porta do serviço MQTT
- Nome de usuário/Senha: Credenciais de autenticação
- Depois que o serviço é ativado, os dados de telemetria são enviados em tempo real para o MQTT Broker configurado.
Indicadores de status do serviço:
- Em execução (verde): Conexão MQTT estabelecida com sucesso; os dados estão sendo encaminhados
- Desconectado (vermelho): O interruptor está ligado, mas a conexão falhou
- Desativado (cinza): O interruptor está desligado
MQTT Bridge (versão local)
As opções de configuração são mostradas na figura abaixo:

Para mais detalhes, consulte Integração MQTT.
OAuth de terceiros
O OAuth de terceiros permite que os usuários acessem o FlightHub usando tokens de autorização temporários (Access Tokens) de sistemas comerciais de terceiros. Isso melhora a segurança e a eficiência da integração do FlightHub aos sistemas comerciais existentes. Atualmente, esse recurso é suportado apenas na versão local do FlightHub 2. Os campos relevantes devem ser configurados ao implantar a versão local do FlightHub 2. Para mais detalhes, consulte o manual de implantação da versão local do FlightHub.

Encaminhamento de transmissão ao vivo
O encaminhamento de transmissão ao vivo envia transmissões de qualquer projeto da organização atual para plataformas de transmissão ao vivo de terceiros via RTMP (suportado nas versões pública e local), RTSP (suportado nas versões pública e local) e GB28181 (suportado apenas na versão local). Os dados de transmissão ao vivo encaminhados também consomem minutos de transmissão ao vivo do pacote da sua organização. Monitore o uso adequadamente.
As etapas de configuração são as seguintes:
- Crie um canal de encaminhamento e conclua a configuração correspondente.

- Após a configuração, use o interruptor do canal para ativar ou desativar o canal de encaminhamento correspondente.

Observação:
- O DJI Dock 4 não suporta RTSP atualmente.
- Para o protocolo RTSP, o endereço IP não é mantido após a interrupção da transmissão. Para iniciar a transmissão novamente, ative a transmissão, obtenha um novo endereço IP e atualize-o na plataforma de terceiros.
Sincronização de arquivos
A sincronização de arquivos envia dados de arquivos do FlightHub para plataformas de terceiros. Os detalhes são os seguintes:

| Tipo de arquivo | Do FlightHub para terceiros | De terceiros para o FlightHub | Observações |
|---|---|---|---|
| Arquivos de mídia | Suportado | Suportado | Quando a exclusão automática está ativada, os arquivos de origem no FlightHub podem ser excluídos automaticamente após a sincronização |
| Rotas de voo | Suportado | Suportado | A exclusão automática dos arquivos de origem no FlightHub após a sincronização não é suportada atualmente |
| Modelos | Suportado | Suportado | Quando a exclusão automática está ativada, os arquivos de origem no FlightHub podem ser excluídos automaticamente após a sincronização |
| Registros de voo | Suportado | Não suportado | Quando a exclusão automática está ativada, os arquivos de origem no FlightHub podem ser excluídos automaticamente após a sincronização |
| Informações de anotações | Suportado | Suportado | A sincronização é realizada via OpenAPI. Consulte Como criar anotações de mapa |
Observação: Os arquivos são totalmente empacotados durante a sincronização, portanto seu tamanho na plataforma de terceiros será maior do que seu tamanho no FlightHub.
Exclusão automática de arquivos de origem
As configurações de sincronização de arquivos incluem a opção "Excluir automaticamente os arquivos de origem do FlightHub após a sincronização".
- A exclusão ocorre somente após o recebimento de uma resposta 200 OK do armazenamento de terceiros.
- A exclusão de arquivos afeta os recursos no FlightHub que dependem desses arquivos, como os alertas do cockpit virtual, os registros de voo e o Analisador.
- Essa ação não pode ser desfeita. Ative a opção com cautela.
Configuração do bucket
Etapas de configuração:
- Configure os parâmetros do bucket. Atualmente, são suportados três tipos de armazenamento: AWS, Alibaba Cloud e armazenamento auto-hospedado compatível com S3 (MinIO). Configure as permissões correspondentes do bucket para operações de leitura e gravação:

- Configure os parâmetros de sincronização. O FlightHub Sync permite regras de sincronização independentes para cada projeto, possibilitando que diferentes projetos se conectem a diferentes buckets de armazenamento. Em particular, a sincronização de registros de voo exige seu consentimento aos termos relevantes de envio de dados antes de poder ser ativada. Essa configuração se aplica aos dados de voo de toda a organização.

Observações de armazenamento em nível de projeto:
- As regras de sincronização e os buckets de destino podem ser configurados de forma independente para cada projeto
- Uma única configuração de armazenamento pode ser reutilizada em várias regras, desacoplando a "configuração de armazenamento" das "regras de sincronização"
- Cada projeto pode pertencer a apenas uma regra de sincronização personalizada por vez
- Novas regras são criadas automaticamente para arquivar os projetos existentes
- É possível adicionar até 20 configurações de bucket de armazenamento simultaneamente em uma única organização
- Visualize o status da sincronização e gerencie os erros. Assim que a sincronização de arquivos começar, você poderá visualizar o status atual da sincronização na parte inferior da página. Os arquivos cuja sincronização falhou são listados, e você pode baixar logs para visualizar os logs completos de sincronização dos últimos 30 dias.

EventAPI
O EventAPI é o serviço de notificações ativas do FlightHub Sync para enviar eventos comerciais a plataformas de terceiros em tempo real. Para mais detalhes, consulte o EventAPI.
Principais recursos:
- Configure regras de notificação e selecione os tipos de eventos nos quais deseja se inscrever
- Defina o escopo de envio de dados para todos os projetos ou projetos específicos
- Valide as origens das solicitações usando assinaturas HMAC-SHA256
- Audite os logs de entrega dos últimos 7 dias e baixe-os em formato CSV
- Envie mensagens por meio de um endereço IP fixo para facilitar a configuração da lista de permissões do firewall
Gerenciamento de espaço aéreo de terceiros
O gerenciamento de espaço aéreo de terceiros integra ao FlightHub informações do espaço aéreo em tempo real provenientes de provedores externos de dados do espaço aéreo. Ele exibe os movimentos de aeronaves próximas no mapa da página da equipe e combina essas informações com os dados do DJI AirSense para emitir alertas de risco de colisão e melhorar a segurança de voo.
Etapas de configuração
- No FlightHub Sync, navegue até a página Gerenciamento de dados do espaço aéreo e ative o serviço.
- Insira a API Key obtida com o provedor de dados do espaço aéreo e conclua a verificação.
- Insira o endereço do sistema externo e um nome personalizado para o provedor.
- Após salvar a configuração, o módulo de informações do espaço aéreo na página da equipe do projeto exibe dados do espaço aéreo em tempo real desse provedor.
Provedores compatíveis
O provedor de dados do espaço aéreo de terceiros atualmente suportado é o SafeSky. Para utilizar esse serviço, assine o plano adequado na plataforma SafeSky e obtenha uma API Key.
Capacidades principais
- Receba e exiba em tempo real a posição, a altitude, a velocidade e outras informações dinâmicas de aeronaves no espaço aéreo externo
- Combine dados externos com os dados do DJI AirSense, remova automaticamente as duplicatas e dê prioridade às fontes AirSense (ADS-B)
- Configure limites de distância para alertas de risco de colisão (risco alto, médio ou baixo)
- Filtre por código ICAO ou tipo de aeronave para reduzir alertas desnecessários