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:

Opzioni di caricamento

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 generali
  • 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_id invece di stringhe di nomi)

Stato del caricamento

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

Stato della rete

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:

HTTPS e connessione diretta
  • Solo richieste HTTPS (le richieste HTTP vengono rifiutate)

  • Connessione diretta del dispositivo o dell’applicazione a Frame.io (nessun servizio intermediario)

Protezione delle credenziali
  • client_secret e client_id protetti (non accessibili all’utente) * Credenziali access_token e refresh_token protette

  • 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:

Funzionalità di caricamento
  • 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

Gestione della coda

La coda di caricamento deve essere affidabile e deve poter gestire:

  • Caricamenti simultanei

  • Interruzioni di rete

  • Cicli di potenza

Gestione degli errori

Implementa i tentativi automatici per:

  • Problemi di rete

  • Interruzioni dell’alimentazione

  • Errori non critici (timeout, errori di rete, token scaduti)

Controllo del caricamento
  • 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

Opzioni di caricamento

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:

Velocità e sicurezza
  • Raggiungi una velocità di caricamento minima di 50 Mbps (condizioni di rete permettendo)

  • Supporto per la sicurezza WiFi WPA2 (Ethernet facoltativo, ma consigliato)

Gestione della rete
  • 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:

Configurazioni di rete

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

Test di resilienza
  • 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:

Registrazione SDI/HDMI
  • 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

File proxy
  • 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

Requisiti generali
  • 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_id invece di stringhe di nomi)

Controllo della qualità

In Frame.io, la qualità è essenziale. Le principali aree di test includono:

Funzionalità di base
  • 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

Requisiti tecnici
  • 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.