Lista de verificação do integrador
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:
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
-
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_idem vez de strings de nomes)
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
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:
-
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)
-
client_secreteclient_idprotegidos (não acessíveis ao usuário) * Credenciaisaccess_tokenerefresh_tokenprotegidos -
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:
-
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
Manter uma fila de upload robusta que lida com:
-
Uploads simultâneos
-
Interrupções de rede
-
Ciclos de energia
Implementar nova tentativa automática para:
-
Problemas de rede
-
Interrupções de energia
-
Erros não fatais (tempo-limite, erros de rede, tokens expirados)
-
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
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:
-
Atingir velocidades mínimas de upload de 50 Mbps (permitindo condições de rede)
-
Suporte à segurança Wi-Fi WPA2 (Ethernet opcional, mas recomendado)
-
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:
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
-
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:
-
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
-
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
-
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_idem vez de strings de nomes)
Controle de qualidade
No Frame.io, a qualidade é essencial. As principais áreas de teste incluem:
-
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
-
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.