Camera to Cloud 之道 | Frame.io API Documentation

什么是 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 集成提供支持。

有关技术概述，请参阅集成架构指南。