← Cloudflare Realtime / realtime / realtimekit / recording-guide

Nahrání nahrávky do vašeho cloudu

Můžete předat volitelný objekt storage_config v požadavku na spuštění nahrávání, abyste mohli nahrávku publikovat přímo u vašeho poskytovatele cloudu. Pokud path je zadáno, nahrané video se uloží tam, jinak se výchozím umístěním stává kořen adresáře.

Název souboru pro nahrávání bude stejný jako ten uvedený v output_file_name.

Konfiguraci úložiště pro nahrávky RealtimeKit můžete nastavit následujícími způsoby:

Podrobnosti konfigurace úložiště pro všechny schůzky můžete zadat v RealtimeKit Dashboard.

1. V Cloudflare RealtimeKit Dashboard ↗, přejděte na kartu Recordings.
2. Klikněte na Nastavení úložiště.
3. Zadejte podrobnosti o svém cloudovém poskytovateli. Podporujeme přenos nahrávek do bucketů Cloudflare R2, AWS S3, Azure, DigitalOcean a Google Cloud Storage (GCS).

Chcete-li se seznámit s REST API RealtimeKit, doporučujeme prozkoumat RealtimeKit REST API.

Toto poskytuje nejpodrobnější úroveň řízení a umožňuje nastavit storage_config pro konkrétní Nahrávání zahájeno na schůzce.

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"
  }
}'

Chcete-li se seznámit s REST API RealtimeKit, doporučujeme prozkoumat RealtimeKit REST API.

Aktuálně jsou podporováni tito poskytovatelé cloudu:

Chcete-li přenášet nahrávky do Cloudflare R2, nastavte následující pole v storage_config parametr:

• Typ: Zadejte cloudflare.
• Access Key: Zadejte ID přístupového klíče R2. Další informace najdete zde: Vytváření API tokenů.
• Bucket: Zadejte název svého R2 bucketu.
• (Volitelné) Path: Zadejte cestu k podsložce, do které se mají záznamy přenášet. Pokud tento parametr nezadáte, záznamy se přenesou do kořenové složky bucketu.
• Tajný klíč: Zadejte svůj tajný přístupový klíč R2.
• Account ID: Zadejte ID svého účtu Cloudflare.

Chcete-li přenášet nahrávky do bucketu AWS S3, nastavte následující pole v storage_config parametr:

• Typ: Zadejte aws.
• Access Key: Zadejte svůj aws_access_key_id.
• Bucket: Zadejte název svého bucketu AWS S3.
• (Volitelné) Path: Zadejte cestu k podsložce, do které se mají záznamy přenášet. Pokud tento parametr nezadáte, záznamy se přenesou do kořenové složky bucketu.
• Tajný klíč: Zadejte svůj aws_secret_access_key.
• Region: Uveďte region, kde je umístěn váš bucket, například, ap-south-1.

Chcete-li přenášet nahrávky do služby Azure Blob Storage, nastavte následující pole v storage_config parametr:

• Typ: Zadejte azure.
• Access key: Zadejte svůj připojovací řetězec Azure. Další informace o tom, jak přístupový klíč získat, najdete zde: Zobrazit přístupový klíč účtu ↗.
• Bucket: Zadejte název svého kontejneru. Kontejner by měl být ve stejném účtu úložiště jako connection string.
• (Volitelné) Path: Zadejte cestu k podsložce, do které se mají záznamy přenášet. Pokud tento parametr nezadáte, záznamy se přenesou do kořenové složky kontejneru.
• Tajný klíč: Nastavte na prázdný řetězec "".
• Region: Nastavte na prázdný řetězec "".

Chcete-li přenášet nahrávky do DigitalOcean Spaces, nastavte následující pole v storage_config parametr:

• Typ: Zadejte digitalocean.
• Access key: Zadejte svůj přístupový klíč DigitalOcean. Další informace najdete zde: Vytvoření DigitalOcean Space a API klíče ↗.
• Bucket: Zadejte název svého bucketu Spaces.
• (Volitelné) Path: Zadejte cestu k podsložce, do které se mají záznamy přenášet. Pokud tento parametr nezadáte, záznamy se přenesou do kořenové složky kontejneru.
• Tajný klíč: Zadejte svůj tajný klíč Spaces.
• Region: Uveďte region, kde je umístěn váš bucket Spaces, například, SGP1. Další informace najdete v Matice dostupnosti regionů ↗.

Chcete-li přenášet nahrávky do GCS, nastavte následující pole v storage_config parametr:

• Typ: Zadejte gcs.
• Bucket: Zadejte název svého bucketu Cloud Storage.
• (Volitelné) Path: Zadejte cestu k podsložce, do které se mají záznamy přenášet. Pokud tento parametr nezadáte, záznamy se přenesou do kořenové složky kontejneru.
• Tajný klíč: Zadejte přihlašovací údaje účtu služby. Další informace najdete v přihlašovací údaje účtu služby ↗.
• Region: Uveďte region, kde je umístěn váš bucket Cloud Storage, například, US multi-region. Další informace najdete v Umístění bucketů ↗.

Název souboru nahrávky můžete změnit pomocí file_name_prefix pole. Výchozí formát názvu nahraného souboru je roomname_timestamp, ale k výchozímu názvu souboru můžete přidat alfanumerickou předponu s podtržítky.

Je důležité mít na paměti, že k výchozímu formátu můžete pouze přidat předponu, celý název souboru změnit nelze. Pokud například v 9:00 vyučujete pomocí RealtimeKit online hodinu fyziky, můžete přidat Physics_9am k názvu souboru. Physics_9am_roomname_timestamp by byl nový název souboru.

Další informace najdete v spustit nahrávání schůzky.