> This page is for Camera to Cloud.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# 集成商检查表

## C2C 集成要求





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





## 基本集成要求





所有集成都必须包括：




<CardGroup cols={2}>
  
  
<Card icon="sliders" title="上传选项">
  
  

提供灵活的上传选项：


  

* 切换自动/手动上传


  

* 单个/批量文件选择


  

* 文件类型优先级排序（可选）


  

* 队列优先级排序（可选）


  

* 并行上传（可选）


  

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



</Card>

<Card icon="list-check" title="常规要求">
  
  

* 视频/音频的时间码流


  

* 多格式上传支持（代理、OCF、LUT、WAV、RAW、JPG、HEIF、TIFF）

* 项目名称更改处理（使用 `project_id` 而不是名称字符串）
</Card>

<Card icon="upload" title="上传状态">
  
    

清晰的指示信息：


    

* 剩余文件数量


    

* 剩余文件总大小


    

* 当前文件上传进度


    

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


  
</Card>

<Card icon="network-wired" title="网络状态">
  
    

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


  
</Card>

</CardGroup>


其他要求：



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




## 安全要求

在 [Frame.io](http://frame.io/)，安全至关重要。 我们的要求包括：
<CardGroup cols={2}>
  
  
<Card icon="shield-halved" title="HTTPS 和直接连接">
  
    

* 仅限 HTTPS 的请求（HTTP 请求被拒绝）

* 设备/应用程序与 [Frame.io](http://frame.io/) 的直接连接（无中介服务）
</Card>

<Card icon="lock" title="凭据保护">
  * 受保护的 `client_secret` 和 `client_id`（用户无法访问）* 受保护的 `access_token` 和 `refresh_token` 凭据

* 密钥和令牌的加密存储（可选但推荐）


  
</Card>

</CardGroup>


## 上传程序要求





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




<CardGroup cols={2}>
  
  
<Card icon="upload" title="上传功能">
  
    

* 支持在录制期间的实时自动上传（首选），或文件完成后的自动上传


    

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


    

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


  
</Card>

<Card icon="list" title="队列管理">
  
    

维护稳固的上传队列，用于处理：


    

* 并发上传


    

* 网络中断


    

* 电源循环


  
</Card>

</CardGroup>

<CardGroup cols={2}>
  
  
<Card icon="triangle-exclamation" title="错误处理">
  
    

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


    

* 网络问题


    

* 电源中断


    

* 非致命性错误（超时、网络错误、过期令牌）


  
</Card>

<Card icon="play" title="上传控制">
  
    

* 从上次成功的分片恢复上传

* 遵循 **PAUSED** 状态

* 处理 AWS 非致命错误


    

* 管理损坏的媒体，而不阻塞其他上传


  
</Card>

</CardGroup>

<Card icon="sliders" title="上传选项">
  
  

提供灵活的上传选项：


  

* 切换自动/手动上传


  

* 单个/批量文件选择


  

* 文件类型优先级排序（可选）


  

* 队列优先级排序（可选）


  

* 并行上传（可选）


  

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



</Card>


## 网络要求





集成必须：




<CardGroup cols={2}>
  
  
<Card icon="gauge-high" title="速度与安全">
  
    

* 达到最低 50 Mbps 上传速度（网络条件允许）


    

* 支持 WPA2 WiFi 安全协议（推荐使用以太网但非必需）


  
</Card>

<Card icon="network-wired" title="网络管理">
  
    

* 处理 DHCP 和静态 IP


    

* 显示清晰的网络状态（连接类型、速度、运行状况）


    

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


    

* 保存已知的 WiFi 网络


  
</Card>

</CardGroup>


## 测试要求





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




<CardGroup cols={2}>
  
  
<Card icon="network-wired" title="网络配置">
  
    

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


    

* 具有以下特性的商用路由器：


      

- 硬线 WAN


      

- 聚合蜂窝调制解调器


      

- 商用蜂窝调制解调器


      

- 便携热点式调制解调器


    

* 网状路由器设置（包括 802.11r 快速漫游协议）


    

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


  
</Card>

<Card icon="bolt" title="弹性测试">
  
    

* 意外断电


    

* 网络断开


    

* ISP 问题


    

* 损坏的媒体处理


    

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


  
</Card>

</CardGroup>


## 工作流程要求





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




<CardGroup cols={2}>
  
  
<Card icon="video" title="SDI/HDMI 录制">
  
    

* 相机自动录制触发器


    

* 灵活的相机选项


    

* 时间码偏移调整


    

* 手动录制功能


    

* 一致的文件名处理


    

* 准确的时间码同步


  
</Card>

<Card icon="file-video" title="代理文件">
  
    

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


    

* LTE 优化（1-12 Mbps 比特率）


    

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


  
</Card>

</CardGroup>

<Card icon="list-check" title="常规要求">
  
  

* 视频/音频的时间码流


  

* 多格式上传支持（代理、OCF、LUT、WAV、RAW、JPG、HEIF、TIFF）

* 项目名称更改处理（使用 `project_id` 而不是名称字符串）
</Card>


## 质量保证

对 [Frame.io](http://frame.io/) 来说，质量至关重要。 关键测试领域包括：
<CardGroup cols={2}>
  
  
<Card icon="check" title="基本功能">
  
    

* 稳定启动和运行


    

* 项目连接


    

* 硬件代码生成


    

* 登录/注销功能


    

* 项目/用户信息显示


    

* 设备管理


    

* 资产上传


    

* 格式支持


  
</Card>

<Card icon="gear" title="技术要求">
  
    

* 中断后恢复上传


    

* 进度显示


    

* 网络状态指示


    

* 8 小时持续连接


    

* 可取消授权


    

* 直接连接 Frame.io


    

* 凭据安全


    

* 网络速度优化


  
</Card>

</CardGroup>


## 未来改进

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

## 就是这些了，各位！





恭喜您完成 UC2CIG（C2C 集成指南大学）的学习！ 希望本指南对您有所帮助。





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

如果您还没有阅读，请在继续之前先查阅[实施 C2C：设置](./implementing-c2c-setting-up)指南。 您需要用到在[身份验证和授权流程](./implementing-c2c-authentication-and-authorization)中获取的 `access_token`。 此检查表基于[基础上传指南](./how-to-basic-upload)和[高级上传指南](./how-to-advanced-uploads)构建而成。