O Zen do Camera to Cloud

O que é a API Camera to Cloud?

A API Camera to Cloud (C2C) oferece um método seguro para transmitir mídia diretamente para o Frame.io imediatamente após a conclusão da gravação, sem exigir entrada adicional do usuário. No Frame.io, nosso objetivo é disponibilizar mídia para revisar e colaboração assim que a gravação parar ou os metadados forem inseridos.

Durante o desenvolvimento, determinamos que, para oferecer a melhor experiência tanto para integradores quanto para usuários, a API C2C precisava funcionar como seu próprio sistema back-end especializado, separado do ecossistema principal do Frame.io. Embora essa decisão arquitetônica possa não parecer intuitiva à primeira vista, este documento explica nosso raciocínio explorando os princípios orientadores por trás do C2C.

Além da gravação de câmera

Embora nomeada “Camera to Cloud” para clareza e reconhecimento, os recursos da API se estendem além da gravação de câmera. A API C2C lida com muitos tipos de conteúdo digital. Seja seu dispositivo produzindo áudio, vídeo, PDFs ou outros tipos de arquivos, o Frame.io pode acomodar todos eles. A API simplifica a transferência de qualquer ativo digital da criação ao armazenamento na nuvem com atrito mínimo.

Escrever, mas não ler

O Frame.io mantém padrões de segurança rigorosos, e introduzir conectividade de dispositivo apresenta considerações de segurança potenciais. Muitos dispositivos de captura de mídia carecem de recursos de segurança tradicionais como senhas ou bloqueios de tela, pois não foram originalmente projetados para conectividade de rede. Fornecer acesso completo à API do Frame.io a esses dispositivos poderia criar vulnerabilidades de segurança se deixados desacompanhados.

Além disso, operadores de dispositivo frequentemente precisam de acesso apenas a elementos específicos em vez de todo o projeto. Sua função pode ser limitada a criar ativos de mídia específicos em vez de gerenciar o projeto completo.

Isso nos levou ao nosso princípio de design central: dispositivos de gravação existem principalmente para criar mídia, não para revisar ou comentar conteúdo de outras origens. A melhor abordagem de segurança foi desenvolver uma API especificamente limitada à sua função essencial: fazer upload de dados para a nuvem. Ao eliminar completamente os recursos de leitura, efetivamente impedimos o acesso não autorizado a informações sensíveis do projeto.

Projetando para dispositivos com interfaces limitadas

As APIs existentes do Frame.io foram projetadas partindo do pressuposto de que se integrariam a aplicativos com interfaces gráficas de usuário. Esses aplicativos poderiam exibir opções para usuários que fariam seleções que seriam então enviadas para o servidor.

O ecossistema C2C, no entanto, inclui dispositivos físicos com recursos de GUI limitados ou inexistentes e possivelmente nenhum mecanismo de entrada do usuário. Isso exigiu uma abordagem fundamentalmente diferente para a interação do usuário.

Ao projetar o C2C, precisávamos criar um sistema que pudesse funcionar de forma eficaz em dispositivos com recursos de interface limitados. Isso significava desenvolver um modelo de interação que não exigisse entrada do usuário no próprio dispositivo, já que tal entrada pode ser impossível em muitos casos.

Essa restrição eliminou a possibilidade de usar nossa arquitetura de API existente, que dependia de fluxos de autenticação baseados na web e da seleção de pastas de destino pelo usuário. Precisávamos simplificar não apenas as ações que um dispositivo poderia executar, mas também toda a experiência do usuário em torno dessas ações.

Acomodando conectividade intermitente

Além das limitações de interface, muitos dispositivos no ecossistema C2C operam em ambientes com conectividade de rede imprevisível. Projetamos nossa API para minimizar a comunicação de back-end, reduzindo o número de chamadas necessárias durante a operação para garantir uma experiência confiável para profissionais que trabalham em locais remotos com Wi-Fi ou serviço celular limitado.

Simplificando a integração

Nossa prioridade era tornar a integração o mais simples possível. Desenvolvemos uma API focada com um conjunto mínimo de pontos de acesso, requisitos limitados de negociação de servidor e um escopo bem definido alinhado com nossos objetivos. Reconhecemos que para alguns integradores, esta pode ser sua primeira experiência implementando chamadas de rede de terceiros. Se você é um desenvolvedor experiente em busca de implementação eficiente ou novo em APIs REST, projetamos a experiência para ser acessível e direta.

Próximas etapas

Encorajamos você a entrar em contato com nossa equipe se tiver dúvidas e prosseguir para o próximo guia desta série. Esperamos apoiar sua integração C2C.

Para uma visão geral técnica, consulte o guia de arquitetura de integração.