ZLMediaKit/api/include/mk_rtp_server.h

/*
 * Copyright (c) 2016-present The ZLMediaKit project authors. All Rights Reserved.
 *
 * This file is part of ZLMediaKit(https://github.com/ZLMediaKit/ZLMediaKit).
 *
 * Use of this source code is governed by MIT-like license that can be found in the
 * LICENSE file in the root of the source tree. All contributing project authors
 * may be found in the AUTHORS file in the root of the source tree.
 */

#include "mk_common.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef struct mk_rtp_server_t *mk_rtp_server;

/**
 * 创建GB28181 RTP 服务器
 * @param port 监听端口，0则为随机
 * @param tcp_mode tcp模式(0: 不监听端口 1: 监听端口 2: 主动连接到服务端)
 * @param stream_id 该端口绑定的流id
 * @return
 * Create GB28181 RTP server
 * @param port Listening port, 0 for random
 * @param tcp_mode tcp mode (0: not listening to port 1: listening to port 2: actively connect to the server)
 * @param stream_id Stream id bound to this port
 * @return
 
 * [AUTO-TRANSLATED:0c5fd548]
 */
API_EXPORT mk_rtp_server API_CALL mk_rtp_server_create(uint16_t port, int tcp_mode, const char *stream_id);
API_EXPORT mk_rtp_server API_CALL mk_rtp_server_create2(uint16_t port, int tcp_mode, const char *vhost, const char *app, const char *stream_id);

/**
 * TCP 主动模式时连接到服务器是否成功的回调
 * Callback for whether the connection to the server is successful in TCP active mode
 
 * [AUTO-TRANSLATED:752e915a]
 */
typedef void(API_CALL *on_mk_rtp_server_connected)(void *user_data, int err, const char *what, int sys_err);

/**
 * TCP 主动模式时连接到服务器
 * @param @param ctx 服务器对象
 * @param dst_url 服务端地址
 * @param dst_port 服务端端口
 * @param cb 连接到服务器是否成功的回调
 * @param user_data 用户数据指针
 * @return
 * Connect to the server in TCP active mode
 * @param @param ctx Server object
 * @param dst_url Server address
 * @param dst_port Server port
 * @param cb Callback for whether the connection to the server is successful
 * @param user_data User data pointer
 * @return
 
 * [AUTO-TRANSLATED:e827d45a]
 */
API_EXPORT void API_CALL mk_rtp_server_connect(mk_rtp_server ctx, const char *dst_url, uint16_t dst_port, on_mk_rtp_server_connected cb, void *user_data);
API_EXPORT void API_CALL mk_rtp_server_connect2(mk_rtp_server ctx, const char *dst_url, uint16_t dst_port, on_mk_rtp_server_connected cb, void *user_data, on_user_data_free user_data_free);

/**
 * 销毁GB28181 RTP 服务器
 * @param ctx 服务器对象
 * Destroy GB28181 RTP server
 * @param ctx Server object
 
 * [AUTO-TRANSLATED:828e02f0]
 */
API_EXPORT void API_CALL mk_rtp_server_release(mk_rtp_server ctx);

/**
 * 获取本地监听的端口号
 * @param ctx 服务器对象
 * @return 端口号
 * Get the local listening port number
 * @param ctx Server object
 * @return Port number
 
 * [AUTO-TRANSLATED:90fe5d22]
 */
API_EXPORT uint16_t API_CALL mk_rtp_server_port(mk_rtp_server ctx);

/**
 * GB28181 RTP 服务器接收流超时时触发
 * @param user_data 用户数据指针
 * Triggered when the GB28181 RTP server receives a stream timeout
 * @param user_data User data pointer
 
 * [AUTO-TRANSLATED:04d56f24]
 */
typedef void(API_CALL *on_mk_rtp_server_detach)(void *user_data);

/**
 * 监听B28181 RTP 服务器接收流超时事件
 * @param ctx 服务器对象
 * @param cb 回调函数
 * @param user_data 回调函数用户数据指针
 * Listen for B28181 RTP server receiving stream timeout events
 * @param ctx Server object
 * @param cb Callback function
 * @param user_data Callback function user data pointer
 
 
 * [AUTO-TRANSLATED:a88c239f]
 */
API_EXPORT void API_CALL mk_rtp_server_set_on_detach(mk_rtp_server ctx, on_mk_rtp_server_detach cb, void *user_data);
API_EXPORT void API_CALL mk_rtp_server_set_on_detach2(mk_rtp_server ctx, on_mk_rtp_server_detach cb, void *user_data, on_user_data_free user_data_free);

#ifdef __cplusplus
}
#endif