Checkliste für Integratoren
Checkliste für Integratoren
C2C-Integrationsanforderungen
Diese Checkliste enthält die Best Practices und Anforderungen für den Beitritt zum C2C-Ökosystem.Obwohl nicht jeder Punkt auf alle C2C-Geräte oder -Anwendungen zutrifft, wird das C2C-Partnerships-Team mit Ihnen zusammenarbeiten, um im Rahmen des C2C-Zertifizierungsprogramms spezifische Anforderungen zu definieren.
Grundlegende Integrationsanforderungen
Alle Integrationen müssen Folgendes umfassen:
Flexible Upload-Optionen bereitstellen:
-
Zwischen automatischen und manuellen Uploads umschalten
-
Einzel-/Massendateiauswahl
-
Dateityppriorisierung (optional)
-
Priorisierung der Warteschlange (optional)
-
Parallele Uploads (optional)
-
Abbruch einzelner oder aller Uploads zulassen
-
Timecode-Streams für Video/Audio
-
Multi-Format-Upload-Unterstützung (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
-
Handhabung von Projektnamensänderungen (
project_idanstelle von Namenszeichenfolgen verwenden)
Klare Indikatoren für:
-
Verbleibende Dateianzahl
-
Gesamte verbleibende Dateigröße
-
Aktueller Fortschritt des Datei-Uploads
-
Status der abgeschlossenen, in der Warteschlange befindlichen und fehlgeschlagenen Uploads
Anzeige des Netzwerkverbindungsstatus und automatische Aktualisierung des Zugriffstokens nach 8 Stunden ohne Benutzerinteraktion oder Warnungen (es sei denn, es liegt ein Aktualisierungsfehler vor)
Zusätzliche Anforderungen:
- Abbrechbarer Autorisierungsfluss in jedem Schritt
- Socket-Status für Echtzeitkommunikation
- Header der Firmware-Version in allen HTTPS-Endpunktaufrufen
Sicherheitsanforderungen
Bei Frame.io hat Sicherheit oberste Priorität.Unsere Anforderungen umfassen:
-
Nur-HTTPS-Anfragen (HTTP-Anfragen werden abgelehnt)
-
Direkte Geräte-/Anwendungsverbindung zu Frame.io (keine Zwischendienste)
-
Geschützte
client_secret- undclient_id-Anmeldedaten (nicht für Benutzende zugänglich) * Geschützteaccess_token- undrefresh_token-Anmeldedaten -
Verschlüsselte Speicherung von Geheimnissen und Token (optional, aber empfohlen)
Uploader-Anforderungen
Ein zuverlässiger Medien-Upload ist besonders unter schwierigen Bedingungen von entscheidender Bedeutung.Integrationen müssen Folgendes erfüllen:
-
Unterstützung automatischer Uploads entweder in Echtzeit während der Aufzeichnung (bevorzugt) oder nach Fertigstellung der Datei
-
Anzeigen des Status zum Löschen des Uploads, einschließlich Warteschlange und Ergebnissen
-
Schreiben von Dateien in den für Benutzende zugänglichen lokalen Speicher
Stellen Sie eine robuste Upload-Warteschlange bereit, die Folgendes verarbeitet:
-
Gleichzeitige Uploads
-
Netzwerkunterbrechungen
-
Aus- und Wiedereinschalten
Automatische Wiederholung implementieren für:
-
Netzwerkprobleme
-
Stromunterbrechungen
-
Nicht schwerwiegende Fehler (Zeitüberschreitungen, Netzwerkfehler, abgelaufene Token)
-
Uploads aus dem letzten erfolgreichen Chunk fortsetzen
-
Status PAUSED berücksichtigen
-
Nicht schwerwiegende AWS-Fehler behandeln
-
Beschädigte Medien verwalten, ohne andere Uploads zu blockieren
Flexible Upload-Optionen bereitstellen:
-
Zwischen automatischen und manuellen Uploads umschalten
-
Einzel-/Massendateiauswahl
-
Dateityppriorisierung (optional)
-
Priorisierung der Warteschlange (optional)
-
Parallele Uploads (optional)
-
Abbruch einzelner oder aller Uploads zulassen
Netzwerkanforderungen
Integrationen müssen Folgendes erfüllen:
-
Mindestens 50 MBit/s Upload-Geschwindigkeiten erreichen (je nach Netzwerkbedingungen)
-
WPA2-WLAN-Sicherheit unterstützen (Ethernet optional, aber empfohlen)
-
Verarbeitet DHCP und statische IP
-
Anzeige des klaren Netzwerkstatus (Verbindungstyp, Geschwindigkeit, Zustand)
-
Switch-Netzwerke ohne Projektneukopplung
-
Bekannte WLAN-Netzwerke speichern
Prüfanforderungen
C2C ist für anspruchsvolle Bedingungen konzipiert, die eine gründliche Prüfung in folgenden Bereichen erfordern:
Testen aller anwendbaren Verbindungstypen:
-
Kommerzieller Router mit:
-
Hardline-WAN
-
Integriertem Mobilfunkmodem
-
Mobilfunk-Modem
-
Hotspot-Modem
-
Mesh-Router-Setups (einschließlich 802.11r-FT-Protokoll)
-
Direkte Verbindungen zu verschiedenen Modemtypen
-
Unerwartete Stromausfälle
-
Getrennte Netzwerkverbindungen
-
ISP-Probleme
-
Umgang mit beschädigten Medien
-
Erstellen von Offline-Assets und erneute Verbindung
Workflow-Anforderungen
C2C ist ein Ökosystem, nicht nur eine Funktion.Zu den geräte-/anwendungsspezifischen Anforderungen gehören:
-
Automatischer Aufnahmeauslöser von der Kamera
-
Flexible Kameraoptionen
-
Timecode-Versatz-Einstellung
-
Manuelle Aufzeichnungsfunktion
-
Konsistente Handhabung von Dateinamen
-
Präzise Timecode-Synchronisierung
-
Abgleich von Dateiname, Timecode und Metadaten mit der Hauptdatei/OCF
-
LTE-optimiert (1–12 MBit/s Bitrate)
-
Standard-Codec-Unterstützung für Video und Audio
-
Timecode-Streams für Video/Audio
-
Multi-Format-Upload-Unterstützung (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
-
Handhabung von Projektnamensänderungen (
project_idanstelle von Namenszeichenfolgen verwenden)
Qualitätssicherung
Bei Frame.io ist Qualität von entscheidender Bedeutung.Zu den wichtigsten Testbereichen gehören:
-
Stabiler Launch und Betrieb
-
Projektverbindung
-
Generierung von Hardwarecode
-
An-/Abmeldefunktion
-
Projekt-/Benutzerinformationsanzeige
-
Geräteverwaltung
-
Asset-Upload
-
Formatunterstützung
-
Upload-Wiederaufnahme nach Unterbrechungen
-
Fortschrittsanzeige
-
Netzwerkstatusanzeige
-
8-Stunden-Verbindungspersistenz
-
Stornierbare Autorisierung
-
Direkte Frame.io-Verbindung
-
Anmeldedatensicherheit
-
Optimierung der Netzwerkgeschwindigkeit
Zukünftige Verbesserungen
Die Camera to Cloud-API von Frame.io entwickelt sich kontinuierlich weiter.Wir legen Wert auf Abwärtskompatibilität und begrüßen einen kontinuierlichen Austausch über zukünftige Entwicklungen, um unsere API an die Praxis anzupassen.
Das war’s.
Herzlichen Glückwunsch! Sie haben die UC2CIG (University of C2C Integration Guides) abgeschlossen.Wir hoffen, dass Sie diesen Leitfaden hilfreich fanden.
Bitte teilen Sie uns Ihre Meinung zu unklaren oder fehlenden Informationen mit oder wenden Sie sich mit Fragen im Zusammenhang mit C2C an uns.Wir unterstützen Sie!
Wenn Sie es noch nicht getan haben, lesen Sie bitte den Leitfaden C2C implementieren: Einrichtung, bevor Sie fortfahren.Sie benötigen den access_token, den Sie während des Authentifizierungs- und Autorisierungsprozesses erhalten haben.Diese Checkliste baut auf dem Leitfaden zu einfachen Uploads und dem Leitfaden zu erweiterten Uploads auf.