Checklist per integratori
Requisiti di integrazione C2C
Questo elenco di controllo include le best practice e i requisiti per partecipare all’ecosistema C2C. Anche se non tutti gli elementi si applicano a tutti i dispositivi o a tutte le applicazioni C2C, il team per le partnership C2C ti può aiutare a definire requisiti specifici durante il programma di certificazione C2C.
Requisiti di integrazione di base
Tutte le integrazioni devono includere:
Fornisci delle opzioni di caricamento flessibili:
-
Attiva/disattiva i caricamenti automatici/manuali
-
Selezione di file singoli/multipli
-
Priorità del tipo di file (facoltativo)
-
Priorità in coda (facoltativo)
-
Caricamenti paralleli (facoltativo)
-
Consenti l’annullamento di singoli caricamenti o di tutti i caricamenti
-
Stream di video/audio con codice temporale
-
Supporto del caricamento multi-formato (proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
-
Gestione del cambio nome del progetto (usa
project_idinvece di stringhe di nomi)
Indicatori chiari per:
-
Numero di file rimanenti
-
Dimensione totale dei file rimanenti
-
Avanzamento del caricamento corrente dei file
-
Stato dei caricamenti completati, in coda e non riusciti
Visualizzazione dello stato della connessione di rete e aggiornamento automatico del token di accesso dopo 8 ore senza interazione dell’utente o avvisi (tranne in caso di errore di aggiornamento)
Requisiti aggiuntivi:
- Flusso di autorizzazione annullabile a ogni passaggio
- Stato del socket per la comunicazione in tempo reale
- Intestazione della versione del firmware in tutte le chiamate di endpoint HTTPS
Requisiti di sicurezza
Su Frame.io la sicurezza è fondamentale. I nostri requisiti includono:
-
Solo richieste HTTPS (le richieste HTTP vengono rifiutate)
-
Connessione diretta del dispositivo o dell’applicazione a Frame.io (nessun servizio intermediario)
-
client_secreteclient_idprotetti (non accessibili all’utente) * Credenzialiaccess_tokenerefresh_tokenprotette -
Archiviazione crittografata di secret e token (facoltativa, ma consigliata)
Requisiti per il caricamento
Il caricamento affidabile dei media è fondamentale, specialmente in condizioni difficili. Le integrazioni devono:
-
Supportare caricamenti automatici in tempo reale durante la registrazione (preferibile) o al completamento del file
-
Mostrare lo stato di caricamento in modo chiaro, inclusa la coda e i risultati
-
Scrivere i file nell’archiviazione locale accessibile dall’utente
La coda di caricamento deve essere affidabile e deve poter gestire:
-
Caricamenti simultanei
-
Interruzioni di rete
-
Cicli di potenza
Implementa i tentativi automatici per:
-
Problemi di rete
-
Interruzioni dell’alimentazione
-
Errori non critici (timeout, errori di rete, token scaduti)
-
Riprendi i caricamenti dall’ultimo chunk riuscito
-
Rispetta lo stato PAUSED
-
Gestisci errori non critici di AWS
-
Gestisci i media danneggiati senza bloccare altri caricamenti
Fornisci delle opzioni di caricamento flessibili:
-
Attiva/disattiva i caricamenti automatici/manuali
-
Selezione di file singoli/multipli
-
Priorità del tipo di file (facoltativo)
-
Priorità in coda (facoltativo)
-
Caricamenti paralleli (facoltativo)
-
Consenti l’annullamento di singoli caricamenti o di tutti i caricamenti
Requisiti di rete
Le integrazioni devono:
-
Raggiungi una velocità di caricamento minima di 50 Mbps (condizioni di rete permettendo)
-
Supporto per la sicurezza WiFi WPA2 (Ethernet facoltativo, ma consigliato)
-
Gestisce DHCP e IP statico
-
Visualizza chiaramente lo stato della rete (tipo di connessione, velocità, integrità)
-
Cambia rete senza dover riassociare il progetto
-
Salva le reti WiFi note
Requisiti di test
C2C è progettato per condizioni difficili e richiede test approfonditi per:
Testa tutti i tipi di connessione applicabili:
-
Router commerciale con:
-
WAN cablata
-
Modem cellulare aggregato
-
Modem cellulare commerciale
-
Modem stile hotspot
-
Configurazioni di router con mesh (incluso il protocollo 802.11r FT)
-
Connessioni dirette a vari tipi di modem
-
Interruzioni di corrente impreviste
-
Disconnessioni di rete
-
Problemi ISP
-
Gestione di media danneggiati
-
Creazione di risorse offline e riconnessione
Requisiti per i flussi di lavoro
C2C è un ecosistema, non solo una funzionalità. I requisiti specifici per dispositivo/applicazione includono:
-
Trigger per la registrazione automatica dalla fotocamera
-
Opzioni flessibili della fotocamera
-
Regolazione dell’offset del codice orario
-
Capacità di registrazione manuale
-
Gestione coerente dei nomi file
-
Sincronizzazione accurata del codice orario
-
Corrispondenza di nome file/codice orario/metadati con file hero/OCF
-
Ottimizzazione per LTE (bitrate 1-12 Mbps)
-
Supporto di codec standard per video e audio
-
Stream di video/audio con codice temporale
-
Supporto del caricamento multi-formato (proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
-
Gestione del cambio nome del progetto (usa
project_idinvece di stringhe di nomi)
Controllo della qualità
In Frame.io, la qualità è essenziale. Le principali aree di test includono:
-
Avvio e funzionamento stabili
-
Connessione al progetto
-
Generazione del codice hardware
-
Capacità di accesso/disconnessione
-
Visualizzazione delle informazioni su progetto/utente
-
Gestione dei dispositivi
-
Caricamento delle risorse
-
Supporto dei formati
-
Ripresa del caricamento dopo le interruzioni
-
Visualizzazione dell’avanzamento
-
Indicazione dello stato di rete
-
Persistenza della connessione di 8 ore
-
Autorizzazione annullabile
-
Connessione diretta a Frame.io
-
Sicurezza delle credenziali
-
Ottimizzazione della velocità di rete
Miglioramenti futuri
L’API Camera to Cloud di Frame.io si evolve continuamente. Pur mantenendo la compatibilità con le versioni precedenti, incoraggiamo un dialogo continuo sui futuri sviluppi per mantenere la nostra API allineata all’uso nel mondo reale.
È tutto!
Complimenti per aver completato le guide UC2CIG (University of C2C Integration Guides)! Speriamo che questa guida ti sia stata utile.
Condividi qualsiasi feedback su informazioni poco chiare o mancanti oppure contattaci per domande relative a C2C. Siamo qui per aiutarti!
Se non l’hai già fatto, consulta la guida Implementazione C2C: configurazione prima di procedere. Avrai bisogno dell’access_token ottenuto durante il processo di autenticazione e autorizzazione. Questa checklist si basa sulla guida dedicata ai caricamenti di base e sulla guida sui caricamenti avanzati.