For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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
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
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!
