> 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.

# Camera to Cloud 之道

## 什么是 Camera to Cloud API？





Camera to Cloud (C2C) API 提供了一种安全的方法，可在录制完成后立即将媒体直接传输到 Frame.io，无需额外的用户输入。 Frame.io 致力于在录制停止或输入元数据后立即提供媒体，以便进行审阅和协作。





在开发过程中，我们确定为了向集成商和用户提供最佳体验，C2C API 需要作为其自己的专门后端系统运行，与 Frame.io 的主要生态系统分离开来。 虽然这一架构决策乍看之下可能不太直观，但本文档通过探讨 C2C 背后的指导原则来解释我们这样做的理由。





## 不止是相机素材





虽然为了清晰和识别而命名为“Camera to Cloud”，但 API 的功能却不仅限于处理相机素材。 C2C API 可以处理许多类型的数字内容。 无论您的设备是制作音频、视频、PDF 还是其他文件类型，Frame.io 都可以容纳它们。 该 API 可简化任何数字资产从创建到云存储的传输过程，最大限度地减少阻力。





## 只写不读





Frame.io 保持严格的安全标准，引入设备连接会带来潜在的安全考虑因素。 许多媒体捕获设备缺乏密码或屏幕锁定等传统的安全功能，因为它们最初并非为网络连接而设计。 为这些设备提供完整的 Frame.io API 访问权限可能会在无人看管时产生安全漏洞。





此外，设备操作员通常只需要访问特定元素，而不是整个项目。 他们的角色可能仅限于创建特定媒体资产，而不是管理完整项目。





这促成了我们的核心设计原则：录制设备的主要用途是创作媒体，而不是审阅或评论来自其他来源的内容。 最佳的安全方法是开发一个专门限制在其基本功能的 API，即将数据上传到云。 通过完全消除读取功能，我们可以有效地防止对敏感项目信息的未经授权访问。





## 为界面有限的设备而设计





Frame.io 的现有 API 在设计时假定其将与具有图形用户界面的应用程序进行交互。 这些应用程序可以向用户显示选项，让用户做出选择，然后将这些选择发送到服务器。





不过，C2C 生态系统包含 GUI 功能有限或无 GUI 功能的物理设备，这些设备还可能没有用户输入机制。 这需要一种截然不同的用户交互方法。





在设计 C2C 时，我们需要创建一个能够在界面功能有限的设备上有效运行的系统。 这意味着要开发一个不需要在设备本身上进行用户输入的交互模式，因为在许多情况下这种输入可能无法实现。





这一约束消除了使用现有 API 架构的可能性，这种现有架构依赖于基于 Web 的身份验证流程和用户对目标文件夹的选择。 我们需要简化的不仅是设备可以执行的操作，还有围绕这些操作的整个用户体验。





## 适应间歇性连接





除了界面限制之外，C2C 生态系统中的许多设备在网络连接不稳定的环境中运行。 我们设计的 API 旨在最大限度地减少后端通信，减少操作期间必要的调用数量，从而确保在 WiFi 或蜂窝网络服务有限的偏远地区工作的专业人士获得可靠的体验。





## 简化集成





我们的首要任务是让集成尽可能简单直接。 我们开发了一套功能聚焦的 API，其中仅包含最少的端点数量和有限的服务器协商要求，且业务范围严格限定在我们的目标之内。 我们认识到，对于某些集成商来说，这可能是他们第一次体验实施第三方网络调用。 无论您是寻求高效实施的经验丰富的开发人员，还是 REST API 新手，我们都设计了易于访问和简单明了的体验。





## 后续步骤





如有任何疑问，欢迎随时联系我们的团队，然后继续阅读本系列的下一部分指南。 我们期待为您的 C2C 集成提供支持。

有关技术概述，请参阅[集成架构指南](./integration-architecture)。