El zen de Camera to Cloud

¿Qué es la API de Camera to Cloud?

La API de Camera to Cloud (C2C) proporciona un método seguro para transmitir medios directamente a Frame.io justo después de que se complete la grabación, sin requerir entradas adicionales por parte del usuario. En Frame.io, nuestro objetivo es hacer que los medios estén disponibles para revisar y colaborar tan pronto como se detenga la grabación o se introduzcan metadatos.

Durante el desarrollo, determinamos que para ofrecer la mejor experiencia tanto para integradores como para usuarios, la API de C2C necesitaba funcionar como su propio sistema backend especializado, separado del ecosistema principal de Frame.io. Aunque esta decisión de arquitectura pueda no parecer intuitiva al principio, en este documento se detalla nuestro razonamiento al explicar los principios rectores detrás de C2C.

Más allá del metraje de la cámara

Aunque se llama “Camera to Cloud” por claridad y reconocimiento, las capacidades de la API van más allá del metraje de la cámara. La API de C2C maneja muchos tipos de contenido digital. Independientemente de si su dispositivo produce audio, vídeo, PDF u otros tipos de archivos, Frame.io puede encargarse de todo. La API agiliza la transferencia de cualquier activo digital desde la creación hasta el almacenamiento en la nube con una fricción mínima.

Escribir, pero no leer

Frame.io mantiene unos estándares de seguridad robustos, e introducir conectividad con dispositivos conlleva posibles consideraciones de seguridad. Muchos dispositivos de captura de medios carecen de funciones de seguridad tradicionales como contraseñas o bloqueos de pantalla, ya que no se diseñaron originalmente para la conectividad de red. Proporcionar acceso completo a la API de Frame.io a estos dispositivos podría crear vulnerabilidades de seguridad si se dejan desatendidos.

Además, los operadores de dispositivos a menudo necesitan acceder solo a elementos específicos en lugar de a todo el proyecto. Su función puede limitarse a crear medios concretos en lugar de administrar el proyecto completo.

Esto nos llevó a nuestro principio de diseño central: los dispositivos de grabación existen principalmente para crear medios, no para revisar o comentar contenido de otras fuentes. El mejor enfoque de seguridad fue desarrollar una API específicamente limitada a su funcionalidad esencial: cargar datos en la nube. Al eliminar completamente las capacidades de lectura, evitamos efectivamente el acceso no autorizado a información confidencial del proyecto.

Diseñar para dispositivos con interfaces limitadas

Las API existentes de Frame.io se diseñaron asumiendo que interactuarían con aplicaciones que cuentan con interfaces gráficas de usuario. Estas aplicaciones podrían mostrar opciones a los usuarios que harían selecciones que luego se enviarían al servidor.

Sin embargo, el ecosistema de C2C incluye dispositivos físicos con capacidades de interfaz gráfica limitadas o nulas, y posiblemente sin mecanismos de entrada del usuario. Esto requirió un enfoque fundamentalmente diferente para la interacción del usuario.

Al diseñar C2C, necesitábamos crear un sistema que pudiera funcionar eficazmente en dispositivos con capacidades de interfaz limitadas. Esto significaba desarrollar un modelo de interacción que no requiriera entradas por parte del usuario en el propio dispositivo, ya que dicha entrada podría ser imposible en muchos casos.

Esta restricción eliminó la posibilidad de usar nuestra arquitectura de API existente, que dependía de flujos de autenticación basados en web y en la selección por parte del usuario de las carpetas de destino. Necesitábamos simplificar no solo las acciones que un dispositivo podía realizar, sino también toda la experiencia del usuario que rodea esas acciones.

Adaptarse a una conectividad intermitente

Más allá de las limitaciones de interfaz, muchos dispositivos en el ecosistema de C2C operan en entornos con una conectividad de red impredecible. Diseñamos nuestra API para minimizar la comunicación con el backend, lo que reduce el número de llamadas necesarias durante la operación para garantizar una experiencia fiable para profesionales que trabajan en ubicaciones remotas con servicio WiFi o celular limitado.

Simplificar la integración

Nuestra prioridad era hacer que la integración fuera lo más sencilla posible. Desarrollamos una API específica con un conjunto mínimo de puntos finales, requisitos limitados de negociación con el servidor y un ámbito estrechamente definido y alineado con nuestros objetivos. Reconocemos que, para algunos integradores, esta puede ser su primera experiencia implementando llamadas de red de terceros. Tanto si tiene experiencia en el desarrollo y busca una implementación eficiente como si es su primera vez con las API REST, hemos diseñado la experiencia para que sea accesible y sencilla.

Próximos pasos

Le recomendamos que se ponga en contacto con nuestro equipo si tiene alguna pregunta y a continuar con la siguiente guía de esta serie. Esperamos poder ayudarle con su integración de C2C.

Para obtener información general técnica, consulte la guía de arquitectura de integración.