AI automatically translates all comments in the code into English (#3917)

api/include/mk_recorder.h

@@ -17,19 +17,28 @@
 extern "C" {
 #endif
 
-///////////////////////////////////////////flv录制/////////////////////////////////////////////
+// /////////////////////////////////////////flv录制/////////////////////////////////////////////  [AUTO-TRANSLATED:a084663f]
+// /////////////////////////////////////////flv录制/////////////////////////////////////////////
 
 typedef struct mk_flv_recorder_t *mk_flv_recorder;
 
 /**
  * 创建flv录制器
  * @return
+ * Create flv recorder
+ * @return
+ 
+ * [AUTO-TRANSLATED:7582cde1]
  */
 API_EXPORT mk_flv_recorder API_CALL mk_flv_recorder_create();
 
 /**
  * 释放flv录制器
  * @param ctx
+ * Release flv recorder
+ * @param ctx
+ 
+ * [AUTO-TRANSLATED:c33c76bb]
  */
 API_EXPORT void API_CALL mk_flv_recorder_release(mk_flv_recorder ctx);
 
@@ -41,10 +50,20 @@ API_EXPORT void API_CALL mk_flv_recorder_release(mk_flv_recorder ctx);
  * @param stream 绑定的RtmpMediaSource的 stream名
  * @param file_path 文件存放地址
  * @return 0:开始超过，-1:失败,打开文件失败或该RtmpMediaSource不存在
+ * Start recording flv
+ * @param ctx flv recorder
+ * @param vhost virtual host
+ * @param app app name of the bound RtmpMediaSource
+ * @param stream stream name of the bound RtmpMediaSource
+ * @param file_path file storage address
+ * @return 0: start exceeds, -1: failure, file opening fails or the RtmpMediaSource does not exist
+ 
+ * [AUTO-TRANSLATED:194cf3de]
  */
 API_EXPORT int API_CALL mk_flv_recorder_start(mk_flv_recorder ctx, const char *vhost, const char *app, const char *stream, const char *file_path);
 
-///////////////////////////////////////////hls/mp4录制/////////////////////////////////////////////
+// /////////////////////////////////////////hls/mp4录制/////////////////////////////////////////////  [AUTO-TRANSLATED:99c61c68]
+// /////////////////////////////////////////hls/mp4录制/////////////////////////////////////////////
 
 /**
  * 获取录制状态
@@ -53,6 +72,14 @@ API_EXPORT int API_CALL mk_flv_recorder_start(mk_flv_recorder ctx, const char *v
  * @param app 应用名
  * @param stream 流id
  * @return 录制状态,0:未录制, 1:正在录制
+ * Get recording status
+ * @param type 0: hls, 1: MP4
+ * @param vhost virtual host
+ * @param app application name
+ * @param stream stream id
+ * @return recording status, 0: not recording, 1: recording
+ 
+ * [AUTO-TRANSLATED:0b1d374a]
  */
 API_EXPORT int API_CALL mk_recorder_is_recording(int type, const char *vhost, const char *app, const char *stream);
 
@@ -65,6 +92,16 @@ API_EXPORT int API_CALL mk_recorder_is_recording(int type, const char *vhost, co
  * @param customized_path 录像文件保存自定义目录，默认为空或null则自动生成
  * @param max_second mp4录制最大切片时间，单位秒，置0则采用配置文件配置
  * @return 1代表成功，0代表失败
+ * Start recording
+ * @param type 0: hls-ts, 1: MP4, 2: hls-fmp4, 3: http-fmp4, 4: http-ts
+ * @param vhost virtual host
+ * @param app application name
+ * @param stream stream id
+ * @param customized_path custom directory for saving recording files, defaults to empty or null, automatically generated
+ * @param max_second maximum slice time for mp4 recording, in seconds, set to 0 to use the configuration file configuration
+ * @return 1 represents success, 0 represents failure
+ 
+ * [AUTO-TRANSLATED:0a1c8c3e]
  */
 API_EXPORT int API_CALL mk_recorder_start(int type, const char *vhost, const char *app, const char *stream, const char *customized_path, size_t max_second);
 
@@ -75,6 +112,15 @@ API_EXPORT int API_CALL mk_recorder_start(int type, const char *vhost, const cha
  * @param app 应用名
  * @param stream 流id
  * @return 1:成功，0：失败
+ * Stop recording
+ * @param type 0: hls-ts, 1: MP4, 2: hls-fmp4, 3: http-fmp4, 4: http-ts
+ * @param vhost virtual host
+ * @param app application name
+ * @param stream stream id
+ * @return 1: success, 0: failure
+ 
+ 
+ * [AUTO-TRANSLATED:df1638e7]
  */
 API_EXPORT int API_CALL mk_recorder_stop(int type, const char *vhost, const char *app, const char *stream);