For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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
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
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!
