xref: /OK3568_Linux_fs/external/rknpu2/examples/3rdparty/zlmediakit/include/mk_proxyplayer.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  * Copyright (c) 2016 The ZLMediaKit project authors. All Rights Reserved.
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * This file is part of ZLMediaKit(https://github.com/xia-chu/ZLMediaKit).
5*4882a593Smuzhiyun  *
6*4882a593Smuzhiyun  * Use of this source code is governed by MIT license that can be found in the
7*4882a593Smuzhiyun  * LICENSE file in the root of the source tree. All contributing project authors
8*4882a593Smuzhiyun  * may be found in the AUTHORS file in the root of the source tree.
9*4882a593Smuzhiyun  */
10*4882a593Smuzhiyun 
11*4882a593Smuzhiyun #ifndef MK_PROXY_PLAYER_H_
12*4882a593Smuzhiyun #define MK_PROXY_PLAYER_H_
13*4882a593Smuzhiyun 
14*4882a593Smuzhiyun #include "mk_common.h"
15*4882a593Smuzhiyun 
16*4882a593Smuzhiyun #ifdef __cplusplus
17*4882a593Smuzhiyun extern "C" {
18*4882a593Smuzhiyun #endif
19*4882a593Smuzhiyun 
20*4882a593Smuzhiyun typedef void *mk_proxy_player;
21*4882a593Smuzhiyun 
22*4882a593Smuzhiyun /**
23*4882a593Smuzhiyun  * 创建一个代理播放器
24*4882a593Smuzhiyun  * @param vhost 虚拟主机名,一般为__defaultVhost__
25*4882a593Smuzhiyun  * @param app 应用名
26*4882a593Smuzhiyun  * @param stream 流名
27*4882a593Smuzhiyun  * @param rtp_type rtsp播放方式:RTP_TCP = 0, RTP_UDP = 1, RTP_MULTICAST = 2
28*4882a593Smuzhiyun  * @param hls_enabled 是否生成hls
29*4882a593Smuzhiyun  * @param mp4_enabled 是否生成mp4
30*4882a593Smuzhiyun  * @return 对象指针
31*4882a593Smuzhiyun  */
32*4882a593Smuzhiyun API_EXPORT mk_proxy_player API_CALL mk_proxy_player_create(const char *vhost, const char *app, const char *stream, int hls_enabled, int mp4_enabled);
33*4882a593Smuzhiyun 
34*4882a593Smuzhiyun /**
35*4882a593Smuzhiyun  * 销毁代理播放器
36*4882a593Smuzhiyun  * @param ctx 对象指针
37*4882a593Smuzhiyun  */
38*4882a593Smuzhiyun API_EXPORT void API_CALL mk_proxy_player_release(mk_proxy_player ctx);
39*4882a593Smuzhiyun 
40*4882a593Smuzhiyun /**
41*4882a593Smuzhiyun  * 设置代理播放器配置选项
42*4882a593Smuzhiyun  * @param ctx 代理播放器指针
43*4882a593Smuzhiyun  * @param key 配置项键,支持 net_adapter/rtp_type/rtsp_user/rtsp_pwd/protocol_timeout_ms/media_timeout_ms/beat_interval_ms
44*4882a593Smuzhiyun  * @param val 配置项值,如果是整形,需要转换成统一转换成string
45*4882a593Smuzhiyun  */
46*4882a593Smuzhiyun API_EXPORT void API_CALL mk_proxy_player_set_option(mk_proxy_player ctx, const char *key, const char *val);
47*4882a593Smuzhiyun 
48*4882a593Smuzhiyun /**
49*4882a593Smuzhiyun  * 开始播放
50*4882a593Smuzhiyun  * @param ctx 对象指针
51*4882a593Smuzhiyun  * @param url 播放url,支持rtsp/rtmp
52*4882a593Smuzhiyun  */
53*4882a593Smuzhiyun API_EXPORT void API_CALL mk_proxy_player_play(mk_proxy_player ctx, const char *url);
54*4882a593Smuzhiyun 
55*4882a593Smuzhiyun /**
56*4882a593Smuzhiyun  * MediaSource.close()回调事件
57*4882a593Smuzhiyun  * 在选择关闭一个关联的MediaSource时,将会最终触发到该回调
58*4882a593Smuzhiyun  * 你应该通过该事件调用mk_proxy_player_release函数并且释放其他资源
59*4882a593Smuzhiyun  * 如果你不调用mk_proxy_player_release函数,那么MediaSource.close()操作将无效
60*4882a593Smuzhiyun  * @param user_data 用户数据指针,通过mk_proxy_player_set_on_close函数设置
61*4882a593Smuzhiyun  */
62*4882a593Smuzhiyun typedef void(API_CALL *on_mk_proxy_player_close)(void *user_data, int err, const char *what, int sys_err);
63*4882a593Smuzhiyun 
64*4882a593Smuzhiyun /**
65*4882a593Smuzhiyun  * 监听MediaSource.close()事件
66*4882a593Smuzhiyun  * 在选择关闭一个关联的MediaSource时,将会最终触发到该回调
67*4882a593Smuzhiyun  * 你应该通过该事件调用mk_proxy_player_release函数并且释放其他资源
68*4882a593Smuzhiyun  * @param ctx 对象指针
69*4882a593Smuzhiyun  * @param cb 回调指针
70*4882a593Smuzhiyun  * @param user_data 用户数据指针
71*4882a593Smuzhiyun  */
72*4882a593Smuzhiyun API_EXPORT void API_CALL mk_proxy_player_set_on_close(mk_proxy_player ctx, on_mk_proxy_player_close cb, void *user_data);
73*4882a593Smuzhiyun 
74*4882a593Smuzhiyun /**
75*4882a593Smuzhiyun  * 获取总的观看人数
76*4882a593Smuzhiyun  * @param ctx 对象指针
77*4882a593Smuzhiyun  * @return 观看人数
78*4882a593Smuzhiyun  */
79*4882a593Smuzhiyun API_EXPORT int API_CALL mk_proxy_player_total_reader_count(mk_proxy_player ctx);
80*4882a593Smuzhiyun 
81*4882a593Smuzhiyun #ifdef __cplusplus
82*4882a593Smuzhiyun }
83*4882a593Smuzhiyun #endif
84*4882a593Smuzhiyun 
85*4882a593Smuzhiyun #endif /* MK_PROXY_PLAYER_H_ */
86