本主题介绍如何使用 RealtimeKit 实现混合录制。
在开始阅读本指南之前,我们建议您先阅读快速入门 RealtimeKit以熟悉 RealtimeKit。
要熟悉 RealtimeKit REST API,我们建议您探索 RealtimeKit REST API。
有三种方法可以开始录制 RealtimeKit 会议:
- 在创建会议时使用
record_on_start标志 - 使用 Start Recording API
- SDK 上的客户端开始录制方法
RealtimeKit 会将录制保留 7 天,之后它们将过期且无法再访问。在链接过期之前下载录制副本或设置存储非常重要。
在创建会议时,您可以指定 record_on_start 参数,以便在有人加入会议时立即开始录制。
指定 record_on_start 参数。如果此标志为 true,那么一旦 RealtimeKit 会议开始(即当第一位参与者加入会议时),录制就会启动。
curl --location 'https://api.cloudflare.com/client/v4/accounts/<account_id>/realtime/kit/<app_id>/meetings' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api_token>' \
--data '{
"title": "Lorem Ipsum",
"record_on_start": true
}'{
"success": true,
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"record_on_start": true,
"created_at": "2025-08-24T14:15:22Z",
"updated_at": "2025-08-24T14:15:22Z"
}
}您也可以使用 Start Recording API 开始录制。
指定您想要录制的会议的 meeting ID。
使用应用程序的 List meetings API 或 Create a meeting API 获取会议 ID。API 会返回一个名为 id 的参数,它就是您的会议 ID。
curl --location 'https://api.cloudflare.com/client/v4/accounts/<account_id>/realtime/kit/<app_id>/recordings' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api_token>' \
--data '{
"meeting_id": "97440c6a-140b-40a9-9499-b23fd7a3868a"
}'{
"success": true,
"data": {
"id": "97440c6a-140b-40a9-9499-b23fd7a3868a",
"download_url": "http://example.com",
"download_url_expiry": "2025-08-24T14:15:22Z",
"download_audio_url": "http://example1.com",
"file_size": 0,
"session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
"output_file_name": "string",
"status": "INVOKED",
"invoked_time": "2025-08-24T14:15:22Z",
"started_time": "2025-08-24T14:15:22Z",
"stopped_time": "2025-08-24T14:15:22Z",
"storage_config": {
"type": "cloudflare",
"secret_key": "string",
"bucket": "string",
"path": "string"
}
}
}