Lista de verificação do integrador

Requisitos de integração C2C

Esta lista de verificação descreve as práticas recomendadas e os requisitos para entrar no ecossistema C2C. Embora nem todos os itens se apliquem a todos os dispositivos ou aplicativos C2C, a equipe de Parcerias C2C trabalhará com você para definir requisitos específicos durante o Programa de certificação C2C.

Requisitos básicos de integração

Todas as integrações devem incluir:

Opções de upload

Fornecer opções flexíveis de upload:

  • Alternar uploads automáticos/manuais

  • Seleção individual/em lote de arquivos

  • Priorização de tipo de arquivo (opcional)

  • Priorização de fila (opcional)

  • Uploads paralelos (opcional)

  • Permitir cancelamento de uploads individuais ou de todos os uploads

Requisitos gerais
  • Fluxos de código de tempo para vídeo/áudio

  • Suporte a upload multiformato (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)

  • Gerenciamento de alteração de nome de projetos (use project_id em vez de strings de nomes)

Status do upload

Indicadores claros para:

  • Contagem de arquivos restantes

  • Tamanho total de arquivos restantes

  • Progresso do upload do arquivo atual

  • Status de uploads concluídos, em fila e com falha

Status da rede

Exibição do status da conexão de rede e atualização automática do token de acesso após 8 horas sem interação do usuário ou alertas (a menos que haja um erro de atualização)

Requisitos adicionais:

  • Fluxo de autorização cancelável em cada etapa
  • Status do socket para comunicação em tempo real
  • Cabeçalho da versão do firmware em todas as chamadas de ponto de acesso HTTPS

Requisitos de segurança

No Frame.io, a segurança é fundamental. Nossos requisitos incluem:

HTTPS e conexão direta
  • Solicitações somente HTTPS (solicitações HTTP são rejeitadas)

  • Conexão direta do dispositivo/aplicativo com o Frame.io (sem serviços intermediários)

Proteção de credenciais
  • client_secret e client_id protegidos (não acessíveis ao usuário) * Credenciais access_token e refresh_token protegidos

  • Armazenamento criptografado de segredos e tokens (opcional, mas recomendado)

Requisitos do carregador

O upload confiável de mídia é crucial, especialmente em condições desafiadoras. As integrações devem:

Recursos de upload
  • Oferecer suporte a uploads automáticos em tempo real durante a gravação (preferível) ou após a conclusão do arquivo

  • Mostrar status claro de upload, incluindo fila e resultados

  • Gravar arquivos no armazenamento local acessível ao usuário

Gerenciamento de fila

Manter uma fila de upload robusta que lida com:

  • Uploads simultâneos

  • Interrupções de rede

  • Ciclos de energia

Tratamento de erros

Implementar nova tentativa automática para:

  • Problemas de rede

  • Interrupções de energia

  • Erros não fatais (tempo-limite, erros de rede, tokens expirados)

Controle de upload
  • Retomar uploads do último bloco bem-sucedido

  • Honrar o estado PAUSADO

  • Lidar com erros não fatais da AWS

  • Gerenciar mídia corrompida sem bloquear outros uploads

Opções de upload

Fornecer opções flexíveis de upload:

  • Alternar uploads automáticos/manuais

  • Seleção individual/em lote de arquivos

  • Priorização de tipo de arquivo (opcional)

  • Priorização de fila (opcional)

  • Uploads paralelos (opcional)

  • Permitir cancelamento de uploads individuais ou de todos os uploads

Requisitos de rede

As integrações devem:

Velocidade e segurança
  • Atingir velocidades mínimas de upload de 50 Mbps (permitindo condições de rede)

  • Suporte à segurança Wi-Fi WPA2 (Ethernet opcional, mas recomendado)

Gerenciamento de rede
  • Gerenciar DHCP e IP estático

  • Exibir status claro da rede (tipo de conexão, velocidade, integridade)

  • Alternar redes sem reemparelhamento do projeto

  • Salvar redes Wi-Fi conhecidas

Requisitos de teste

O C2C foi projetado para condições desafiadoras, exigindo teste completo em:

Configurações de rede

Teste todos os tipos de conexão aplicáveis:

  • Roteador comercial com:

  • WAN com fio

  • Modem celular vinculado

  • Modem celular comercial

  • Modem estilo ponto de acesso

  • Configurações de roteador em malha (incluindo protocolo 802.11r FT)

  • Conexões diretas a vários tipos de modem

Teste de resistência
  • Quedas de energia inesperadas

  • Desconexões de rede

  • Problemas de provedor de acesso a Internet

  • Manipulação de mídia corrompida

  • Criação de ativo offline e reconexão

Requisitos do fluxo de trabalho

O C2C é um ecossistema, não apenas um recurso. Os requisitos específicos para dispositivo/aplicativo incluem:

Gravação SDI/HDMI
  • Acionador de gravação automática da câmera

  • Opções flexíveis de câmera

  • Ajuste de deslocamento de código de tempo

  • Capacidade de gravação manual

  • Manuseio consistente de nome de arquivo

  • Sincronização precisa de código de tempo

Arquivos proxy
  • Nome de arquivo/código de tempo/metadados de combinação com arquivo principal/OCF

  • Otimizado para LTE (taxa de bits de 1-12 Mbps)

  • Suporte para codec padrão para vídeo e áudio

Requisitos gerais
  • Fluxos de código de tempo para vídeo/áudio

  • Suporte a upload multiformato (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)

  • Gerenciamento de alteração de nome de projetos (use project_id em vez de strings de nomes)

Controle de qualidade

No Frame.io, a qualidade é essencial. As principais áreas de teste incluem:

Funcionalidade básica
  • Inicialização e operação estáveis

  • Conexão do projeto

  • Geração de código de hardware

  • Capacidade de fazer login/logout

  • Exibição de informações do projeto/usuário

  • Gerenciamento de dispositivos

  • Upload de ativos

  • Suporte a formatos

Requisitos técnicos
  • Retomada de upload após interrupções

  • Exibição de progresso

  • Indicação de status de rede

  • Persistência de conexão de 8 horas

  • Autorização cancelável

  • Conexão direta com Frame.io

  • Segurança de credenciais

  • Otimização de velocidade da rede

Melhorias futuras

A API Frame.io Camera to Cloud evolui continuamente. Mantendo a compatibilidade com versões anteriores, aceitamos o diálogo contínuo sobre desenvolvimentos futuros para manter nossa API alinhada com o uso do mundo real.

É isso, pessoal!

Parabéns por concluir o UC2CIG (University of C2C Integration Guides)! Esperamos que este guia tenha sido útil.

Compartilhe qualquer comentário sobre informações pouco claras ou ausentes ou entre em contato com perguntas relacionadas ao C2C. Estamos aqui para ajudar!

Caso ainda não tenha feito isso, revise o guia Implementação do C2C: Configuração antes de prosseguir. Você precisará do access_token obtido durante o processo de autenticação e autorização. Esta lista de verificação se baseia no guia de Uploads básicos e no guia de Uploads avançados.