Lista de comprobación para integradores
Lista de comprobación para integradores
Requisitos de integración de C2C
En esta lista de comprobación se describen las prácticas recomendadas y los requisitos para unirse al ecosistema de C2C. Aunque no todos los elementos se aplican a todos los dispositivos o aplicaciones de C2C, el equipo de asociaciones de C2C trabajará con usted para definir requisitos específicos durante el programa de certificación de C2C.
Requisitos básicos de integración
Todas las integraciones deben incluir:
Se deben proporcionar opciones de carga flexibles:
* Posibilidad de alternar cargas automáticas/manuales
* Selección de archivos individualmente o en lote
* Priorización de tipos de archivos (opcional)
* Priorización de colas (opcional)
* Cargas paralelas (opcional)
* Cancelación de cargas individuales o de todas las cargas
* Flujos de código de tiempo para vídeo/audio
* Compatibilidad con la carga multiformato (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
* Gestión de los cambios en los nombres de los proyectos (usar project_id en lugar de cadenas de nombre)
Indicadores claros para los siguientes aspectos:
* Recuento de archivos restantes
* Tamaño total de archivos restantes
* Progreso de carga del archivo actual
* Estado de las cargas completadas, en cola y fallidas
Visualización del estado de conexión de red y actualización automática del token de acceso tras 8 horas sin interacción del usuario ni alertas (a menos que haya un error de actualización)
Requisitos adicionales:
- Flujo de autorización cancelable en cada paso
- Estado del socket para la comunicación en tiempo real
- Encabezado de versión de firmware en todas las llamadas de punto final HTTPS
Requisitos de seguridad
En Frame.io, la seguridad es primordial. Entre nuestros requisitos se incluyen:
* Solo solicitudes HTTPS (las solicitudes HTTP se rechazan)
* Conexión directa del dispositivo/aplicación a Frame.io (sin servicios intermediarios)
* client_secret y client_id deben contar con protección (el usuario no debe poder acceder a estos valores) * Las credenciales access_token y refresh_token deben contar con protección
* Almacenamiento cifrado de secretos y tokens (opcional, pero recomendado)
Requisitos del cargador
Poder cargar medios de manera fiable es crucial, especialmente en condiciones difíciles. Las integraciones deben contar con todo lo siguiente:
* Admitir cargas automáticas ya sea en tiempo real durante la grabación (preferido) o al completar el archivo
* Mostrar claramente el estado de carga, lo que incluye la cola y los resultados
* Escribir archivos en almacenamiento local accesible para el usuario
Mantener una cola de carga robusta que gestione:
* Cargas simultáneas
* Interrupciones de red
* Ciclos de encendido
Implementar reintentos automáticos para:
* Problemas de red
* Interrupciones de alimentación
* Errores no graves (tiempos de espera, errores de red, tokens caducados)
* Reanudar las cargas desde el último fragmento correcto
* Respetar el estado PAUSED
* Gestionar errores no graves de AWS
* Administrar medios dañados sin bloquear otras cargas
Se deben proporcionar opciones de carga flexibles:
* Posibilidad de alternar cargas automáticas/manuales
* Selección de archivos individualmente o en lote
* Priorización de tipos de archivos (opcional)
* Priorización de colas (opcional)
* Cargas paralelas (opcional)
* Cancelación de cargas individuales o de todas las cargas
Requisitos de red
Las integraciones deben contar con todo lo siguiente:
* Lograr velocidades de carga mínimas de 50 Mbps (siempre que las condiciones de red lo permitan)
* Admitir seguridad WiFi WPA2 (Ethernet opcional, pero recomendado)
* Gestionar DHCP e IP estáticas
* Mostrar claramente el estado de la red (tipo, velocidad y estado de la conexión)
* Cambiar de red sin volver a emparejar el proyecto
* Guardar redes WiFi conocidas
Requisitos de pruebas
C2C se ha diseñado para condiciones desafiantes, por lo que es obligatorio realizar pruebas exhaustivas para los siguientes aspectos:
Pruebe todos los tipos de conexión aplicables:
* Enrutador comercial con:
- WAN por cable
- Módem celular de enlace agregado
- Módem celular comercial
- Módem de tipo punto de acceso
* Configuraciones de enrutador en malla (lo que incluye el protocolo 802.11r FT)
* Conexiones directas a varios tipos de módems
* Cortes de alimentación inesperados
* Desconexiones de red
* Problemas del proveedor de servicios de Internet (ISP)
* Gestión de medios dañados
* Creación de activos sin conexión y reconexión
Requisitos de flujo de trabajo
C2C es un ecosistema, no solo una función. Entre los requisitos específicos de los dispositivos/aplicaciones se incluyen los siguientes:
* Activador de grabación automática desde la cámara
* Opciones de cámara flexibles
* Ajuste de desplazamiento del código de tiempo
* Capacidad de grabación manual
* Gestión coherente de los nombres de archivos
* Sincronización precisa del código de tiempo
* Coincidencia de nombre de archivo/código de tiempo/metadatos con el archivo principal/OCF
* Optimización para LTE (velocidad de bits de 1-12 Mbps)
* Compatibilidad con códecs estándar para vídeo y audio
* Flujos de código de tiempo para vídeo/audio
* Compatibilidad con la carga multiformato (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
* Gestión de los cambios en los nombres de los proyectos (usar project_id en lugar de cadenas de nombre)
Control de calidad
En Frame.io, la calidad es esencial. Entre las áreas de prueba clave se incluyen las siguientes:
* Inicio y funcionamiento estables
* Conexión de proyectos
* Generación de código de hardware
* Capacidad de inicio/cierre de sesión
* Visualización de información sobre el proyecto/usuario
* Administración de dispositivos
* Carga de activos
* Compatibilidad con formatos
* Reanudación de las cargas tras interrupciones
* Visualización del progreso
* Indicación del estado de la red
* Persistencia de las conexiones durante 8 horas
* Autorización cancelable
* Conexión directa a Frame.io
* Seguridad de credenciales
* Optimización de la velocidad de red
Mejoras futuras
La API de Camera to Cloud de Frame.io evoluciona continuamente. Al tiempo que mantenemos la compatibilidad con versiones anteriores, estamos abiertos a un diálogo continuo sobre desarrollos futuros para mantener nuestra API alineada con el uso real.
¡Hemos terminado!
Enhorabuena por completar la UC2CIG (Universidad de guías de integración de C2C). Esperamos que esta guía le haya resultado útil.
Comparta cualquier comentario sobre información poco clara o que eche en falta, o póngase en contacto si tiene preguntas relacionadas con C2C. Será un placer ayudarle.
Si aún no lo ha hecho, revise la guía Implementar C2C: Configuración antes de continuar. Necesitará el access_token que se obtiene durante el proceso de autenticación y autorización. Esta lista de comprobación se basa en la guía básica sobre las cargas y la guía avanzada sobre las cargas.