集成商检查表
集成商检查表
C2C 集成要求
此检查表概述了加入 C2C 生态系统的最佳做法和要求。 虽然并非每个项目都适用于所有 C2C 设备或应用程序,但 C2C 合作伙伴团队将与您合作,在 C2C 认证计划期间确定具体要求。
基本集成要求
所有集成都必须包括:
提供灵活的上传选项:
-
切换自动/手动上传
-
单个/批量文件选择
-
文件类型优先级排序(可选)
-
队列优先级排序(可选)
-
并行上传(可选)
-
允许取消单个或所有上传
-
视频/音频的时间码流
-
多格式上传支持(代理、OCF、LUT、WAV、RAW、JPG、HEIF、TIFF)
-
项目名称更改处理(使用
project_id而不是名称字符串)
清晰的指示信息:
-
剩余文件数量
-
剩余文件总大小
-
当前文件上传进度
-
已完成、已排队和失败上传的状态
网络连接状态显示,在 8 小时无用户交互或警报后自动刷新访问令牌(除非出现刷新错误)
其他要求:
- 每个步骤中的可取消授权流
- 实时通信的套接字状态
- 所有 HTTPS 端点调用中的固件版本标头
安全要求
在 Frame.io,安全至关重要。 我们的要求包括:
-
仅限 HTTPS 的请求(HTTP 请求被拒绝)
-
设备/应用程序与 Frame.io 的直接连接(无中介服务)
-
受保护的
client_secret和client_id(用户无法访问)* 受保护的access_token和refresh_token凭据 -
密钥和令牌的加密存储(可选但推荐)
上传程序要求
可靠的媒体上传至关重要,尤其是在有挑战性的条件下。 集成必须:
-
支持在录制期间的实时自动上传(首选),或文件完成后的自动上传
-
显示清晰的上传状态,包括上传队列和结果
-
将文件写入用户可访问的本地存储
维护稳固的上传队列,用于处理:
-
并发上传
-
网络中断
-
电源循环
针对以下情况实施自动重试:
-
网络问题
-
电源中断
-
非致命性错误(超时、网络错误、过期令牌)
-
从上次成功的分片恢复上传
-
遵循 PAUSED 状态
-
处理 AWS 非致命错误
-
管理损坏的媒体,而不阻塞其他上传
提供灵活的上传选项:
-
切换自动/手动上传
-
单个/批量文件选择
-
文件类型优先级排序(可选)
-
队列优先级排序(可选)
-
并行上传(可选)
-
允许取消单个或所有上传
网络要求
集成必须:
-
达到最低 50 Mbps 上传速度(网络条件允许)
-
支持 WPA2 WiFi 安全协议(推荐使用以太网但非必需)
-
处理 DHCP 和静态 IP
-
显示清晰的网络状态(连接类型、速度、运行状况)
-
在不重新配对项目的情况下切换网络
-
保存已知的 WiFi 网络
测试要求
C2C 专门设计用于有挑战性的条件,需要在以下各个方面进行全面测试:
测试所有适用的连接类型:
-
具有以下特性的商用路由器:
-
硬线 WAN
-
聚合蜂窝调制解调器
-
商用蜂窝调制解调器
-
便携热点式调制解调器
-
网状路由器设置(包括 802.11r 快速漫游协议)
-
支持直接连接到各种调制解调器类型
-
意外断电
-
网络断开
-
ISP 问题
-
损坏的媒体处理
-
离线资产创建和重新连接
工作流程要求
C2C 是一个生态系统,而不仅是一项功能。 设备/应用程序特定的要求包括:
-
相机自动录制触发器
-
灵活的相机选项
-
时间码偏移调整
-
手动录制功能
-
一致的文件名处理
-
准确的时间码同步
-
将文件名/时间码/元数据与主文件/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。 此检查表基于基础上传指南和高级上传指南构建而成。