インテグレーターのチェックリスト

C2C 統合要件

このチェックリストは、C2C エコシステムに参加するためのベストプラクティスと要件の概要を示しています。全項目がすべての C2C デバイスまたはアプリケーションに適用されるわけではありませんが、C2C パートナーシップチームは、C2C 認定プログラム中にお客様と協力して具体的な要件を定義します。

基本的な統合要件

すべての統合に、以下が含まれている必要があります。

User Code

Display a 6-digit code to the user. For web interfaces or QR code-capable devices, use the verification_url_complete to provide users a hyperlink option for logging in and selecting a project to connect to.

Project Display

Shows the connected project name so users can quickly verify their connection without searching through Frame.io’s UI

Upload Status

Clear indicators for:

  • Remaining file count
  • Total remaining file size
  • Current file upload progress
  • Status of completed, queued, and failed uploads
Network Status

Network connection status display and automatic access token refresh after 8 hours with no user interaction or alerts (unless there’s a refresh error)

その他の要件:

  • 各ステップでキャンセル可能な認証フロー
  • リアルタイム通信のソケットステータス
  • すべての HTTPS エンドポイント呼び出しのファームウェアバージョンヘッダー

セキュリティ要件

Frame.io では、セキュリティを最重要視しています。要件には、以下が含まれます。

HTTPS & Direct Connection
  • HTTPS-only requests (HTTP requests are rejected)
  • Direct device/application connection to Frame.io (no intermediary services)
Credential Protection
  • Protected client_secret and client_id (not user-accessible)
  • Protected access_token and refresh_token credentials
  • Encrypted storage of secrets and tokens (optional but recommended)

アップローダー要件

信頼性の高いメディアのアップロードは、特に過酷な条件では非常に重要です。統合の必須要件:

Upload Features
  • Support automatic uploads either in real-time during recording (preferred) or upon file completion
  • Show clear upload status, including queue and results
  • Write files to user-accessible local storage
Queue Management

Maintain a robust upload queue that handles:

  • Concurrent uploads
  • Network interruptions
  • Power cycles
Error Handling

Implement automatic retry for:

  • Network issues
  • Power interruptions
  • Non-fatal errors (timeouts, network errors, expired tokens)
Upload Control
  • Resume uploads from last successful chunk
  • Honor PAUSED state
  • Handle AWS non-fatal errors
  • Manage corrupted media without blocking other uploads
Upload Options

Provide flexible upload options:

  • Toggle automatic/manual uploads
  • Individual/bulk file selection
  • File type prioritization (optional)
  • Queue prioritization (optional)
  • Parallel uploads (optional)
  • Allow cancellation of individual or all uploads

ネットワーク要件

統合の必須要件:

Speed & Security
  • Achieve minimum 50Mbps upload speeds (network conditions permitting)
  • Support WPA2 WiFi security (Ethernet optional but recommended)
Network Management
  • Handle DHCP and static IP
  • Display clear network status (connection type, speed, health)
  • Switch networks without project re-pairing
  • Save known WiFi networks

テスト要件

C2C は過酷な条件向けに設計されており、以下の項目について徹底的なテストが必要です。

Network Configurations

Test all applicable connection types:

  • Commercial router with:
    • Hardline WAN
    • Bonded cellular modem
    • Commercial cellular modem
    • Hotspot-style modem
  • Meshed router setups (including 802.11r FT protocol)
  • Direct connections to various modem types
Resilience Testing
  • Unexpected power outages
  • Network disconnections
  • ISP issues
  • Corrupted media handling
  • Offline asset creation and reconnection

ワークフロー要件

C2C は単なる機能ではなく、エコシステムです。デバイス/アプリケーション固有の要件には次のものがあります。

SDI/HDMI Recording
  • Automatic recording trigger from camera
  • Flexible camera options
  • Timecode offset adjustment
  • Manual recording capability
  • Consistent filename handling
  • Accurate timecode synchronization
Proxy Files
  • Matching filename/timecode/metadata with hero file/OCF
  • LTE-optimized (1-12Mbps bitrate)
  • Standard codec support for video and audio
General Requirements
  • Timecode streams for video/audio
  • Multi-format upload support (Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
  • Project name change handling (use project_id instead of name strings)

品質保証

Frame.io では、品質を重要視しています。主なテスト領域は次のとおりです。

Basic Functionality
  • Stable launch and operation
  • Project connection
  • Hardware code generation
  • Login/logout capability
  • Project/user info display
  • Device management
  • Asset upload
  • Format support
Technical Requirements
  • Upload resumption after interruptions
  • Progress display
  • Network status indication
  • 8-hour connection persistence
  • Cancellable authorization
  • Direct Frame.io connection
  • Credential security
  • Network speed optimization

今後の改善点

Frame.io Camera to Cloud API は継続的に進化しています。後方互換性を維持しながら、API を実際の使用状況に合わせて調整するために、今後の開発に関してお客様からの継続的なフィードバックをお待ちしています。

どうぞよろしくお願い申し上げます。

UC2CIG(University of C2C Integration Guides)の修了、おつかれさまでした。このガイドがお役に立てれば幸いです。

不明点や不足している情報に関するフィードバック、または C2C 関連の質問については、当社までお問い合わせください。ご連絡をお待ちしております。

まだの場合は、C2C の実装:セットアップガイドを読んでから先へ進んでください。

認証および承認プロセス中に、access_token の取得が必要になります。

このチェックリストは、基本アップロードガイドおよび高度なアップロードガイドに基づいて作成されています。