Introduzione
Introduzione a FlightHub Sync
FlightHub Sync consente l'integrazione tra le versioni pubbliche o on-premises di FlightHub e le piattaforme cloud di terze parti, permettendo la sincronizzazione di file, livestream, telemetria dei dispositivi e altri dati. Le funzionalità principali sono le seguenti:
| Funzionalità | Versione pubblica di FlightHub | Versione on-premises di FlightHub |
|---|---|---|
| Forwarding del livestream | Supportato | Supportato |
| Sincronizzazione dei file | Supportato | Supportato |
| Sincronizzazione delle informazioni sul dispositivo | Tramite dati di telemetria | Tramite MQTT Bridge |
| EventAPI | Supportato | Supportato |
| OAuth di terze parti | Non supportato | Supportato |
| Gestione dello spazio aereo di terze parti | Supportato | Supportato |
Sincronizzazione delle informazioni sul dispositivo (MQTT Bridge)
La sincronizzazione delle informazioni sul dispositivo invia i dati pertinenti dal dock e dall'aeromobile a una piattaforma cloud di terze parti durante il funzionamento.
Dati di telemetria della versione pubblica (invio tramite protocollo MQTT)
Gli utenti della versione pubblica possono inviare i dati di telemetria dei dispositivi a server di terze parti tramite il protocollo MQTT. I passaggi di configurazione sono i seguenti:
- Nelle impostazioni di FlightHub Sync, vai alla pagina Forwarding dei dati di telemetria.
- Configura i dettagli di connessione del MQTT Broker:
- Protocollo: TCP
- Host: è supportato un indirizzo IP o un nome di dominio
- Port: porta del servizio MQTT
- Nome utente/Password: credenziali di autenticazione
- Una volta attivato il servizio, i dati di telemetria vengono inviati in tempo reale al MQTT Broker configurato.
Indicatori di stato del servizio:
- In esecuzione (verde): MQTT connesso correttamente; i dati vengono inoltrati
- Disconnesso (rosso): l'interruttore è attivato, ma la connessione è fallita
- Disabilitato (grigio): l'interruttore è disattivato
MQTT Bridge (versione on-premises)
Le opzioni di configurazione sono mostrate nella figura seguente:
Per maggiori dettagli, consulta Integrazione MQTT.
OAuth di terze parti
OAuth di terze parti consente agli utenti di accedere a FlightHub utilizzando token di autorizzazione temporanei (Access Token) di sistemi aziendali di terze parti. Ciò migliora la sicurezza e l'efficienza dell'integrazione di FlightHub nei sistemi aziendali esistenti. Attualmente, questa funzionalità è supportata solo nella versione on-premises di FlightHub 2. I campi pertinenti devono essere configurati durante la distribuzione della versione on-premises di FlightHub 2. Per i dettagli, fai riferimento al Manuale di distribuzione della versione on-premises di FlightHub.
Forwarding del livestream
Il forwarding del livestream invia i flussi di qualsiasi progetto nell'organizzazione corrente a piattaforme di livestream di terze parti tramite RTMP (supportato sia nella versione pubblica sia in quella on-premises), RTSP (supportato sia nella versione pubblica sia in quella on-premises) e GB28181 (supportato solo nella versione on-premises). Anche i dati del livestream inoltrati consumano i minuti di livestream del pacchetto della tua organizzazione. Monitora l'utilizzo di conseguenza.
I passaggi di configurazione sono i seguenti:
- Crea un canale di forwarding e completa la configurazione pertinente.
- Dopo la configurazione, utilizza l'interruttore del canale per abilitare o disabilitare il canale di forwarding corrispondente.
Nota:
- DJI Dock 4 attualmente non supporta RTSP.
- Per il protocollo RTSP, l'indirizzo IP non viene mantenuto dopo l'arresto dello streaming. Per riavviare lo streaming, abilitalo, ottieni un nuovo indirizzo IP e aggiornalo sulla piattaforma di terze parti.
Sincronizzazione dei file
La sincronizzazione dei file invia i dati dei file da FlightHub a piattaforme di terze parti. I dettagli sono i seguenti:
| Tipo di file | Da FlightHub a terze parti | Da terze parti a FlightHub | Note |
|---|---|---|---|
| File multimediali | Supportato | Supportato | Quando l'eliminazione automatica è attivata, i file sorgente in FlightHub possono essere eliminati automaticamente dopo la sincronizzazione |
| Rotte di volo | Supportato | Supportato | L'eliminazione automatica dei file sorgente in FlightHub dopo la sincronizzazione non è attualmente supportata |
| Modelli | Supportato | Supportato | Quando l'eliminazione automatica è attivata, i file sorgente in FlightHub possono essere eliminati automaticamente dopo la sincronizzazione |
| Record di volo | Supportato | Non supportato | Quando l'eliminazione automatica è attivata, i file sorgente in FlightHub possono essere eliminati automaticamente dopo la sincronizzazione |
| Informazioni sulle annotazioni | Supportato | Supportato | La sincronizzazione viene eseguita tramite OpenAPI. Consulta Creare annotazioni sulla mappa |
Nota: I file vengono completamente impacchettati durante la sincronizzazione, quindi la loro dimensione sulla piattaforma di terze parti sarà maggiore rispetto a quella in FlightHub.
Eliminazione automatica dei file sorgente
Le impostazioni di sincronizzazione dei file includono un'opzione "Elimina automaticamente i file sorgente di FlightHub dopo la sincronizzazione".
- L'eliminazione avviene solo dopo la ricezione di una risposta 200 OK dallo storage di terze parti.
- L'eliminazione dei file influisce sulle funzionalità di FlightHub che dipendono da tali file, come gli allarmi del Virtual Cockpit, i record di volo e l'Analizzatore.
- Questa azione non può essere annullata. Attivala con cautela.
Configurazione del bucket
Passaggi di configurazione:
- Configura i parametri del bucket. Attualmente sono supportati tre tipi di storage: AWS, Alibaba Cloud e lo storage compatibile con S3 self-hosted (MinIO). Configura le autorizzazioni del bucket corrispondenti per le operazioni di lettura e scrittura:
- Configura i parametri di sincronizzazione. FlightHub Sync consente regole di sincronizzazione indipendenti per ogni progetto, permettendo a progetti diversi di connettersi a bucket di storage diversi. In particolare, la sincronizzazione dei record di volo richiede il tuo consenso ai termini pertinenti sull'invio dei dati prima di poter essere attivata. Questa impostazione si applica ai dati di volo dell'intera organizzazione.
Note sullo storage a livello di progetto:
- Le regole di sincronizzazione e i bucket di destinazione possono essere configurati in modo indipendente per ogni progetto
- Una singola configurazione di storage può essere riutilizzata in più regole, disaccoppiando la "configurazione di storage" dalle "regole di sincronizzazione"
- Ogni progetto può appartenere a una sola regola di sincronizzazione personalizzata alla volta
- Per i progetti esistenti vengono create automaticamente nuove regole per l'archiviazione
- È possibile aggiungere fino a 20 configurazioni di bucket di storage contemporaneamente all'interno di una singola organizzazione
- Visualizza lo stato di sincronizzazione e gestisci gli errori. Una volta iniziata la sincronizzazione dei file, puoi visualizzare lo stato corrente della sincronizzazione nella parte inferiore della pagina. I file che non vengono sincronizzati sono elencati e puoi scaricare i log per visualizzare i log completi della sincronizzazione degli ultimi 30 giorni.
EventAPI
EventAPI è il servizio di notifica attiva di FlightHub Sync per l'invio di eventi aziendali a piattaforme di terze parti in tempo reale. Per maggiori dettagli, consulta EventAPI.
Funzionalità chiave:
- Configura le regole di notifica e seleziona i tipi di eventi a cui desideri sottoscriverti
- Imposta l'ambito di invio dei dati su tutti i progetti o su progetti specifici
- Convalida le origini delle richieste utilizzando firme HMAC-SHA256
- Verifica i log di consegna degli ultimi 7 giorni e scaricali in formato CSV
- Invia i messaggi tramite un indirizzo IP fisso per facilitare la configurazione della lista di indirizzi consentiti del firewall
Gestione dello spazio aereo di terze parti
La gestione dello spazio aereo di terze parti integra in FlightHub informazioni sullo spazio aereo in tempo reale provenienti da provider esterni di dati dello spazio aereo. Visualizza i movimenti degli aeromobili nelle vicinanze sulla mappa della pagina del team e combina queste informazioni con i dati DJI AirSense per emettere avvisi di rischio di collisione e migliorare la sicurezza del volo.
Passaggi di configurazione
- In FlightHub Sync, vai alla pagina Gestione dei dati dello spazio aereo e attiva il servizio.
- Inserisci l'API Key ottenuta dal provider dei dati dello spazio aereo e completa la verifica.
- Inserisci l'indirizzo del sistema esterno e un nome personalizzato del provider.
- Dopo aver salvato la configurazione, il modulo delle informazioni sullo spazio aereo nella pagina del team del progetto visualizza i dati dello spazio aereo in tempo reale di questo provider.
Provider supportati
Il provider di dati dello spazio aereo di terze parti attualmente supportato è SafeSky. Per utilizzare questo servizio, sottoscrivi il piano appropriato sulla piattaforma SafeSky e ottieni un'API Key.
Funzionalità principali
- Ricevi e visualizza in tempo reale la posizione, l'altitudine, la velocità e altre informazioni dinamiche degli aeromobili nello spazio aereo esterno
- Combina i dati esterni con i dati DJI AirSense, rimuovi automaticamente i duplicati e dai priorità alle sorgenti AirSense (ADS-B)
- Configura le soglie di distanza per gli avvisi di rischio di collisione (rischio alto, medio o basso)
- Filtra per codice ICAO o tipo di aeromobile per ridurre gli avvisi non necessari