跳转到内容
搜索文档

开始录制

最后更新 查看 MarkdownAgent 设置

本主题介绍如何使用 RealtimeKit 实现混合录制。

在开始阅读本指南之前,我们建议您先阅读快速入门 RealtimeKit以熟悉 RealtimeKit。

要熟悉 RealtimeKit REST API,我们建议您探索 RealtimeKit REST API

有三种方法可以开始录制 RealtimeKit 会议:

RealtimeKit 会将录制保留 7 天,之后它们将过期且无法再访问。在链接过期之前下载录制副本或设置存储非常重要。

使用 record_on_start 参数

创建会议时,您可以指定 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

您也可以使用 Start Recording API 开始录制。

指定您想要录制的会议的 meeting ID

使用应用程序的 List meetings APICreate a meeting API 获取会议 ID。API 会返回一个名为 id 的参数,它就是您的会议 ID。

请求

调用 Start Recording APIbash
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"
		}
	}
}

这篇文档对您有帮助吗?