集成商检查表

C2C 集成要求

此检查表概述了加入 C2C 生态系统的最佳做法和要求。 虽然并非每个项目都适用于所有 C2C 设备或应用程序,但 C2C 合作伙伴团队将与您合作,在 C2C 认证计划期间确定具体要求。

基本集成要求

所有集成都必须包括:

上传选项

提供灵活的上传选项:

  • 切换自动/手动上传

  • 单个/批量文件选择

  • 文件类型优先级排序(可选)

  • 队列优先级排序(可选)

  • 并行上传(可选)

  • 允许取消单个或所有上传

常规要求
  • 视频/音频的时间码流

  • 多格式上传支持(代理、OCF、LUT、WAV、RAW、JPG、HEIF、TIFF)

  • 项目名称更改处理(使用 project_id 而不是名称字符串)

上传状态

清晰的指示信息:

  • 剩余文件数量

  • 剩余文件总大小

  • 当前文件上传进度

  • 已完成、已排队和失败上传的状态

网络状态

网络连接状态显示,在 8 小时无用户交互或警报后自动刷新访问令牌(除非出现刷新错误)

其他要求:

  • 每个步骤中的可取消授权流
  • 实时通信的套接字状态
  • 所有 HTTPS 端点调用中的固件版本标头

安全要求

Frame.io,安全至关重要。 我们的要求包括:

HTTPS 和直接连接
  • 仅限 HTTPS 的请求(HTTP 请求被拒绝)

  • 设备/应用程序与 Frame.io 的直接连接(无中介服务)

凭据保护
  • 受保护的 client_secretclient_id(用户无法访问)* 受保护的 access_tokenrefresh_token 凭据

  • 密钥和令牌的加密存储(可选但推荐)

上传程序要求

可靠的媒体上传至关重要,尤其是在有挑战性的条件下。 集成必须:

上传功能
  • 支持在录制期间的实时自动上传(首选),或文件完成后的自动上传

  • 显示清晰的上传状态,包括上传队列和结果

  • 将文件写入用户可访问的本地存储

队列管理

维护稳固的上传队列,用于处理:

  • 并发上传

  • 网络中断

  • 电源循环

错误处理

针对以下情况实施自动重试:

  • 网络问题

  • 电源中断

  • 非致命性错误(超时、网络错误、过期令牌)

上传控制
  • 从上次成功的分片恢复上传

  • 遵循 PAUSED 状态

  • 处理 AWS 非致命错误

  • 管理损坏的媒体,而不阻塞其他上传

上传选项

提供灵活的上传选项:

  • 切换自动/手动上传

  • 单个/批量文件选择

  • 文件类型优先级排序(可选)

  • 队列优先级排序(可选)

  • 并行上传(可选)

  • 允许取消单个或所有上传

网络要求

集成必须:

速度与安全
  • 达到最低 50 Mbps 上传速度(网络条件允许)

  • 支持 WPA2 WiFi 安全协议(推荐使用以太网但非必需)

网络管理
  • 处理 DHCP 和静态 IP

  • 显示清晰的网络状态(连接类型、速度、运行状况)

  • 在不重新配对项目的情况下切换网络

  • 保存已知的 WiFi 网络

测试要求

C2C 专门设计用于有挑战性的条件,需要在以下各个方面进行全面测试:

网络配置

测试所有适用的连接类型:

  • 具有以下特性的商用路由器:

  • 硬线 WAN

  • 聚合蜂窝调制解调器

  • 商用蜂窝调制解调器

  • 便携热点式调制解调器

  • 网状路由器设置(包括 802.11r 快速漫游协议)

  • 支持直接连接到各种调制解调器类型

弹性测试
  • 意外断电

  • 网络断开

  • ISP 问题

  • 损坏的媒体处理

  • 离线资产创建和重新连接

工作流程要求

C2C 是一个生态系统,而不仅是一项功能。 设备/应用程序特定的要求包括:

SDI/HDMI 录制
  • 相机自动录制触发器

  • 灵活的相机选项

  • 时间码偏移调整

  • 手动录制功能

  • 一致的文件名处理

  • 准确的时间码同步

代理文件
  • 将文件名/时间码/元数据与主文件/OCF 相匹配

  • LTE 优化(1-12 Mbps 比特率)

  • 支持视频和音频的标准编解码器

常规要求
  • 视频/音频的时间码流

  • 多格式上传支持(代理、OCF、LUT、WAV、RAW、JPG、HEIF、TIFF)

  • 项目名称更改处理(使用 project_id 而不是名称字符串)

质量保证

Frame.io 来说,质量至关重要。 关键测试领域包括:

基本功能
  • 稳定启动和运行

  • 项目连接

  • 硬件代码生成

  • 登录/注销功能

  • 项目/用户信息显示

  • 设备管理

  • 资产上传

  • 格式支持

技术要求
  • 中断后恢复上传

  • 进度显示

  • 网络状态指示

  • 8 小时持续连接

  • 可取消授权

  • 直接连接 Frame.io

  • 凭据安全

  • 网络速度优化

未来改进

Frame.io Camera to Cloud API 持续演进。 在保持向后兼容性的同时,我们欢迎就未来发展进行持续对话,确保 API 与实际使用情况保持一致。

就是这些了,各位!

恭喜您完成 UC2CIG(C2C 集成指南大学)的学习! 希望本指南对您有所帮助。

如有任何关于信息不清晰或缺失的反馈意见,或有任何与 C2C 相关的问题,请与我们联系。 我们愿意随时为您提供帮助!

如果您还没有阅读,请在继续之前先查阅实施 C2C:设置指南。 您需要用到在身份验证和授权流程中获取的 access_token。 此检查表基于基础上传指南高级上传指南构建而成。