The Zen of 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 機能がないか制限されている物理デバイスが含まれており、ユーザー入力メカニズムがない可能性があります。そのため、ユーザーの操作に対する根本的に異なるアプローチが必要でした。

C2C を設計する際には、インターフェイス機能が限られたデバイスで効果的に機能するシステムを構築する必要がありました。結果として、多くの場合入力が不可能となる場合を考慮して、デバイス自体でユーザー入力を必要としないモデルを開発することにつながりました。

この制約により、web ベースの認証フローとユーザーによるターゲットフォルダーの選択に依存していた、既存の API アーキテクチャを使用する可能性が排除されました。デバイスが実行できるアクションだけでなく、それらのアクションを取り巻く全体的なユーザーエクスペリエンスも簡素化する必要がありました。

断続的な接続への対応

C2C エコシステムの多くのデバイスは、インターフェイスの制限を超えて、予測不可能なネットワーク接続環境で動作します。バックエンド通信を最小限に抑えるように API を設計し、運用中に必要な呼び出し数を減らすことで、WiFi や携帯電話サービスが限られている遠隔地で働くプロフェッショナルに信頼性の高いエクスペリエンスを提供します。

統合の簡素化

当社の優先事項は、統合をできるだけ簡単にすることでした。当社は、エンドポイントのセットを最小限に抑え、サーバーネゴシエーション要件を制限し、当社の目標に沿って狭く定義されたスコープを備えた、焦点を絞った API を開発しました。一部のインテグレーターは、サードパーティのネットワーク呼び出しを初めて実装するかもしれません。効率的な実装を求めている経験豊富な開発者でも、REST API になじみのない開発者でも、使いやすくわかりやすいように設計されています。

次のステップ

ご不明な点がございましたら、当社チームまでお問い合わせください。その後、このシリーズの次のガイドにお進みください。お客様の C2C 統合をサポートできることを楽しみにしています。

技術的な概要については、統合アーキテクチャガイドを参照してださい。