194 lines
5.9 KiB
C
194 lines
5.9 KiB
C
#ifndef _PLAYER_H
|
|
#define _PLAYER_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stdint.h>
|
|
|
|
#if _WIN32
|
|
#if BUILD_PLAYER
|
|
#define PLAYER_API __declspec(dllexport)
|
|
#else
|
|
#define PLAYER_API __declspec(dllimport)
|
|
#endif
|
|
#elif defined(__GNUC__)
|
|
#define PLAYER_API __attribute__((visibility("default")))
|
|
#else
|
|
#define PLAYER_API
|
|
#endif
|
|
|
|
typedef struct PlayerSession PlayerSession;
|
|
typedef struct PlayerSettings PlayerSettings;
|
|
|
|
#ifndef BUILD_PLAYER
|
|
#define AV_LOG_QUIET -8
|
|
#define AV_LOG_PANIC 0
|
|
#define AV_LOG_FATAL 8
|
|
#define AV_LOG_ERROR 16
|
|
#define AV_LOG_WARNING 24
|
|
#define AV_LOG_INFO 32
|
|
#define AV_LOG_VERBOSE 40
|
|
#define AV_LOG_DEBUG 48
|
|
#define AV_LOG_TRACE 56
|
|
#endif
|
|
|
|
#define PLAYER_ERR_OK 0
|
|
#define PLAYER_ERR_NULLPTR 1
|
|
#define PLAYER_ERR_SDL 2
|
|
#define PLAYER_ERR_OOM 3
|
|
#define PLAYER_ERR_NO_STREAM_OR_DECODER 4
|
|
#define PLAYER_ERR_UNKNOWN_AUDIO_SAMPLE_FMT 5
|
|
#define PLAYER_ERR_FAILED_CREATE_MUTEX 6
|
|
#define PLAYER_ERR_WAIT_MUTEX_FAILED 7
|
|
#define PLAYER_ERR_FAILED_CREATE_THREAD 8
|
|
#define PLAYER_ERR_NO_DURATION 9
|
|
|
|
PLAYER_API const char* player_version_str();
|
|
PLAYER_API int32_t player_version();
|
|
/**
|
|
* @brief 设置播放器日志文件
|
|
*
|
|
* 如果之前设置过日志文件，会关闭之前的日志文件。
|
|
* @param filename 日志文件路径，如果为NULL则关闭之前的设置的日志文件
|
|
* @param append 是否追加到文件末尾
|
|
* @param max_level 最大日志级别，小于等于这个级别的日志会被记录
|
|
*/
|
|
PLAYER_API void set_player_log_file(const char* filename, unsigned char append, int max_level);
|
|
/**
|
|
* @brief 记录播放器日志
|
|
* @param level 日志级别
|
|
* @param fmt 日志格式
|
|
*/
|
|
PLAYER_API void player_log(int level, const char* fmt, ...);
|
|
PLAYER_API size_t player_ts_max_string_size();
|
|
/**
|
|
* @brief 将时间戳转换为字符串
|
|
* @param buf 用于接收字符串的缓冲区，至少需要 player_ts_max_string_size() 大小
|
|
* @param ts 时间戳（单位：微秒）
|
|
* @return 字符串指针
|
|
*/
|
|
PLAYER_API char* player_ts_make_string(char* buf, int64_t ts);
|
|
/**
|
|
* @brief 返回错误代码对应的错误消息
|
|
* @param err 错误代码
|
|
* @return 错误消息，需要调用free释放内存
|
|
*/
|
|
PLAYER_API char* player_get_err_msg(int err);
|
|
/**
|
|
* @brief 返回错误代码对应的错误消息
|
|
* @param err 错误代码（仅处理>=0的错误）
|
|
* @return 错误消息
|
|
*/
|
|
PLAYER_API const char* player_get_err_msg2(int err);
|
|
|
|
/**
|
|
* @brief 创建一个播放器会话
|
|
* @param url 要播放的文件路径
|
|
* @param session 用于接收会话指针的指针
|
|
* @return 错误代码
|
|
*/
|
|
PLAYER_API int player_create(const char* url, PlayerSession** session);
|
|
|
|
/**
|
|
* @brief 创建一个播放器会话
|
|
* @param url 要播放的文件路径
|
|
* @param session 用于接收会话指针的指针
|
|
* @param settings 播放器设置，如果为NULL会使用默认设置。注意，传入的settings需要在session销毁前保持有效，需要手动调用 player_settings_free 。
|
|
* @return 错误代码
|
|
*/
|
|
PLAYER_API int player_create2(const char* url, PlayerSession** session, PlayerSettings* settings);
|
|
/**
|
|
* @brief 等待播放器初始化完成
|
|
* @param session 播放器会话指针
|
|
* @return 错误代码
|
|
*/
|
|
PLAYER_API int wait_player_inited(PlayerSession* session);
|
|
/**
|
|
* @brief 开始播放
|
|
* @param session 播放器会话指针
|
|
* @return 错误代码
|
|
*/
|
|
PLAYER_API int player_play(PlayerSession* session);
|
|
/**
|
|
* @brief 暂停播放
|
|
* @param session 播放器会话指针
|
|
* @return 错误代码
|
|
*/
|
|
PLAYER_API int player_pause(PlayerSession* session);
|
|
/**
|
|
* @brief 判断播放器缓冲区是否已满
|
|
* @param session 播放器会话指针
|
|
* @return 是否已满
|
|
*/
|
|
PLAYER_API int player_buffer_is_full(PlayerSession* session);
|
|
/**
|
|
* @brief 等待播放器缓冲区满
|
|
* @param session 播放器会话指针
|
|
*/
|
|
PLAYER_API void player_wait_until_buffer_is_full(PlayerSession* session);
|
|
/**
|
|
* @brief 判断播放器是否正在播放
|
|
* @param session 播放器会话指针
|
|
* @return 是否正在播放
|
|
*/
|
|
PLAYER_API int player_is_playing(PlayerSession* session);
|
|
/**
|
|
* @brief 获取当前播放时间
|
|
* @param session 播放器会话指针
|
|
* @param pos 用于接收当前播放时间的指针（单位：微秒）
|
|
* @return 错误代码
|
|
*/
|
|
PLAYER_API int player_get_duration(PlayerSession* session, int64_t* duration);
|
|
PLAYER_API void player_free(PlayerSession** session);
|
|
|
|
/**
|
|
* @brief 初始化播放器设置，会自动设置为默认值
|
|
* @return 播放器设置指针
|
|
*/
|
|
PLAYER_API PlayerSettings* player_settings_init();
|
|
/**
|
|
* @brief 将播放器设置重置为默认值
|
|
* @param settings 播放器设置指针
|
|
*/
|
|
PLAYER_API void player_settings_default(PlayerSettings* settings);
|
|
/**
|
|
* @brief 设置是否自动调整窗口大小
|
|
* @param settings 播放器设置指针
|
|
* @param resize 是否自动调整窗口大小
|
|
*/
|
|
PLAYER_API void player_settings_set_resize(PlayerSettings* settings, unsigned char resize);
|
|
/**
|
|
* @brief 设置音频缓冲区大小
|
|
* @param settings 播放器设置指针
|
|
* @param size 音频缓冲区大小（单位 ms）
|
|
*/
|
|
PLAYER_API void player_settings_set_audio_buffer_size(PlayerSettings* settings, uint32_t size);
|
|
/**
|
|
* @brief 设置视频缓冲区大小
|
|
* @param settings 播放器设置指针
|
|
* @param size 视频缓冲区大小（单位 ms）
|
|
*/
|
|
PLAYER_API void player_settings_set_video_buffer_size(PlayerSettings* settings, uint32_t size);
|
|
/**
|
|
* @brief 设置窗口句柄
|
|
* @param settings 播放器设置指针
|
|
* @param hWnd 指向窗口句柄的指针
|
|
*/
|
|
PLAYER_API void player_settings_set_hWnd(PlayerSettings* settings, void** hWnd);
|
|
PLAYER_API void player_settings_free(PlayerSettings** settings);
|
|
|
|
/**
|
|
* @brief 直接播放一个文件，会创建一个新的窗口并自动播放，播放结束后自动销毁。
|
|
*
|
|
* 会阻塞当前线程。
|
|
* @param filename 要播放的文件路径
|
|
* @param hWnd 指向窗口句柄的指针（可选）
|
|
*/
|
|
PLAYER_API void play(const char* filename, void** hWnd);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif
|