録画を自分のクラウドへアップロードする

録画開始リクエストに、任意のオブジェクト storage_config を渡すと、録画を自分のクラウドプロバイダーへ直接公開できます。path を指定した場合、録画した動画はその場所に保存されます。指定しない場合は、ディレクトリのルートがデフォルトです。

録画のファイル名は、output_file_name で指定した名前と同じになります。

RealtimeKit の録画向けストレージ構成は、次の方法で設定できます。

RealtimeKit ダッシュボードで、すべてのミーティング向けのストレージ構成を指定できます。

1. Cloudflare の RealtimeKit ダッシュボード ↗ で、Recordings タブを開きます。
2. Setup Storage をクリックします。
3. クラウドプロバイダーの詳細を指定します。録画の転送先として、Cloudflare R2、AWS S3、Azure、DigitalOcean、Google Cloud Storage (GCS) のバケットに対応しています。

RealtimeKit REST API に慣れるには、RealtimeKit REST API を参照することをおすすめします。

最も細かい単位で制御できます。特定のミーティングで 開始した録画 ごとに storage_config を指定できます。

curl --request POST \
  --url https://api.cloudflare.com/client/v4/accounts/<account_id>/realtime/kit/<app_id>/recordings \
  --header 'Authorization: Bearer <api_authorization_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "meeting_id": "97440c6a-140b-40a9-9499-b23fd7a3868a",
  "storage_config": {
    "type": "cloudflare",
    "access_key": "your-access-key",
    "secret": "your-secret-key",
    "bucket": "your-bucket-name",
    "path": "/",
    "account_id": "your-account-id"
  }
}'

RealtimeKit REST API に慣れるには、RealtimeKit REST API を参照することをおすすめします。

現在、次のクラウドプロバイダーに対応しています。

録画を Cloudflare R2 へ転送するには、storage_config パラメーターで次のフィールドを設定します。

• Type: cloudflare を指定します。
• Access Key: R2 のアクセスキー ID を入力します。詳細は API トークンを作成する を参照してください。
• Bucket: R2 バケットの名前を入力します。
• （任意）Path: 録画の転送先サブフォルダーのパスを指定します。このパラメーターを渡さない場合、録画はバケットのルートフォルダーへ転送されます。
• Secret: R2 のシークレットアクセスキーを入力します。
• Account ID: Cloudflare のアカウント ID を入力します。

録画を AWS S3 バケットへ転送するには、storage_config パラメーターで次のフィールドを設定します。

• Type: aws を指定します。
• Access Key: aws_access_key_id を入力します。
• Bucket: AWS S3 バケット名を入力します。
• （任意）Path: 録画の転送先サブフォルダーのパスを指定します。このパラメーターを渡さない場合、録画はバケットのルートフォルダーへ転送されます。
• Secret: aws_secret_access_key を入力します。
• Region: バケットがあるリージョンを指定します。例: ap-south-1。

録画を Azure Blob Storage へ転送するには、storage_config パラメーターで次のフィールドを設定します。

• Type: azure を指定します。
• Access key: Azure の接続文字列を入力します。アクセスキーの取得方法は View account access key ↗ を参照してください。
• Bucket: コンテナー名を入力します。コンテナーは、接続文字列と同じストレージアカウント内である必要があります。
• （任意）Path: 録画の転送先サブフォルダーのパスを指定します。このパラメーターを渡さない場合、録画はコンテナーのルートフォルダーへ転送されます。
• Secret: 空文字列 "" を設定します。
• Region: 空文字列 "" を設定します。

録画を DigitalOcean Spaces へ転送するには、storage_config パラメーターで次のフィールドを設定します。

• Type: digitalocean を指定します。
• Access key: DigitalOcean のアクセスキーを入力します。詳細は Create DigitalOcean Space and API Key ↗ を参照してください。
• Bucket: Spaces バケットの名前を入力します。
• （任意）Path: 録画の転送先サブフォルダーのパスを指定します。このパラメーターを渡さない場合、録画はコンテナーのルートフォルダーへ転送されます。
• Secret: Spaces のシークレットを入力します。
• Region: Spaces バケットがあるリージョンを指定します。例: SGP1。詳細は Region Availability Matrix ↗ を参照してください。

録画を GCS へ転送するには、storage_config パラメーターで次のフィールドを設定します。

• Type: gcs を指定します。
• Bucket: Cloud Storage バケットの名前を入力します。
• （任意）Path: 録画の転送先サブフォルダーのパスを指定します。このパラメーターを渡さない場合、録画はコンテナーのルートフォルダーへ転送されます。
• Secret: サービスアカウントの認証情報を入力します。詳細は service account credentials ↗ を参照してください。
• Region: Cloud Storage バケットがあるリージョンを指定します。例: US multi-region。詳細は Bucket locations ↗ を参照してください。

file_name_prefix フィールドで、録画ファイルの名前を変更できます。録画ファイル名のデフォルト形式は roomname_timestamp です。デフォルトのファイル名に、英数字とアンダースコアのプレフィックスを付けられます。

変更できるのはデフォルト形式へのプレフィックス追加だけです。ファイル名全体は変更できません。たとえば、RealtimeKit で午前 9 時のオンライン物理の授業をする場合、ファイル名に Physics_9am を付けられます。新しいファイル名は Physics_9am_roomname_timestamp になります。

詳細は ミーティングの録画を開始する を参照してください。