添加util相关函数，整理库文件名

2026-06-19 14:52:20 +08:00 · 2019-12-27 10:10:31 +08:00
parent 528e4fffe5
commit 5b43b2c004
25 changed files with 228 additions and 74 deletions
--- a/api/include/mk_common.h
+++ b/api/include/mk_common.h
@@ -0,0 +1,147 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2019 xiongziliang <771730766@qq.com>
+ *
+ * This file is part of ZLMediaKit(https://github.com/xiongziliang/ZLMediaKit).
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#ifndef MK_COMMON_H
+#define MK_COMMON_H
+
+#include <stdint.h>
+
+#if defined(_WIN32)
+#if defined(MediaKitApi_EXPORTS)
+		#define API_EXPORT __declspec(dllexport)
+	#else
+		#define API_EXPORT __declspec(dllimport)
+	#endif
+
+	#define API_CALL __cdecl
+#else
+#define API_EXPORT
+#define API_CALL
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef struct {
+    // 线程数
+    int thread_num;
+    // 日志级别,支持0~4
+    int log_level;
+
+    // 配置文件是内容还是路径
+    int ini_is_path;
+    // 配置文件内容或路径，可以为NULL,如果该文件不存在，那么将导出默认配置至该文件
+    const char *ini;
+
+    // ssl证书是内容还是路径
+    int ssl_is_path;
+    // ssl证书内容或路径，可以为NULL
+    const char *ssl;
+    // 证书密码，可以为NULL
+    const char *ssl_pwd;
+} mk_config;
+
+/**
+ * 初始化环境，调用该库前需要先调用此函数
+ * @param cfg 库运行相关参数
+ */
+API_EXPORT void API_CALL mk_env_init(const mk_config *cfg);
+
+/**
+ * 关闭所有服务器，请在main函数退出时调用
+ */
+API_EXPORT void API_CALL mk_stop_all_server();
+
+/**
+ * 基础类型参数版本的mk_env_init，为了方便其他语言调用
+ * @param thread_num 线程数
+ * @param log_level 日志级别,支持0~4
+ * @param ini_is_path 配置文件是内容还是路径
+ * @param ini 配置文件内容或路径，可以为NULL,如果该文件不存在，那么将导出默认配置至该文件
+ * @param ssl_is_path ssl证书是内容还是路径
+ * @param ssl ssl证书内容或路径，可以为NULL
+ * @param ssl_pwd 证书密码，可以为NULL
+ */
+API_EXPORT void API_CALL mk_env_init1( int thread_num,
+                                        int log_level,
+                                        int ini_is_path,
+                                        const char *ini,
+                                        int ssl_is_path,
+                                        const char *ssl,
+                                        const char *ssl_pwd);
+
+/**
+ * 设置配置项
+ * @param key 配置项名
+ * @param val 配置项值
+ */
+API_EXPORT void API_CALL mk_set_option(const char *key, const char *val);
+
+/**
+ * 创建http[s]服务器
+ * @param port htt监听端口，推荐80，传入0则随机分配
+ * @param ssl 是否为ssl类型服务器
+ * @return 0:失败,非0:端口号
+ */
+API_EXPORT uint16_t API_CALL mk_http_server_start(uint16_t port, int ssl);
+
+/**
+ * 创建rtsp[s]服务器
+ * @param port rtsp监听端口，推荐554，传入0则随机分配
+ * @param ssl 是否为ssl类型服务器
+ * @return 0:失败,非0:端口号
+ */
+API_EXPORT uint16_t API_CALL mk_rtsp_server_start(uint16_t port, int ssl);
+
+/**
+ * 创建rtmp[s]服务器
+ * @param port rtmp监听端口，推荐1935，传入0则随机分配
+ * @param ssl 是否为ssl类型服务器
+ * @return 0:失败,非0:端口号
+ */
+API_EXPORT uint16_t API_CALL mk_rtmp_server_start(uint16_t port, int ssl);
+
+/**
+ * 创建rtp服务器
+ * @param port rtp监听端口(包括udp/tcp)
+ * @return 0:失败,非0:端口号
+ */
+API_EXPORT uint16_t API_CALL mk_rtp_server_start(uint16_t port);
+
+/**
+ * 创建shell服务器
+ * @param port shell监听端口
+ * @return 0:失败,非0:端口号
+ */
+API_EXPORT uint16_t API_CALL mk_shell_server_start(uint16_t port);
+
+#ifdef __cplusplus
+}
+#endif
+
+
+#endif /* MK_COMMON_H */