Intégration

Liste de contrôle de l’intégrateur

Exigences liées à l’intégration C2C

Cette liste de vérification décrit les bonnes pratiques et les exigences pour rejoindre le réseau C2C. Bien que tous les éléments ne s’appliquent pas à tous les appareils ou applications C2C, l’équipe C2C Partnerships collaborera avec vous pour définir des exigences spécifiques au cours du programme de certification C2C.

Exigences d’intégration de base

Toutes les intégrations doivent inclure les éléments suivants :

Options de chargement

Proposer des options de chargement flexibles :

  • Basculement entre les chargements automatiques/manuels

  • Sélection de fichiers individuels/en lot

  • Hiérarchisation des types de fichiers (facultatif)

  • Hiérarchisation de la file d’attente (facultatif)

  • Chargements parallèles (facultatif)

  • Possibilité d’annuler des chargements individuels ou tous les chargements

Exigences générales

  • Flux de code temporel pour audio/vidéo

  • Prise en charge du chargement multi-format (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)

  • Gestion des modifications de nom de projet (utilisez project_id au lieu de chaînes de nom)

Statut de chargement

Indicateurs clairs pour :

  • Nombre de fichiers restants

  • Taille totale des fichiers restants

  • Progression du chargement du fichier actuel

  • Statut des chargements terminés, en attente et ayant échoué

Statut du réseau

Affichage du statut de connexion réseau et actualisation automatique du jeton d’accès après 8 heures sans interaction utilisateur ou alerte (sauf en cas d’erreur d’actualisation)

Exigences supplémentaires :

  • Flux d’autorisation annulable à chaque étape
  • Statut de socket pour la communication en temps réel
  • En-tête de version du micrologiciel dans tous les appels de point d’entrée HTTPS

Exigences de sécurité

Chez Frame.io, la sécurité est primordiale. Nos exigences incluent :

HTTPS et connexion directe

  • Requêtes HTTPS uniquement (les requêtes HTTP sont rejetées)

  • Connexion directe de l’appareil/application à Frame.io (aucun service intermédiaire)

Protection des informations d’identification

  • Protection des paramètres client_secret et client_id (non accessibles à l’utilisateur) * Protection des informations d’identification access_token et refresh_token

  • Enregistrement chiffré des secrets et jetons (facultatif mais recommandé)

Exigences du système de chargement

La fiabilité du chargement des médias est essentielle, surtout dans des conditions difficiles. Les intégrations doivent :

Fonctionnalités de chargement

  • Prendre en charge les chargements automatiques soit en temps réel pendant l’enregistrement (préférable) soit à la fin du fichier

  • Afficher clairement le statut de chargement, y compris la file d’attente et les résultats

  • Écrire les fichiers à un emplacement local accessible à l’utilisateur

Gestion des files d’attente

Maintenir une file d’attente de chargement robuste qui gère :

  • Les chargements simultanés

  • Les interruptions réseau

  • Les cycles d’alimentation

Gestion des erreurs

Implémenter une nouvelle tentative automatique pour :

  • Les problèmes réseau

  • Les interruptions d’alimentation

  • Les erreurs non fatales (délais d’expiration, erreurs réseau, jetons expirés)

Contrôle de chargement

  • Reprendre les chargements à partir du dernier bloc ayant abouti

  • Respecter l’état SUSPENDU

  • Gérer les erreurs non fatales AWS

  • Gérer les médias corrompus sans bloquer les autres chargements

Options de chargement

Proposer des options de chargement flexibles :

  • Basculement entre les chargements automatiques/manuels

  • Sélection de fichiers individuels/en lot

  • Hiérarchisation des types de fichiers (facultatif)

  • Hiérarchisation de la file d’attente (facultatif)

  • Chargements parallèles (facultatif)

  • Possibilité d’annuler des chargements individuels ou tous les chargements

Exigences réseau

Les intégrations doivent :

Vitesse et sécurité

  • Atteindre des vitesses de chargement minimales de 50 Mbit/s (selon les conditions réseau)

  • Prendre en charge de la sécurité Wi-Fi WPA2 (Ethernet facultatif mais recommandé)

Gestion réseau

  • Gérer DHCP et IP statique

  • Afficher clairement le statut du réseau (type de connexion, vitesse, santé)

  • Changer de réseau sans recouplage du projet

  • Sauvegarder les réseaux Wi-Fi connus

Exigences de test

C2C est conçu pour des conditions difficiles, nécessitant des tests approfondis dans les environnements suivants :

Configurations réseau

Testez tous les types de connexion applicables :

  • Routeur commercial avec :

  • WAN filaire

  • Modem cellulaire agrégé

  • Modem cellulaire commercial

  • Modem de type point d’accès

  • Configurations de routeur en maillage (y compris le protocole 802.11r FT)

  • Connexions directes à différents types de modems

Tests de résilience

  • Pannes de courant inattendues

  • Déconnexions réseau

  • Problèmes de FAI

  • Gestion de médias corrompus

  • Création de ressources hors ligne et reconnexion

Exigences de workflow

C2C est un réseau, pas seulement une fonctionnalité. Les exigences spécifiques à l’appareil/à l’application incluent les éléments suivants :

Enregistrement SDI/HDMI

  • Déclencheur d’enregistrement automatique depuis la caméra

  • Options de caméra flexibles

  • Réglage du décalage de code temporel

  • Capacité d’enregistrement manuel

  • Gestion cohérente des noms de fichiers

  • Synchronisation précise du code temporel

Fichiers proxy

  • Correspondance du nom de fichier/code temporel/métadonnées avec le fichier héros/OCF

  • Optimisé pour LTE (débit binaire 1-12 Mbit/s)

  • Prise en charge de codecs standard pour vidéo et son

Exigences générales

  • Flux de code temporel pour audio/vidéo

  • Prise en charge du chargement multi-format (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)

  • Gestion des modifications de nom de projet (utilisez project_id au lieu de chaînes de nom)

Assurance qualité

Chez Frame.io, la qualité est essentielle. Les domaines de test clés incluent :

Des fonctionnalités de base

  • Démarrage et fonctionnement stables

  • Connexion de projet

  • Génération de code matériel

  • Capacité de connexion/déconnexion

  • Affichage des informations projet/utilisateur

  • Gestion d’appareils

  • Chargement de ressources

  • Prise en charge des formats

Des exigences techniques

  • Reprise du chargement après les interruptions

  • Affichage de la progression

  • Indication de l’état du réseau

  • Persistance de la connexion pendant 8 heures

  • Autorisation annulable

  • Connexion directe à Frame.io

  • Sécurité des informations d’identification

  • Optimisation de la vitesse réseau

Améliorations futures

L’API Frame.io Camera to Cloud évolue en permanence. Tout en maintenant la rétrocompatibilité, nous encourageons le dialogue continu concernant les développements futurs afin de maintenir notre API alignée sur l’utilisation réelle.

C’est terminé !

Félicitations pour avoir suivi les guides UC2CIG (University of C2C Integration Guides) jusqu’au bout ! Nous espérons que vous avez trouvé ce guide utile.

Partagez vos commentaires sur les informations que vous trouveriez peu claires ou qui vous auraient manqué, ou contactez-nous pour toute question liée au C2C. Nous sommes là pour vous aider !

Si vous ne l’avez pas encore fait, veuillez consulter le guide Implémentation C2C : configuration avant de continuer. Vous aurez besoin de l’élément access_token obtenu au cours du processus d’authentification et d’autorisation. Cette liste de vérification s’appuie sur le guide de chargement de base et le guide de chargement avancé.