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:

Upload-Optionen

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

Allgemeine Anforderungen
  • Timecode-Streams für Video/Audio

  • Multi-Format-Upload-Unterstützung (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)

  • Handhabung von Projektnamensänderungen (project_id anstelle von Namenszeichenfolgen verwenden)

Upload-Status

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

Netzwerkstatus

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:

HTTPS- und Direktverbindung
  • Nur-HTTPS-Anfragen (HTTP-Anfragen werden abgelehnt)

  • Direkte Geräte-/Anwendungsverbindung zu Frame.io (keine Zwischendienste)

Anmeldedatenschutz
  • Geschützte client_secret- und client_id-Anmeldedaten (nicht für Benutzende zugänglich) * Geschützte access_token- und refresh_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:

Upload-Funktionen
  • 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

Warteschlangenverwaltung

Stellen Sie eine robuste Upload-Warteschlange bereit, die Folgendes verarbeitet:

  • Gleichzeitige Uploads

  • Netzwerkunterbrechungen

  • Aus- und Wiedereinschalten

Fehlerbehandlung

Automatische Wiederholung implementieren für:

  • Netzwerkprobleme

  • Stromunterbrechungen

  • Nicht schwerwiegende Fehler (Zeitüberschreitungen, Netzwerkfehler, abgelaufene Token)

Upload-Steuerung
  • 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

Upload-Optionen

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:

Geschwindigkeit und Sicherheit
  • Mindestens 50 MBit/s Upload-Geschwindigkeiten erreichen (je nach Netzwerkbedingungen)

  • WPA2-WLAN-Sicherheit unterstützen (Ethernet optional, aber empfohlen)

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

Netzwerkkonfigurationen

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

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

SDI-/HDMI-Aufnahme
  • Automatischer Aufnahmeauslöser von der Kamera

  • Flexible Kameraoptionen

  • Timecode-Versatz-Einstellung

  • Manuelle Aufzeichnungsfunktion

  • Konsistente Handhabung von Dateinamen

  • Präzise Timecode-Synchronisierung

Proxy-Dateien
  • 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

Allgemeine Anforderungen
  • Timecode-Streams für Video/Audio

  • Multi-Format-Upload-Unterstützung (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)

  • Handhabung von Projektnamensänderungen (project_id anstelle von Namenszeichenfolgen verwenden)

Qualitätssicherung

Bei Frame.io ist Qualität von entscheidender Bedeutung.Zu den wichtigsten Testbereichen gehören:

Grundlegende Funktionen
  • Stabiler Launch und Betrieb

  • Projektverbindung

  • Generierung von Hardwarecode

  • An-/Abmeldefunktion

  • Projekt-/Benutzerinformationsanzeige

  • Geräteverwaltung

  • Asset-Upload

  • Formatunterstützung

Technische Anforderungen
  • 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.