#ifndef _DHPLAY_H #define _DHPLAY_H #if (defined(WIN32) || defined(WIN64)) #ifdef dhplay_EXPORTS #define PLAYSDK_API __declspec(dllexport) #else #define PLAYSDK_API __declspec(dllimport) #endif #define CALLMETHOD __stdcall #define CALLBACK __stdcall #else #define CALLMETHOD #define CALLBACK #define PLAYSDK_API //extern "C" #endif #if defined(WIN32) || defined(WIN64) #include #else #ifdef __OBJC__ #include "objc/objc.h" #else #define BOOL int #endif #define BYTE unsigned char #define PBYTE BYTE* #define LPBYTE BYTE* #ifndef LONG #define LONG int #endif #ifndef DWORD #define DWORD unsigned int #endif #define WORD unsigned short #define COLORREF DWORD #define HDC void* #define HWND void* #define LPSTR char* #define UINT unsigned int #define TRUE 1 #define FALSE 0 #define ULONGLONG unsigned long long #define LONGLONG long long typedef struct _SYSTEMTIME { WORD wYear; WORD wMonth; WORD wDayOfWeek; WORD wDay; WORD wHour; WORD wMinute; WORD wSecond; WORD wMilliseconds; } SYSTEMTIME, *PSYSTEMTIME, *LPSYSTEMTIME; #endif #ifdef __cplusplus extern "C" { #endif /***********************************************************************************************/ /* 常量定义 */ /***********************************************************************************************/ /* 通道号 */ #define FUNC_MAX_PORT 511 // 最大通道号，通道号范围[0,512) /* 音频幅值 */ #define MIN_WAVE_COEF -100 // PLAY_AdjustWaveAudio使用 #define MAX_WAVE_COEF 100 // PLAY_AdjustWaveAudio使用 /* 音频采集长度 */ #define MIN_AUDIO_RECORD_LEN 320 // 最小音频采集长度 #define MAX_AUDIO_RECORD_LEN 4096 // 最大音频采集长度 /* 显示相关 */ #define MAX_DISPLAY_WND 64 // 设置的区域序号的最大值 /* 播放缓存相关 */ #define BUF_VIDEO_SRC 1 // 视频源缓冲 #define BUF_AUDIO_SRC 2 // 音频源缓冲 #define BUF_VIDEO_RENDER 3 // 解码后视频数据缓冲 #define BUF_AUDIO_RENDER 4 // 解码后音频数据缓冲 /* 文件跳转方式 */ #define BY_FRAMENUM 1 // 按帧号方式(PLAY_GetKeyFramePos使用) #define BY_FRAMETIME 2 // 按时间方式(PLAY_GetKeyFramePos使用) /* 数据流相关 */ #define SOURCE_BUF_MAX 1024*100000 // 数据流缓冲区最大长度 #define SOURCE_BUF_MIN 1024*1024 // 数据流缓冲区最小长度 #define STREAME_REALTIME 0 // 实时流模式 #define STREAME_FILE 1 // 文件流模式 /* 音频位宽 */ #define T_AUDIO16 101 // 16位音频数据类型 #define T_AUDIO8 100 // 8位音频数据类型 /* 解码后的视频格式 */ #define T_UYVY 1 // UYVY类型的YUV数据，现在不支持 #define T_IYUV 3 // IYUV(I420)类型YUV数据 #define T_NV12 5 // NV12类型yuv数据，现在只支持bmp32抓图 #define T_RGB32 7 // RGB32类型，现在不支持 /* avi转码 */ #define AVI_MEDIACHANGE_FRAMERATE 1 // 帧率改变 #define AVI_MEDIACHANGE_RESOLUTION 2 // 分辨率改变 /* 水印相关 */ #define WATERMARK_DATA_TEXT 0 // 文字 #define WATERMARK_DATA_JPEG_BMP 1 // JPEG或者BMP图片 #define WATERMARK_DATA_FRAMEDATA 3 // 帧数据 /* 错误码 */ #define DH_PLAY_NOERROR 0 //无错误 #define DH_PLAY_COMMON_ERROR 1 //普通错误 #define DH_PLAY_PARA_INVALID 2 //参数无效 #define DH_PLAY_ORDER_ERROR 3 //调用顺序不对 #define DH_PLAY_PORT_OPEN 4 //通道已经被打开 #define DH_PLAY_PORT_CLOSE 5 //通道已经被关闭 #define DH_PLAY_PORT_INVALID 6 //通道号无效 #define DH_PLAY_PORT_EXIST 7 //通道已经存在 #define DH_PLAY_OPEN_FILE_ERROR 8 //打开文件失败 #define DH_PLAY_INTERFACE_NOT_SUPPORT 9 //接口不支持 #define DH_PLAY_HWND_INVALID 10 //窗口句柄无效 #define DH_PLAY_PLAY_ERROR 11 //播放失败 #define DH_PLAY_SPEED_INVALID 12 //速度无效 #define DH_PLAY_NOT_FILE 13 //非文件模式 #define DH_PLAY_NOT_STREAM 14 //非流模式 #define DH_PLAY_NO_FRAME 15 //当前没有帧可用 #define DH_PLAY_INDEX_NOT_COMPLETE 16 //索引没有建立完成 #define DH_PLAY_INDEX_COMPLETE 17 //已建立文件索引 #define DH_PLAY_GET_FILE_SIZE_ERROR 18 //获取文件大小失败 #define DH_PLAY_CREATE_THREAD_FAIL 19 //创建线程失败 #define DH_PLAY_CREATE_EVENT_FAIL 20 //创建句柄失败 #define DH_PLAY_SOUND_SHARE_MODE 21 //处于共享声音模式 #define DH_PLAY_INCLUDE_SOUND_SHARE_PORT 22 //该端口已包含 #define DH_PLAY_NOT_INCLUDE_SOUND_SHARE_PORT 23 //该端口未包含 #define DH_PLAY_CREATE_DIR_ERROR 24 //创建路径失败 #define DH_PLAY_CREATE_FILE_ERROR 25 //创建文件失败 #define DH_PLAY_CONVERT_YUV_ERROR 26 //转到yuv失败 #define DH_PLAY_CONVERT_JPG_ERROR 27 //转到jpg失败 #define DH_PLAY_CONVERT_BMP_ERROR 28 //转到bmp失败 #define DH_PLAY_CONVERT_TIFF_ERROR 29 //转到tiff失败 #define DH_PLAY_HW_CATCH_ERROR 30 //硬解码抓拍失败 #define DH_PLAY_CREATE_VIDEO_RENDER_ERROR 31 //创建视频渲染失败 #define DH_PLAY_NOT_SUPPORT_REF_VALUE 32 //不支持外部索引设置 #define DH_PLAY_FORMAT_NOT_SUPPORT 33 //格式不支持 #define DH_PLAY_CREATE_RECORD_ERROR 34 //创建录像失败 #define DH_PLAY_OPEN_RECORD_ERROR 35 //打开录像失败 #define DH_PLAY_FRAMERATE_ERROR 36 //帧率错误 #define DH_PLAY_CREATE_AUDIO_RECORD_ERROR 37 //创建音频录像失败 #define DH_PLAY_OPEN_AUDIO_RECORD_ERROR 38 //打开音频录像失败 #define DH_PLAY_AES_ALLOC_ERROR 39 //调用aes_alloc失败 #define DH_PLAY_BUF_OVER 40 //缓冲区已满 #define DH_PLAY_ALLOC_MEMORY_ERROR 41 //分配内存失败 /***********************************************************************************************/ /* 枚举定义 */ /***********************************************************************************************/ /* 渲染模式 */ typedef enum { RENDER_NOTSET = 0, // 未设置 RENDER_GDI, // GDI渲染 RENDER_X11 = RENDER_GDI, // 非windows平台X11渲染 RENDER_DDRAW, // ddraw渲染 RENDER_OPENGL = RENDER_DDRAW, // 非windows平台opengl渲染 RENDER_D3D, // D3D渲染,默认等同于D3D9渲染 RENDER_D3D9 = RENDER_D3D, // D3D9渲染 RENDER_WGL, // windows平台opengl渲染 RENDER_D3D11 // D3D11渲染 }RenderType; /* 解码模式 */ typedef enum { DECODE_NOTSET = 0, // 未设置 DECODE_SW, // 软解 DECODE_HW, // 硬解码拷贝模式(如使用windows平台，使用d3d9接口) DECODE_HW_FAST, // 硬解码直接显示模式(如使用windows平台，使用d3d9接口) DECODE_MSDK, // 硬解码，调用intel media sdk，已废弃 DECODE_HW_FAST_D3D11, // 硬解码直接显示模式,使用d3d11接口,仅限windows平台 }DecodeType; /* 图片格式 */ typedef enum __tPicFormats { PicFormat_BMP = 0, // BMP32类型 PicFormat_JPEG, // JPEG类型 PicFormat_JPEG_70, // 70%质量的JPEG类型 PicFormat_JPEG_50, // 50%质量的JPEG类型 PicFormat_JPEG_30, // 30%质量的JPEG类型 PicFormat_JPEG_10, // 10%质量的JPEG类型 PicFormat_BMP24, // BMP24类型 PicFormat_TIFF // TIFF类型 } tPicFormats; /* 获取媒体信息格式 */ typedef enum _CMD_TYPE { PLAY_CMD_GetTime = 1, // 编码中时间信息，为公历年月日 PLAY_CMD_GetFileRate = 2, // 帧率信息 PLAY_CMD_GetMediaInfo = 3, // 媒体信息 PLAY_CMD_GetRenderNum = 4, // 当前要渲染的帧号 PLAY_CMD_GetRenderTime = 5, // 当前要渲染的时间，绝对时间 PLAY_CMD_GetSrcTime = 6, // 编码中时间信息，为1970年7月1日后后持续的秒数 PLAY_CMD_GetCurRenderNum = 7, // 当前帧号，PLAY_CMD_GetRenderNum是上一帧的帧号 PLAY_CMD_GetRenderTimeStamp = 8 // 当前要渲染的时间戳，相对时间戳 } CMD_TYPE_E; /* 音视频同步策略 */ typedef enum { AV_SYNC_VIDEO_MASTER, // 以视频为基准（非音视频同步方式） AV_SYNC_AUDIO_TIME_STAMP // 以音频时间戳为基准 }AV_SYNC_TYPE; /***********************************************************************************************/ /* 结构体定义 */ /***********************************************************************************************/ /* 局部显示区域 */ typedef struct _tagRECT { LONG left; LONG top; LONG right; LONG bottom; }DISPLAYRECT; /* 时间结构 */ #ifndef _DHTIME_ #define _DHTIME_ typedef struct _DHTIME { DWORD second :6; // 秒 0-59 DWORD minute :6; // 分 0-59 DWORD hour :5; // 时 0-23 DWORD day :5; // 日 1-31 DWORD month :4; // 月 1-12 DWORD year :6; // 年 2000-2063 } DHTIME,*pDHTIME; #endif /* 文件信息结构，本地使用 */ #define UUID_MAX_LEN 96 //分区唯一标识长度 #define MAX_DEV_NAME_LEN 32 //分区名称长度 typedef struct _FILE_INFO { UINT channel; //通道号 BYTE type; //文件类型,按照数值计算 BYTE lock_flag; //锁定类型(类型定义见dhfs_file_state) BYTE video_audio; //视频或音频 BYTE image; //bit0~3图像质量(bit4~6保留, bit7 表示夏令时) DHTIME start_time; //开始时间 DHTIME end_time; //结束时间 UINT file_length; //文件长度，单位为KB UINT first_clus_no; //文件首簇号 UINT ud_no; //用户数据号 char part[MAX_DEV_NAME_LEN]; //文件所在的分区名称, 如:"dev/sda_0" char uuid[UUID_MAX_LEN]; //文件所在分区uuid,每个分区的唯一标识,重新卸载|挂载后会更新 UINT rev[9]; }FILE_INFO,*pFILE_INFO; /* 帧位置信息 */ typedef struct { LONGLONG nFilePos; // 指定帧在文件中的偏移位置 LONG nFrameLen; // 帧长度 LONG nFrameNum; // 帧序号 LONG nFrameTime; // 帧时间 LONG nErrorFrameNum; // 保留，暂无使用 SYSTEMTIME* pErrorTime; // 保留，暂无使用 LONG nErrorLostFrameNum; // 保留，暂无使用 LONG nErrorFrameSize; // 保留，暂无使用 }FRAME_POS,*PFRAME_POS; /* 帧信息 */ typedef struct { LONG nWidth; // 画面宽，单位像素。如果是音频数据则为0 LONG nHeight; // 画面高，如果是音频数据则为0 LONG nStamp; // 时标信息，单位毫秒 LONG nType; // 视频帧类型，T_AUDIO16，T_RGB32，T_IYUV LONG nFrameRate; // 视频表示帧率，音频表示采样率 }FRAME_INFO; /* 帧信息扩展字段 */ typedef struct { #define FRAME_TYPE_VIDEO 0 // 视频帧 #define FRAME_TYPE_AUDIO 1 // 音频帧 int nFrameType; // 视频帧类型，见上面定义 int nFrameSeq; // 帧序号 int nStamp; // 时标信息，单位毫秒 int nWidth; // 画面宽，单位像素。如果是音频数据则为0 int nHeight; // 画面高，如果是音频数据则为0 int nFrameRate; // 编码时产生的图像帧率 int nChannels; // 音频通道数 int nBitPerSample; // 音频采样位数 int nSamplesPerSec; // 音频采样频率 int nRemainData; // 缓冲剩余数据量 SYSTEMTIME nDataTime; // 时间 int nFrameSubType; // 视频帧子类型 int nReserved[58]; // 保留字段 }FRAME_INFO_EX; /* 解码后的帧信息 */ typedef struct { int nFrameType; // 帧类型，定义见FRAME_INFO_EX里nFrameType字段 void* pAudioData; // 音频数据，如果是音频帧 int nAudioDataLen; // 音频数据长度 void* pVideoData[3]; // 分别表示视频的YUV三个分量 int nStride[3]; // 分别表示YUV三个分量的跨距 int nWidth[3]; // 分别表示YUV三个分量的宽度 int nHeight[3]; // 分别表示YUV三个分量的高度 SYSTEMTIME nDataTime; // 帧时间 int nReserved[60]; // 保留字段 }FRAME_DECODE_INFO; /* 媒体信息 */ typedef struct { int lWidth; // 画面宽，单位像素 int lHeight; // 画面高 int lFrameRate; // 帧率 int lChannel; // 音频通道数 int lBitPerSample; // 音频采样位数 int lSamplesPerSec; // 音频采样频率 }MEDIA_INFO; /***********************************************************************************************/ /* 接口 */ /***********************************************************************************************/ /************************************************************************/ //> 获取版本号 /************************************************************************/ /** * 获取播放库SDK主版本号，次版本号和SVN版本号。 * * @return 最高1位表示当前的主版本号；第2~3位表示次版本号；其余的表示SVN版本号。 * 如：返回值34033722表示：主版本号是3，次版本号是40，SVN版本号是33722。 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetSdkVersion(); /************************************************************************/ //> 错误码 /************************************************************************/ /** * 获取错误码。 * * @return 错误码 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetLastErrorEx(); /************************************************************************/ //> 日志开关 /************************************************************************/ /** * 日志调试开关，默认为Warn等级，打印较少。如果需要开启详细日志打印，建议为Debug等级。 * Windows平台生成为当前库目录下的playsdk.log文件，其他非windows为控制台打印。 * */ typedef enum { LOG_LevelUnknown= 0, // 未知等级 LOG_LevelFatal, // fatal等级，当设置为此等级时，有一种打印输出（fatal）都有输出 LOG_LevelError, // error等级，当设置为此等级时，有两种打印输出（fatal，error）都有输出 LOG_LevelWarn, // warn等级，当设置为此等级时，有三种打印输出（fatal，error，warn）都有输出 LOG_LevelInfo, // info等级，当设置为此等级时，有四种打印输出（fatal，error，warn，info）都有输出 LOG_LevelTrace, // Trace等级，当设置为此等级时，有五种打印输出（fatal，error，warn，info，trace）都有输出 LOG_LevelDebug // Debug等级，当设置为此等级时，以上六种打印（fatal，error，warn，info，trace，debug）都有输出 }LOG_LEVEL; PLAYSDK_API void CALLMETHOD PLAY_SetPrintLogLevel(LOG_LEVEL logLevel); /************************************************************************/ //> 播放端口号 /************************************************************************/ /** * 获取空闲通道号，范围在101~511。 * * @param[out] plPort 获取到的空闲通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetFreePort(LONG *plPort); /** * 释放通道号。 * * @param[in] lPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_ReleasePort(LONG lPort); /************************************************************************/ //> 文件操作 /************************************************************************/ /** * 打开播放文件。 * * @param[in] nPort 通道号 * @param[in] sFileName 文件名 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_OpenFile(LONG nPort,LPSTR sFileName); /** * 关闭文件。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_CloseFile(LONG nPort); /** * 文件结束回调函数。 * * @param[in] nPort 通道号 * @param[in] pUserData 用户数据 */ typedef void (CALLBACK *fFileEndCBFun)(DWORD nPort, void* pUserData); /** * 文件结束回调。 * * @param[in] nPort 通道号 * @param[out] pFileEndCBFun 文件结束函数回调指针 * @param[in] pUserData 用户数据 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetFileEndCallBack(LONG nPort, fFileEndCBFun pFileEndCBFun, void* pUserData); /************************************************************************/ //> 流操作 /************************************************************************/ /** * 设置流播放模式。 * * @param[in] nPort 通道号 * @param[in] nMode 播放模式，0实时流，1文件流 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetStreamOpenMode(LONG nPort,DWORD nMode); /** * 获取播放模式。 * * @param[in] nPort 通道号 * @return LONG，STREAM_MODE_REALSTREAM或STREAM_MODE_FILESTREAM */ PLAYSDK_API LONG CALLMETHOD PLAY_GetStreamOpenMode(LONG nPort); /** * 打开流。 * * @param[in] nPort 通道号 * @param[in] pFileHeadBuf 文件头数据 * @param[in] nSize 文件头长度 * @param[in] nBufPoolSize 设置播放器中存放数据流的缓冲区大小。范围是SOURCE_BUF_MIN~SOURCE_BUF_MAX * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_OpenStream(LONG nPort,PBYTE pFileHeadBuf,DWORD nSize,DWORD nBufPoolSize); /** * 关闭流。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_CloseStream(LONG nPort); /** * 输入数据流，PLAY_Play之后使用。 * * @param[in] nPort 通道号 * @param[in] pBuf 流数据缓冲区地址 * @param[in] nSize 流数据长度 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_InputData(LONG nPort,PBYTE pBuf,DWORD nSize); /************************************************************************/ //> 声音相关 /************************************************************************/ /** * 以独占方式打开声音。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_PlaySound(LONG nPort); /** * 关闭声音（独占方式）。 * * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_StopSound(); /** * 以共享方式打开声音。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_PlaySoundShare(LONG nPort); /** * 关闭声音（共享方式）。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_StopSoundShare(LONG nPort); /** * 设置音量。 * * @param[in] nPort 通道号 * @param[in] nVolume 音量值，范围0-0xFFFF * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetVolume(LONG nPort,WORD nVolume); /** * 获取音量。 * * @param[in] nPort 通道号 * @return WORD，音量值 * @note 这里的音量是指声卡输出的主音量，会影响到其他的声音应用。 */ PLAYSDK_API WORD CALLMETHOD PLAY_GetVolume(LONG nPort); /** * 音频采集数据回调函数。 * * @param[in] pDataBuffer 数据地址 * @param[in] DataLength 数据长度 * @param[in] pUserData 用户数据 */ typedef void (CALLBACK *pCallFunction)(LPBYTE pDataBuffer, DWORD DataLength, void* pUserData); /** * 打开音频采集功能。 * * @param[in] pProc音频采集数据回调指针 * @param[in] nBitsPerSample 音频采样位数 * @param[in] nSamplesPerSec 音频采样率 * @param[in] nLength 数据缓冲的长度，范围320-4096 * @param[in] encodetype 对采集数据进行编码设置，0：pcm，1：g711a，2：g711u。pcm回调裸数据，g711a和g711u回调带新大华头的数据 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_OpenAudioRecord(pCallFunction pProc, LONG nBitsPerSample, LONG nSamplesPerSec, LONG nLength, LONG encodetype, void* pUserData); /** * 关闭音频采集功能。 * * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_CloseAudioRecord(); /** * 音频采集变声功能。 * * @param[in] bStart 开启关闭音频采集变声，1-开启，0-关闭， 仅支持Andriod/IOS * @param[in] nPitch 声音变化的程度，范围：-50-50，0时声音不变 * @param[in] bQuick 是快速实现，0-不使能，音质提高，cpu消耗增，1-使能，音质下降，cpu消耗减少 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SpeechChange(BOOL bStart, int nPitch, BOOL bQuick); /** * 设置音频采集缩放比例。 * * @param[in] fRatio 缩放比例。大于0小于1为音频缩小；1为原始音频；大于1为音频放大 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetAudioRecScaling(float fRatio); /** * 获取音频采集缩放比例。 * * @param[out] pfRatio 缩放比例。大于0小于1为音频缩小；1为原始音频；大于1为音频放大 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetAudioRecScaling(float* pfRatio); /** * 设置音频播放缩放比例。 * * @param[in] nPort 通道号 * @param[in] fRatio 缩放比例。大于0小于1为音频缩小；1为原始音频；大于1为音频放大。 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetAudioRenderScaling(LONG nPort, float fRatio); /** * 获取音频播放缩放比例。 * * @param[in] nPort 通道号 * @param[out] pfRatio 缩放比例。大于0小于1为音频缩小；1为原始音频；大于1为音频放大 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetAudioRenderScaling(LONG nPort, float* pfRatio); /** * 调整WAVE波形，可以改变声音的大小。它和PLAY_SetVolume的不同在于，它是调整声音数据，只对该路其作用，而PLAY_SetVolume是 * 调整声卡音量， 对整个系统起作用。 * * @param[in] nPort 通道号 * @param[in] nCoefficient 调整参数，0是不调整，其他取值范围从MIN_WAVE_COEF到MAX_WAVE_COEF。若设定为MIN_WAVE_COEF表 * 示音量最低，若设定为MAX_WAVE_COEF表示音量最大 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_AdjustWaveAudio(LONG nPort,LONG nCoefficient); /************************************************************************/ //> 播放控制 /************************************************************************/ /** * 开启播放。播放开始，播放视频画面大小将根据hWnd窗口调整，要全屏显示，只要把hWnd窗口放大到全屏。开始解码线程，若送入的显示窗 * 口句柄为NULL，则不显示，但是不影响解码。 * * @param[in] nPort 通道号 * @param[in] hWnd 播放视频的窗口句柄 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_Play(LONG nPort, HWND hWnd); /** * 关闭播放。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_Stop(LONG nPort); /** * 暂停/恢复播放。 * * @param[in] nPort 通道号 * @param[in] nPause 1：暂停；0：恢复 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_Pause(LONG nPort,DWORD nPause); /** * 慢速播放。每次调用将使当前播放速度慢一倍；要恢复正常播放调用PLAY_Play()，从当前位置开始正常播放。 * 播放速度范围为[1/64,64]。 * * @param[in] nPort 通道号 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_Slow(LONG nPort); /** * 快速播放。每次调用将使当前播放速度加快一倍，要恢复正常播放调用PLAY_Play()，从当前位置开始正常播 放；高清码流在高倍速播放时，由于受到解码和显示的限制，可能达不到所设置的速度。 * 播放速度范围为[1/64, 64]。 * * @param[in] nPort 通道号 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_Fast(LONG nPort); /** * 单帧播放。要恢复正常播放调用PLAY_ Play。 * * @param[in] nPort 通道号 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_OneByOne(LONG nPort); /** * 单帧倒放。要恢复正常播放调用PLAY_ Play。只支持文件播放，且必须在文件索引生成之后才能调用。 * * @param[in] nPort 通道号 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_OneByOneBack(LONG nPort); /** * 设置视频参数。 * * @param[in] nPort 通道号 * @param[in] nRegionNum 显示区域。如果只有一个显示区域(通常情况)设为0 * @param[in] nBrightness 亮度。默认64；范围0-128 * @param[in] nContrast 对比度。默认64；范围0-128 * @param[in] nSaturation 饱和度。默认64；范围0-128 * @param[in] nHue 色调。默认64；范围0-128 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetColor(LONG nPort, DWORD nRegionNum, int nBrightness, int nContrast, int nSaturation, int nHue); /** * 获取视频参数。 * * @param[in] nPort 通道号 * @param[in] nRegionNum 显示区域 * @param[out] pBrightness 亮度 * @param[out] pContrast 对比度 * @param[out] pSaturation 饱和度 * @param[out] pHue 色调 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetColor(LONG nPort, DWORD nRegionNum, int *pBrightness, int *pContrast, int *pSaturation, int *pHue); /** * 设置音视频播放策略。 * * @param[in] nPort 通道号 * @param[in] nAVSyncType 码流播放基准，见AV_SYNC_TYPE * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetAVSyncType(LONG nPort,AV_SYNC_TYPE nAVSyncType); /** * 改变视频播放速度。在非1倍速下音频会被丢弃。 * * @param[in] nPort 通道号 * @param[in] fCoff 播放速度，范围是1/64-64。当播放速度较快时可能需要抽帧播放 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetPlaySpeed(LONG nPort, float fCoff); /** * 设置播放方向。 * * @param[in] nPort 通道号 * @param[in] emDirection 播放方向。0：正放；1：倒放 * @return 成功返回TURE；失败返回FALSE。 * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetPlayDirection(LONG nPort, DWORD emDirection); /** * 设置延迟播放时间。[nDelay,nThreshold]，小于nDelay稍微慢放，大于nThreshold稍微快放，两者之间正常播放。 * * @param[in] nPort 通道号 * @param[in] nDelay(ms) 延迟时间。缓冲达到该时间正常播放，小于该时间稍微慢放 * @param[in] nThreshold(ms) 阈值时间。缓冲小于该时间正常播放，大于该时间稍微快放 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDelayTime(LONG nPort, int nDelay, int nThreshold); /** * 设置播放策略，只对实时流有效。 * * @param[in] nPort 通道号 * @param[in] nStartTime(ms) 开始播放时间 * @param[in] nSlowTime(ms) 阈值时间。缓冲小于该时间正常播放，大于该时间稍微快放 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetPlayMethod(LONG nPort, int nStartTime, int nSlowTime, int nFastTime, int nFailedTime); /* 实时流数据缓冲模式 */ typedef enum { CACHE_MODE_OFF = 0, // 关闭实时流自适应缓冲模式 ADAPTIVE_CACHE, // 自适应缓冲 REALTIME_FIRST, // 实时优先 FLUENCY_FIRST, // 流畅优先 } CACHE_MODE; /** * 设置播放缓冲模式，只对实时流有效。 * * @param[in] nPort 通道号 * @param[in] cacheMode 实时数据缓冲模式 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetCacheMode(LONG nPort, CACHE_MODE cacheMode); /** * 设置音频播放策略（只适用于对讲业务），需在PLAY_PlaySound之后调用 * * @param[in] nPort 通道号 * @param[in] nClearTime(ms) 缓冲清除阀值 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetAudioPlayMethod(LONG nPort, int nClearTime); /** * 设置图像翻转。范围0-3。 * * @param[in] nPort 通道号 * @param[in] nrotateType 翻转类型。0：不旋转；1：旋转90度；2：旋转180度；3：旋转270度 * @return 成功返回TURE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetRotateAngle(LONG nPort , int nrotateType); /************************************************************************/ //> 文件定位 /************************************************************************/ /** * 设置文件播放指针的相对位置(百分比)。 * * @param[in] nPort 通道号 * @param[in] fRelativePos 文件长度的百分比 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetPlayPos(LONG nPort,float fRelativePos); /** * 获取文件播放指针的相对位置(百分比)。 * * @param[in] nPort 通道号 * @return float，返回文件长度的相对位置，范围0-100% */ PLAYSDK_API float CALLMETHOD PLAY_GetPlayPos(LONG nPort); /** * 设置文件当前播放时间。 * * @param[in] nPort 通道号 * @param[in] nTime 设置文件播放位置到指定时间，单位毫秒 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetPlayedTimeEx(LONG nPort,DWORD nTime); /** * 获取文件当前播放时间。 * * @param[in] nPort 通道号 * @return DWORD，文件当前播放的时间，单位毫秒 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetPlayedTimeEx(LONG nPort); /** * 获取当前播放的帧序号，PLAY_GetPlayedFrames是总共解码的帧数。如果文件 * 播放位置不被改变，那么这两个函数的返回值应该非常接近，除非码流丢失 * 数据。 * * @param[in] nPort 通道号 * @return DWORD，当前播放的帧序号 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetCurrentFrameNum(LONG nPort); /** * 设置文件当前帧播放帧号，此函数必须在文件索引生成之后才能调用。 * * @param[in] nPort 通道号 * @param[in] nFrameNum 帧序号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetCurrentFrameNum(LONG nPort,DWORD nFrameNum); /** * 获取已播放的帧数。 * * @param[in] nPort 通道号 * @return DWORD，已经播放的视频帧数 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetPlayedFrames(LONG nPort); /** * 获取当前文件播放时间。 * * @param[in] nPort 通道号 * @return DWORD，文件当前播放的时间，单位秒 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetPlayedTime(LONG nPort); /** * 获取文件总时间。 * * @param[in] nPort 通道号 * @return DWORD，文件总的时间长度值，单位秒 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetFileTime(LONG nPort); /** * 获取文件总帧数。 * * @param[in] nPort 通道号 * @return DWORD，文件中的总帧数 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetFileTotalFrames(LONG nPort); /************************************************************************/ //> 文件索引 /************************************************************************/ /** * 建立索引回调函数。 * * @param[in] nPort 通道号 * @param[in] pUserData 用户自定义参数 */ typedef void(CALLBACK *fFileRefDoneCBFun)(DWORD nPort, void* pUserData); /** * 设置建立索引回调，在文件打开时生成文件索引。这个过程耗时比较长，大约 * 每秒处理40M左右的数据，因为从硬盘读数据比较慢，建立索引的过程是在 * 后台完成，需要使用索引的函数要等待这个过程结束，其他接口不受影响。 * * @param[in] nPort 通道号 * @param[out] pFileRefDoneCBFun 建立索引回调函数指针 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetFileRefCallBack(LONG nPort, fFileRefDoneCBFun pFileRefDoneCBFunc, void* pUserData); /** * 建立索引回调函数。 * * @param[in] nPort 通道号 * @param[in] bIndexCreated 索引创建标志，TRUE索引创建成功；FALSE失败 * @param[in] pUserData 用户自定义参数 */ typedef void (CALLBACK *fFileRefDoneCBFunEx)(DWORD nPort, BOOL bIndexCreated, void* pUserData); /** * 设置建立索引回调，在文件打开时生成文件索引。这个过程耗时比较长，大约 * 每秒处理40M左右的数据，因为从硬盘读数据比较慢，建立索引的过程是在 * 后台完成，需要使用索引的函数要等待这个过程结束，其他接口不受影响。 * * @param[in] nPort 通道号 * @param[out] pFileRefDoneCBFunEx 建立索引回调函数指针 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetFileRefCallBackEx(LONG nPort, fFileRefDoneCBFunEx pFileRefDoneCBFunEx, void* pUserData); /** * 查找指定位置之前的关键帧位置，图像解码必须从关键帧开始，如果用户保存 * 的文件不是从关键帧开始的，那么倒下一个关键帧之前的数据会被忽略。如 * 果用户要截取文件中的一段数据，则应该考虑从关键帧开始截取。结束位置 * 则关系不大，最多丢失3帧数据。在文件索引建立完全的前提下，与 * PLAY_GetNextKeyFramePos联合使用，可以用来实现剪辑录像文件，剪辑精度 * 与关键帧间隔有关。 * * @param[in] nPort 通道号 * @param[in] nValue 当前位置，可以是时间或帧号，类型由nType指定 * @param[in] nType 指定nValue的类型。如果nType是BY_FRAMENUM，则nValue表示帧号；nType是BY_FRAMETIME，则nValue表示时间，单位ms。 * @param[in] pFramePos 查找到的关键帧的文件位置信息结构指针，详见PFRAME_POS。 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetKeyFramePos(LONG nPort,DWORD nValue, DWORD nType, PFRAME_POS pFramePos); /** * 查找指定位置之后的关键帧位置。 * * @param[in] nPort 通道号 * @param[in] nValue 当前位置，可以是时间或帧号，类型由nType指定 * @param[in] nType 指定nValue的类型。如果nType是BY_FRAMENUM,则nValue表示帧号；nType是BY_FRAMETIME,则nValue表示时间,单位ms。 * @param[in] pFramePos 查找到的关键帧的文件位置信息结构指针，详见PFRAME_POS。 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetNextKeyFramePos(LONG nPort,DWORD nValue, DWORD nType, PFRAME_POS pFramePos); /** * 获取文件索引，以便下次打开同一个文件时直接使用这个信息。必须在索引建成后才能获得信息。 * * @param[in] nPort 通道号 * @param[in] pBuffer 索引信息 * @param[in/out] pSize 输入pBuffer的大小，输出索引信息大小。可以在第一次指定pSize=0，pBuffer=NULL， * 从pSize的返回值获得需要的缓冲区大小。然后分配足够的缓冲，再调用一次。 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetRefValue(LONG nPort,BYTE *pBuffer, DWORD *pSize); /** * 设置文件索引，索引信息及其长度必须准确。如果已经有了文件索引信息，可以 * 不再调用生成索引的回调函数PLAY_SetFileRefCallBackEx，直接输入索引信息。 * * @param[in] nPort 通道号 * @param[in] pBuffer 索引信息 * @param[in] pSize 索引信息的长度 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetRefValue(LONG nPort,BYTE *pBuffer, DWORD nSize); /************************************************************************/ //> 获取播放或解码信息 /************************************************************************/ /** * 设置解码回调流类型，在PLAY_Play之前调用。 * * @param[in] nPort 通道号 * @param[in] nStream 1 视频流；2 音频流；3 复合流 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDecCBStream(LONG nPort,DWORD nStream); /** * 解码回调函数。 * * @param[in] nPort 通道号 * @param[in] pFrameDecodeInfo 解码后的音视频数据 * @param[in] pFrameInfo 图像和声音信息，请参见FRAME_INFO结构体 * @param[in] pUser 用户自定义参数 */ typedef void (CALLBACK* fCBDecode)(LONG nPort, FRAME_DECODE_INFO* pFrameDecodeInfo, FRAME_INFO_EX* pFrameInfo, void* pUser); /** * 设置解码回调，替换播放器中的显示部分，由用户自己控制显示，该函数在 * PLAY_Play之前调用，在PLAY_Stop时自动失效，下次调用PLAY_Play之前 * 需要重新设置。解码部分不控制速度，只要用户从回调函数中返回，解码器 * 就会解码下一部分数据。适用于只解码不显示的情形。 * * @param[in] nPort 通道号 * @param[out] cbDec 解码回调函数指针，不能为NULL * @param[in] pUser 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDecodeCallBack(LONG nPort, fCBDecode cbDec, void* pUser); /** * 视频抓图回调函数。 * * @param[in] nPort 通道号 * @param[in] pBuf 返回图像数据 * @param[in] nSize 返回图像数据大小 * @param[in] nWidth 画面宽，单位像素 * @param[in] nHeight 画面高，单位像素 * @param[in] nStamp 时标信息，单位毫秒 * @param[in] nType 数据类型，T_RGB32，T_UYVY，详见宏定义说明 * @param[in] nReceaved 对应用户自定义参数 */ typedef void (CALLBACK* fDisplayCBFun)(LONG nPort,char * pBuf,LONG nSize,LONG nWidth,LONG nHeight,LONG nStamp,LONG nType, void* pReserved); /** * 设置视频抓图回调函数，如果要停止回调，可以把回调函数指针设为NULL，该函数可以在任何时候调用。 * * @param[in] nPort 通道号 * @param[out] DisplayCBFun 抓图回调函数，可以为NULL * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDisplayCallBack(LONG nPort, fDisplayCBFun DisplayCBFun, void* pUserData); /** * 音频解码后的WAVE数据回调函数。 * * @param[in] nPort 通道号 * @param[in] pAudioBuf wave格式音频数据 * @param[in] nSize 音频数据长度 * @param[in] nStamp 时标(ms) * @param[in] nType 音频类型T_AUDIO16， 采样率8000，单声道，每个采样点16位表示 * @param[in] pUserData 用户自定义数据 */ typedef void (CALLBACK * fAudioCBFun)(LONG nPort, char * pAudioBuf, LONG nSize, LONG nStamp, LONG nType, void* pUserData); /** * 音频解码后的WAVE数据回调。 * * @param[in] nPort 通道号 * @param[out] AudioCBFun 音频解码回调函数 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetAudioCallBack(LONG nPort, fAudioCBFun AudioCBFun, void* pUserData); /** * 解码回调。与PLAY_SetDecodeCallBack基本相同，不同的是解码回调的同时可以显示视频，建议不要在回调函数里面做长时间的逻辑处理，以免增加显示的延时。 * * @param[in] nPort 通道号 * @param[out] cbDec 解码回调函数指针，不能为NULL * @param[in] pUser 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ typedef fCBDecode fVisibleDecodeCallBackFunc; PLAYSDK_API BOOL CALLMETHOD PLAY_SetVisibleDecodeCallBack(LONG nPort, fVisibleDecodeCallBackFunc cbDec, void* pUser); /** * 解码回调函数。 * * @param[in] nPort 通道号 * @param[in] pBuf 解码后的音视频数据 * @param[in] nSize 解码后的音视频数据pBuf的长度 * @param[in] pFrameInfo 图像和声音信息，请参见FRAME_INFO结构体 * @param[in] pUserData 用户自定义参数 * @param[in] nReserved2 保留参数 */ typedef void (CALLBACK* fDecCBFun)(LONG nPort,char * pBuf,LONG nSize,FRAME_INFO * pFrameInfo, void* pUserData, LONG nReserved2); /** * 设置解码回调，替换播放器中的显示部分，由用户自己控制显示，该函数在 * PLAY_Play之前调用，在PLAY_Stop时自动失效，下次调用PLAY_Play之前 * 需要重新设置。解码部分不控制速度，只要用户从回调函数中返回，解码器 * 就会解码下一部分数据。适用于只解码不显示的情形。 * * @param[in] nPort 通道号 * @param[out] DecCBFun 解码回调函数指针，不能为NULL * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDecCallBack(LONG nPort, fDecCBFun DecCBFun); /** * 设置解码回调，替换播放器中的显示部分，由用户自己控制显示，该函数在 * PLAY_Play之前调用，在PLAY_Stop时自动失效，下次调用PLAY_Play之前 * 需要重新设置。解码部分不控制速度，只要用户从回调函数中返回，解码器 * 就会解码下一部分数据。适用于只解码不显示的情形。 * * @param[in] nPort 通道号 * @param[out] DecCBFun 解码回调函数指针,不能为NULL * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDecCallBackEx(LONG nPort, fDecCBFun DecCBFun, void* pUserData); /** * 解码回调函数。 * * @param[in] nPort 通道号 * @param[in] pBuf 解码后的音视频数据 * @param[in] nSize 解码后的音视频数据pBuf的长度 * @param[in] pFrameInfo 图像和声音信息,请参见FRAME_INFO结构体 * @param[in] pUserData 用户自定义参数 * @param[in] nReserved1 保留参数 */ typedef void (CALLBACK* fVisibleDecCBFun)(LONG nPort,char * pBuf,LONG nSize,FRAME_INFO * pFrameInfo, void* pUserData, LONG nReserved1); /** * 解码回调。与PLAY_SetDecCallBackEx基本相同，不同的是解码回调的同时可以 * 显示视频，建议不要在回调函数里面做长时间的逻辑处理，以免增加显示的延时。 * * @param[in] nPort 通道号 * @param[out] DecCBFun 解码回调函数指针,不能为NULL * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetVisibleDecCallBack(LONG nPort, fVisibleDecCBFun DecCBFun, void* pUserData); /** * 水印数据回调函数。 * * @param[in] buf 水印数据buffer指针 * @param[in] key 区分不同水印信息 * @param[in] len 缓冲的最大长度 * @param[in] reallen 缓冲的实际长度 * @param[in] len 缓冲的最大长度 * @param[in] reallen 缓冲的实际长度 * @param[in] type 1没有错误；2水印错误；3帧数据错误；4帧号错误；5帧头错误；6没有帧头 * @param[in] pUserData 用户自定义参数 * @return int 无意义 */ typedef int (CALLBACK* fGetWaterMarkInfoCallbackFunc)(char* buf, LONG key, LONG len, LONG reallen, LONG type, void* pUserData); /** * 设置水印数据回调。注意：水印校验回调设置后将不会进行解码显示。 * * @param[in] nPort 通道号 * @param[out] pFunc 水印回调函数指针 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetWaterMarkCallBack(LONG nPort, fGetWaterMarkInfoCallbackFunc pFunc, void* pUserData); /** * 水印数据回调函数。 * * @param[in] nPort 通道号 * @param[in] buf 水印数据缓冲 * @param[in] lTimeStamp 水印的时间戳 * @param[in] lInfoType 水印信息类型,有三种类型,WATERMARK_DATA_TEXT,WATERMARK_DATA_JPEG_BMP,WATERMARK_DATA_FRAMEDATA * @param[in] len 缓冲的最大长度 * @param[in] reallen 缓冲的实际长度 * @param[in] lCheckResult 1没有错误；2水印错误；3帧数据错误；4帧号错误；5帧头错误；6没有帧头 * @param[in] pUserData 用户自定义参数 * @return int 无意义 */ typedef int (CALLBACK* fGetWaterMarkInfoCallbackFuncEx)(LONG nPort, char* buf, LONG lTimeStamp, LONG lInfoType, LONG len, LONG reallen, LONG lCheckResult, void* pUserData); /** * 设置水印数据回调。注意：水印校验回调设置后将不会进行解码显示。 * * @param[in] nPort 通道号 * @param[out] pFunc 水印回调函数指针 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetWaterMarkCallBackEx(LONG nPort, fGetWaterMarkInfoCallbackFuncEx pFunc, void* pUserData); /** * 图像分辨率改变通知回调函数。 * * @param[in] nPort 通道号 * @param[in] pUserData 用户自定义参数 */ typedef void (CALLBACK *fEncChangeCBFun)(LONG nPort, void* pUserData); /** * 设置图像分辨率改变通知回调，打开文件前使用。 * * @param[in] nPort 通道号 * @param[out] EncChangeCBFun 分辨率改变通知回调 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetEncTypeChangeCallBack(LONG nPort, fEncChangeCBFun EncChangeCBFun, void* pUserData); /** * 图像分辨率改变通知回调函数。 * * @param[in] nPort 通道号 * @param[in] pUserData 用户自定义参数 * @param[in] nWidth 图像宽 * @param[in] nHeight 图像高 */ typedef void(CALLBACK *fEncChangeCBFunEx)(LONG nPort, void* pUserData,LONG nWidth, LONG nHeight); /** * 设置图像分辨率改变通知回调，打开文件前使用。 * * @param[in] nPort 通道号 * @param[out] EncChangeCBFun 分辨率改变通知回调 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetEncTypeChangeCallBackEx(LONG nPort, fEncChangeCBFunEx EncChangeCBFun, void* pUserData); /** * 查询信息。 * * @param[in] nPort 通道号 * @param[in] cmdType 指定状态查询指令，见CMD_TYPE_E * @param[in] buf 存放信息的缓冲 * @param[in] buflen 缓冲长度 * @param[out] returnlen 获取的信息的有效数据长度 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_QueryInfo(LONG nPort, int cmdType, char* buf, int buflen, int* returnlen); /** * 获取视频实时码率。 * * @param[in] nPort 通道号 * @param[out] pBitRate 输出参数，返回视频码率(单位为k) * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetRealFrameBitRate(LONG nPort, double* pBitRate); /** * 获取文件总帧数。 * * @param[in] nPort 通道号 * @return DWORD，获取当前帧率 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetCurrentFrameRate(LONG nPort); /** * 获取用于显示的图像大小（如果是鱼眼，则为矫正后的鱼眼图像），根据此大小来设置显示窗口的区域，可以不用显卡做缩放 * 工作，对于那些不支持硬件缩放的显卡来说非常有用。 * * @param[in] nPort 通道号 * @param[out] pWidth 图像宽 * @param[out] pHeight 图像高 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetPictureSize(LONG nPort,LONG *pWidth,LONG *pHeight); /** * 帧数据回调函数。 * * @param[in] nPort 通道号 * @param[in] pBuf 数据指针 * @param[in] nSize 数据长度 * @param[in] pMutexInfo 帧信息,指向DEMUX_INFO结构 * @param[in] pMutexInfoEx 帧数据或裸数据，指向DemuInfoEx结构 * @param[in] pUserData 用户自定义数据 */ /* Demux帧类型 */ typedef enum { FRAME_UNKNOWN = 0, // 帧类型不可知 FRAME_VIDEO, // 帧类型是视频帧 FRAME_AUDIO, // 帧类型是音频帧 FRAME_DATA // 帧类型是数据帧 }FRAME_TYPE; /* Demux帧子类型 */ typedef enum { FRAME_SUB_TYPE_DATA_INVALID = 0, // 数据无效 FRAME_SUB_TYPE_VIDEO_I_FRAME = 1, // I帧 FRAME_SUB_TYPE_VIDEO_P_FRAME, // P帧 FRAME_SUB_TYPE_VIDEO_B_FRAME, // B帧 FRAME_SUB_TYPE_VIDEO_SMART_I_FRAME = 19, // smart I帧 FRAME_SUB_TYPE_VIDEO_SMART_P_FRAME, // smart P帧 FRAME_SUB_TYPE_DATA_CIPHER_AUXILIARY = 26 // 密码辅助帧 }FRAME_SUB_TYPE; /* Demux视频编码格式 */ typedef enum { ENCODE_VIDEO_UNKNOWN = 0, // 视频编码格式不可知 ENCODE_VIDEO_MPEG4, // 视频编码格式是MPEG4 ENCODE_VIDEO_HI_H264, // 视频编码格式是海思H264 ENCODE_VIDEO_JPEG, // 视频编码格式是标准JPEG ENCODE_VIDEO_DH_H264, // 视频编码格式是大华码流H264 ENCODE_VIDEO_JPEG2000 = 6, // 视频编码格式是标准JPEG2000 ENCODE_VIDEO_AVS = 7, // 视频编码格式是标准AVS ENCODE_VIDEO_STD_H264 = 8, // 视频编码格式是标准H264 ENCODE_VIDEO_MPEG2 = 9, // 视频编码格式是MPEG2 ENCODE_VIDEO_VNC = 10, // 视频编码格式是VNC ENCODE_VIDEO_SVAC = 11, // 视频编码格式是SVAC ENCODE_VIDEO_DH_H265 = 12 // 视频编码格式是H265 }ENCODE_VIDEO_TYPE; /* Demux音频编码格式 */ typedef enum { ENCODE_AUDIO_UNKNOWN = 0, ENCODE_AUDIO_PCM = 7, // 音频编码格式是PCM8 ENCODE_AUDIO_G729, // 音频编码格式是G729 ENCODE_AUDIO_IMA, // 音频编码格式是IMA ENCODE_PCM_MULAW, // 音频编码格式是PCM MULAW ENCODE_AUDIO_G721, // 音频编码格式是G721 ENCODE_PCM8_VWIS, // 音频编码格式是PCM8_VWIS ENCODE_MS_ADPCM, // 音频编码格式是MS_ADPCM ENCODE_AUDIO_G711A, // 音频编码格式是G711A ENCODE_AUDIO_AMR, // 音频编码格式是AMR ENCODE_AUDIO_PCM16, // 音频编码格式是PCM16 ENCODE_AUDIO_G711U = 22, // 音频编码格式是G711U ENCODE_AUDIO_G723 = 25, // 音频编码格式是G723 ENCODE_AUDIO_AAC, // 音频编码格式是AAC ENCODE_AUDIO_G726_40, // 音频编码格式是G726, 40kbps ENCODE_AUDIO_G726_32, // 音频编码格式是G726, 32kbps ENCODE_AUDIO_G726_24, // 音频编码格式是G726, 24kbps ENCODE_AUDIO_G726_16, // 音频编码格式是G726, 16kbps ENCODE_AUDIO_MP2, // 音频编码格式是mp2 ENCODE_AUDIO_OGG, // 音频编码格式是ogg vorbis ENCODE_AUDIO_MP3, // 音频编码格式是mp3 ENCODE_AUDIO_G722_1, // 音频编码格式是G722_1 ENCODE_AUDIO_OPUS = 38 // 音频编码格式是OPUS }ENCODE_AUDIO_TYPE; /* 码流封装格式 */ typedef enum { STREAM_TYPE_UNKNOWN = 0, // 未知码流 STREAM_TYPE_MPEG4, // MPEG4 STREAM_TYPE_DHPT =3, // 大华老码流：DHPT STREAM_TYPE_NEW, // 大华老码流：NEW STREAM_TYPE_HB, // 大华老码流：HB STREAM_TYPE_AUDIO, // 音频流 STREAM_TYPE_PS, // MPEG-2：PS STREAM_TYPE_DHSTD, // 大华最新的标准码流 STREAM_TYPE_ASF, // ASF STREAM_TYPE_3GPP, // 3GP STREAM_TYPE_RAW, // 大华老码流：裸码流 STREAM_TYPE_TS, // MPEG-2：TS STREAM_TYPE_SVC, // svc STREAM_TYPE_AVI, // AVI STREAM_TYPE_MP4, // MP4 STREAM_TYPE_CGI, // CGI STREAM_TYPE_WAV, // WAV音频 STREAM_TYPE_FLV, // FLV STREAM_TYPE_MKV, // mkv STREAM_TYPE_RTP, // RTP STREAM_TYPE_RAW_MPEG4, // MPEG4裸码流 STREAM_TYPE_RAW_H264, // H264裸码流 STREAM_TYPE_RAW_H265, // H265裸码流 STREAM_TYPE_WMV, // WMV STREAM_TYPE_RAW_MPEG2, // MPEG2裸码流 STREAM_TYPE_RAW_SVAC, // SVAC裸码流 STREAM_TYPE_MOV, STREAM_TYPE_VOB, // VOB STREAM_TYPE_RAW_H263, STREAM_TYPE_RM, STREAM_TYPE_DHPS, // DHPS }STREAM_TYPE; /* Demux扩展信息 */ typedef struct { char* pHead; // 帧数据(带大华头) int nLen; // 帧数据长度 char* pBody; // 裸数据(不带大华头) int nBodyLen; // 裸数据长度 int nRet; // 0:继续解码 1:不解码，默认为0 BYTE nEncryptType; // 加密类型，0:不加密 1:AES BYTE nRotateAngle; // 码流旋转角度 0:不旋转 1:90度旋转 2:180度旋转 3:270度旋转 char reserved1[2]; int nStreamType; // 码流封装格式,详见STREAM_TYPE定义 char reserved[120]; }DemuInfoEx; /* Demux基本信息 */ typedef struct { int type; // 详见FRAME_TYPE定义 int subtype; // 详见FRAME_SUB_TYPE定义 int encode; // 详见ENCODE_VIDEO_TYPE，ENCODE_AUDIO_TYPE定义 int sequence; // 帧序号 int width; // 视频宽 int height; // 视频高 int rate; // 帧率 int year; // 绝对时间年 int month; // 绝对时间月 int day; // 绝对时间日 int hour; // 绝对时间时 int minute; // 绝对时间分 int secode; // 绝对时间秒 LONG timestamp; // 相对时间戳 int channels; // 音频通道数 int bitspersample; // 音频采样深度 int samplespersecond;// 音频采样率 }DEMUX_INFO; typedef void (CALLBACK* fDemuxDecCBFun)(LONG nPort,char * pBuf, LONG nSize,void * pMutexInfo,void* pMutexInfoEx, void* pUserData); /** * 设置帧数据回调。 * * @param[in] nPort 通道号 * @param[out] DecCBFun 帧数据回调函数 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDemuxCallBack(LONG nPort, fDemuxDecCBFun DecCBFun, void* pUserData); /** * H264信息获取回调函数。 * * @param[in] nPort 通道号 * @param[in] pBuf 数据指针 * @param[in] nLen 数据长度 * @param[in] pUserData 用户自定义参数 */ typedef int (CALLBACK *fH264InfoCBFun)(LONG nPort, char* pBuf, LONG nLen, void* pUserData); /** * 设置H264信息获取回调函数。 * * @param[in] nPort 通道号 * @param[out] pH264InfoCBFun H264信息获取回调函数 * @param[in] nUser 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_Set264EncodeInfoCallBack(LONG nPort, fH264InfoCBFun pH264InfoCBFun, void* nUser); /** * 设置aes解密密钥。 * * @param[in] nPort 通道号 * @param[in] szKey 密钥的指针 * @param[in] nKeylen 密钥的长度 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetSecurityKey(LONG nPort,const char* szKey,DWORD nKeylen); /*加密类型*/ typedef enum { ENCRYPT_UNKOWN = 0, ENCRYPT_AES, ENCRYPT_AES256, ENCRYPT_AES256_GDPR2, ENCRYPT_SM1_ECB, /*国密加密算法SM1_ECB*/ ENCRYPT_SM1_OFB, /*国密加密算法SM1_OFB*/ ENCRYPT_SM4_ECB, /*国密加密算法SM4_ECB*/ ENCRYPT_SM4_OFB, /*国密加密算法SM4_OFB*/ //不知道具尸是哪种国密加密，就填这种SP_ENCRYPT_SM4_OFB }ENCRYPT_TYPE; typedef struct { unsigned char x[32]; unsigned char y[32]; }PUBLICKEY_PARAM; //解密参数 typedef struct { char* Key; //AES:key；AES256(GDPR一期):key； AES256(GDPR二期)和国密:vkek； int KeyLen; char* KeyId; //AES:不用填； AES256(GDPR一期):keyid； AES256(GDPR二期)和国密:vkekid ； int KeyIdLen; bool bSetPublicKey; //是否设置公钥 pPublicKey PUBLICKEY_PARAM* pPublicKey; //svac2.0 国密解密需要填; 其余都填NULL char Reserved[19]; //保留字段 }DECRYPT_PARAM; /** * 设置aes解密密钥。 * * @param[in] nPort 通道号 * @param[in] nType 解密类型 * @param[in] szKey 密钥的指针 * @param[in] nKeylen 密钥的长度 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetSecurityKeyEx(LONG nPort, ENCRYPT_TYPE nType, DECRYPT_PARAM* key, unsigned int key_len); /************************************************************************/ //> 显示操作 /************************************************************************/ /** * 设置或增加显示区域，可以做局部放大显示。 * * @param[in] nPort 通道号 * @param[in] nRegionNum 显示区域序号,0~(MAX_DISPLAY_WND-1),如果为0,则将设置的区域显示在主窗口中 * @param[in] pSrcRect 局部显示区域 * @param[in] hDestWnd 显示窗口句柄 * @param[in] bEnable 打开(设置)或关闭显示区域 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDisplayRegion(LONG nPort,DWORD nRegionNum, DISPLAYRECT *pSrcRect, HWND hDestWnd, BOOL bEnable); /** * 刷新显示。当用户暂停时如果刷新了窗口，则窗口中的图像因为刷新而消失， * 此时调用这个接口可以重新把图像显示出来。只有在暂停和单帧播放时才 * 执行，其它情况会直接返回。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_RefreshPlay(LONG nPort); /************************************************************************/ //> 缓冲区操作 /************************************************************************/ /** * 获取流播放模式下源缓冲区剩余数据大小(单位为字节)。 * * @param[in] nPort 通道号 * @return DWORD，当前源缓冲的大小单位BYTE(单位为字节) * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetSourceBufferRemain(LONG nPort); /** * 清空流播放模式下源缓冲区的剩余数据。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_ResetSourceBuffer(LONG nPort); /** * 清空流播放模式下源缓冲区的剩余数据。 * * @param[in] nPort 通道号 * @param[in] nBufType，如下： * BUF_VIDEO_SRC 1 视频源缓冲 * BUF_AUDIO_SRC 2 音频源缓冲 * BUF_VIDEO_RENDER 3 解码后视频数据缓冲 * BUF_AUDIO_RENDER 4 解码后音频数据缓冲 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_ResetBuffer(LONG nPort,DWORD nBufType); /** * 获取指定缓冲区的大小。 * * @param[in] nPort 通道号 * @param[in] nBufType，如下： * BUF_VIDEO_SRC 1 视频源缓冲 * BUF_AUDIO_SRC 2 音频源缓冲 * BUF_VIDEO_RENDER 3 解码后视频数据缓冲 * BUF_AUDIO_RENDER 4 解码后音频数据缓冲 * @return DWORD，根据不同参数返回缓冲区值，源缓冲区返回byte，解码后缓冲区返回帧数 * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetBufferValue(LONG nPort,DWORD nBufType); /************************************************************************/ //> 车载硬盘 /************************************************************************/ /** * 初始化硬盘(Windows32平台)。 * * @return UINT，成功返回硬盘数量， 失败返回0 */ PLAYSDK_API UINT CALLMETHOD PLAY_InitDisk(); /** * 进度回调函数。 * * @param[in] nPort 通道号 * @param[in] nPercent 进度百分比, -1表示异常 * @param[in] pUserData 用户自定义参数 */ typedef void (CALLBACK *fPercentCallbackFunc)(LONG nPort, int nPercent, void* pUserData); /** * 进度回调。可以设定文件开始结束时间，如果指定，需要PLAY_SetFileRefCallBack回调后才有效，[0,0] 表示整个文件大小，不需要建立索引，在PLAY_OpenFile之后调用。 * * @param[in] nPort 通道号 * @param[in] nStartTime 文件开始时间， 单位为从1970/1/1开始经过的秒数 * @param[in] nEndTime 文件结束时间， 单位为从1970/1/1开始经过的秒数 * @param[out] pFunCallback 进度回调函数指针 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetPercentCallBack(LONG nPort, LONG nStartTime, LONG nEndTime, fPercentCallbackFunc pFunCallback, void* pUserData); typedef enum { FORMAT_ALL_DATA, //清除所有数据 FORMAT_KEY_DATA //清除关键区数据 }FormatType; /** * 格式化硬盘(Windows32平台)。 * * @param[in] disk_no 要读取分区信息的磁盘号 * @param[in] type 格式化选项 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_FormatDisk(UINT disk_no, FormatType type); /** * 文件查询与定位(Windows32平台)。 * * @param[in] channel 需要查询的录像的通道号 * @param[in] start_time 录像查询的开始时间 * @param[in] end_time 录像查询的结束时间 * @param[in/out] pmax_ret_num 输入查询的最大文件个数，返回查询到的文件个数，文件系统最多一次返回pmax_ret_num传入的条数 * @param[out] pfile_info 查询到的录像文件存放的位置 * @param[in] type 查询的录像类型掩码，报警、动检、普通 * @param[in] hint 暂时无意义，固定设置为0 * @param[in] driver_type 驱动器类型掩码，指定在某些驱动器类型内查询 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 * 文件名字参考: "/part/uuid/%4d-%02d-%02d/%03d/%02d.%02d.%02d-%02d.%02d.%02d/cType/first_clus_no.dav" */ PLAYSDK_API UINT CALLMETHOD PLAY_QueryFileList(UINT nChannel,DHTIME start_time,DHTIME end_time,UINT *pmax_ret_num,pFILE_INFO pfile_info,UINT type, BYTE hint, UINT driver_type); /************************************************************************/ //> 鱼眼 /************************************************************************/ typedef enum { FISHEYEMOUNT_MODE_INVALID = 0, // 安装模式无效 FISHEYEMOUNT_MODE_CEIL = 1, // 顶装 FISHEYEMOUNT_MODE_WALL, // 壁装 FISHEYEMOUNT_MODE_FLOOR, // 地装 FISHEYEMOUNT_MODE_NUM }FISHEYE_MOUNTMODE; typedef enum { FISHEYECALIBRATE_MODE_INVALID = 0, // 矫正模式无效 FISHEYECALIBRATE_MODE_OFF = 1, // 关闭鱼眼算法库，外部关闭 FISHEYECALIBRATE_MODE_ORIGINAL, // 原始模式(正方形),带缩放比例 FISHEYECALIBRATE_MODE_PANORAMA, // 1p FISHEYECALIBRATE_MODE_PANORAMA_PLUS_ONE_EPTZ, // 1p+1 FISHEYECALIBRATE_MODE_DOUBLE_PANORAMA, // 2p FISHEYECALIBRATE_MODE_ORIGINAL_PLUS_DOUBLE_PANORAMA, // 1+2p FISHEYECALIBRATE_MODE_ORIGINAL_PLUS_THREE_EPTZ_REGION, // 1+3 FISHEYECALIBRATE_MODE_PANORAMA_PLUS_THREE_EPTZ_REGION, // 1p+3 FISHEYECALIBRATE_MODE_ORIGINAL_PLUS_TWO_EPTZ_REGION, // 1+2 FISHEYECALIBRATE_MODE_ORIGINAL_PLUS_FOUR_EPTZ_REGION, // 1+4 FISHEYECALIBRATE_MODE_PANORAMA_PLUS_FOUR_EPTZ_REGION, // 1p+4 FISHEYECALIBRATE_MODE_PANORAMA_PLUS_SIX_EPTZ_REGION, // 1p+6 FISHEYECALIBRATE_MODE_ORIGINAL_PLUS_EIGHT_EPTZ_REGION, // 1+8 FISHEYECALIBRATE_MODE_PANORAMA_PLUS_EIGHT_EPTZ_REGION, // 1p+8 FISHEYECALIBRATE_MODE_TWO_EPTZ_REGION_WITH_ORIGINAL, // 1F+2 FISHEYECALIBRATE_MODE_FOUR_EPTZ_REGION_WITH_ORIGINAL, // 1F+4 FISHEYECALIBRATE_MODE_DOUBLE_PANORAMA_WITH_ORIGINAL, // 1F+2p FISHEYECALIBRATE_MODE_FOUR_EPTZ_REGION_WITH_PANORAMA, // 1p(F)+4 FISHEYECALIBRATE_MODE_TWO_EPTZ_REGION, // 2画面 FISHEYECALIBRATE_MODE_SINGLE, // 单画面 FISHEYECALIBRATE_MODE_FOUR_EPTZ_REGION, // 4画面 FISHEYECALIBRATE_MODE_USER_DEFINED, // 用户自定义 FISHEYECALIBRATE_MODE_PHONE, // 手机模式 FISHEYECALIBRATE_MODE_ORIGINAL_PLUS_ONE_EPTZ_REGION, // 1+1 FISHEYECALIBRATE_MODE_ONE_EPTZ_REGION, // 1画面 FISHEYECALIBRATE_MODE_SEMI_SPHERE, // 半圆 FISHEYECALIBRATE_MODE_CYLINDER, // 圆柱 FISHEYECALIBRATE_MODE_LITTLE_PLANET, // 小行星 FISHEYECALIBRATE_MODE_DOUBLE_SPHERE, // 双目球 FISHEYECALIBRATE_MODE_DOUBLE_CYLINDER, // 双目圆柱 FISHEYECALIBRATE_MODE_DOUBLE_360, FISHEYECALIBRATE_MODE_NUM }FISHEYE_CALIBRATMODE; typedef enum { FISHEYEEPTZ_CMD_INVALID = 0, FISHEYEEPTZ_CMD_ZOOM_IN = 1, // 放大 FISHEYEEPTZ_CMD_ZOOM_OUT, // 缩小 FISHEYEEPTZ_CMD_UP, // 向上移动 FISHEYEEPTZ_CMD_DOWN, // 向下移动 FISHEYEEPTZ_CMD_LEFT, // 向左移动 FISHEYEEPTZ_CMD_RIGHT, // 向右移动 FISHEYEEPTZ_CMD_ROTATE_CLOCKWISE_AUTO, // 自动顺时针旋转 FISHEYEEPTZ_CMD_ROTATE_ANTICLOCKWISE_AUTO, // 自动逆时针旋转 FISHEYEEPTZ_CMD_STOP, // 停止 FISHEYEEPTZ_CMD_SHOW_REGION, // 框选放大 FISHEYEEPTZ_CMD_EXIT_SHOW_REGION, // 退出框选放大 FISHEYEEPTZ_CMD_DEFAULT, // 恢复默认 FISHEYEEPTZ_CMD_ORIGIN_ROTATE, // 圆旋转 FISHEYEEPTZ_CMD_SET_CUR_REGION = 0x20, // 配置指定窗口的位置信息 FISHEYEEPTZ_CMD_GET_CUR_REGION, // 获取指定窗口的位置信息 FISHEYEEPTZ_CMD_IS_IN_PANORAMA_REGION, // 输入点是否在当前全景点链区域内 FISHEYEEPTZ_CMD_TAP_VIEW, // 显示指定位置,即点即看 FISHEYEEPTZ_CMD_SET_FOCUS, // 设置窗口位置信息 FISHEYEEPTZ_CMD_GET_FOCUS, // 获取窗口位置信息 FISHEYEEPTZ_CMD_PTZ_CALI, // 鱼球联动标定 FISHEYEEPTZ_CMD_GET_PTZ_RLT, // 获取鱼球联动定位信息 FISHEYEEPTZ_CMD_SET_CUR_REGION_PTZ, // 外部直接输入ptz模式 FISHEYEEPTZ_CMD_GET_FOCUS_8192, // 获取窗口位置信息8192坐标系 FISHEYEEPTZ_CMD_NUM }FISHEYE_EPTZCMD; typedef enum { FISHEYE_SETPARAM, // 设置参数 FISHEYE_GETPARAM // 获取参数 }FISHEYE_OPERATETYPE; typedef enum { /* 枪机类型 */ IPCTYPE_200WN = 0, // IPCTYPE_130WN = 1, IPCTYPE_D1WN = 2, IPCTYPE_100WN = 3, IPCTYPE_FE = 4, // 鱼眼 //球机类型 SPCTYPE_D6501 = 100, // sony机芯65球机 HSPCTYPE_D6A2030E = 101, // 大华机芯2030E，6A球机 HSPCTYPE_D65A2030E = 102 // 大华机芯2030E，65A球机 }CAM_TYPE; /* 镜头类型 */ typedef enum { LENTYPE_NORM = 0, // 无畸变镜头 LENTYPE_Lens0361 = 1, // 3.6毫米枪机镜头 LENTYPE_Lens2880 = 2, // 130度广角枪机镜头 LENTYPE_Lens0362 = 3, // 3.6毫米枪机镜头 LENTYPE_Lens0401 = 4, // 4.0毫米枪机镜头 LENTYPE_TEST1 = 100 // 调试用参数 }LEN_TYPE; typedef struct { int w; int h; }FISHEYE_SIZE; typedef struct { short x; short y; }FISHEYE_POINT2D; typedef struct { FISHEYE_MOUNTMODE subMountMode; // 子图像安装模式, 仅当图像主校正模式为用户自定义模式时, 该值有效 FISHEYE_CALIBRATMODE subCalibrateMode; // 子图像校正模式, 仅当图像主校正模式为用户自定义模式时, 该值有效 FISHEYE_SIZE imgOutput; // 子图像输出分辨率 FISHEYE_POINT2D upperLeft; // 子图像偏移 int reserved[3]; // 保留字节 }FISHEYE_SUBMODE; typedef struct { FISHEYE_SIZE mainShowSize; // 主显示窗口分辨率, 算法据此输出适合的最优结果(不变形情况下尽量达到该比例) FISHEYE_SIZE floatMainShowSize; // 输出双buffer时使用，目前暂时还是用老的操作方法，浮动窗口的主显示窗口分辨率, 浮动圆的宽高比需要为1:1，浮动壁装全景的宽高比需要为16:9 FISHEYE_SIZE imgOutput; // 输出图像分辨率(缩放前), 图像主校正模式为用户自定义模式时为外部输入, 其他模式为内部返回 FISHEYE_SUBMODE* subMode; // 子模式信息, 图像主校正模式为用户自定义模式时为外部输入, 其他模式为内部返回 int subModeNum; // 子模式数, 图像主校正模式为用户自定义模式时为外部输入, 其他模式为内部返回 int outputSizeRatio; // 暂不启用, 校正输出图像的缩放比,Q8格式,范围0-256, 256为保持最大输出分辨率 int reserved[1]; // 保留字节 }FISHEYE_OUTPUTFORMAT; typedef struct { int x; int y; int hAngle; int vAngle; int available; int reserved[3]; }FISHEYE_REGIONPARAM; typedef struct { FISHEYE_REGIONPARAM regionParam[9]; int circularOffset; int panoramaOffset; int useRegionParam; // 为1时表明有效，使用该值进行初始化；没有保存信息时请置为0 int reserved[1]; }FISHEYE_MODEINITPARAM; typedef struct { /*必设参数*/ int zoom_type; // 倍数控制模式----期望自适应变倍和根据框选目标大小变倍两种模式 int hcam_wax; // 期望倍数对应球机角度x（水平） int hcam_way; // 期望倍数对应球机角度y（垂直） int hcam_wmul; // 期望倍数设置（基准倍数） int cfg_type; // 配置方式，默认为1：使用配置参数方式,1：使用参数配置方式，0：使用设备类型配置方式 /* 主相机参数 */ /* 镜头参数 */ int prm_re; // 投影半径 int prm_mul; // 投影倍率 int prm_dx; // x方向偏移 int prm_dy; // y方向偏移 int prm_cw; // CMOS宽（实际使用宽） int prm_ch; // CMOS高（实际使用高） /* 主相机和从相机类型配置（cfg_type为0时设置该参数才有效）,默认130度、130万枪机和200W65球机 */ LEN_TYPE mlen_type; // 主相机镜头类型 CAM_TYPE mcam_type; // 主相机类型 CAM_TYPE hcam_type; // 从相机类型 /* 球机参数 */ int himg_width; // 从相机图像宽 int himg_height; // 从相机图像高 int prm_fax; // 球机水平视场角 /* 可默认的参数 */ /* 主相机参数 */ int mcam_fc; // 相机等效焦距 int mcam_cw; // 镜头靶面高 int mcam_ch; // 镜头靶面宽 int cam_height; // 相机架设高度（米），（暂时未使用） int prm_ma; // 焦距参数 /* 从相机参数 */ /* 球机参数 */ int prm_hw; // CMOS宽 int prm_hh; // CMOS高 int prm_fo; // 等效焦距 int prm_ca; // 视野参数 int prm_mmul; // 最大倍率 }MHFPTZ_CONFIGPARAM; typedef struct { FISHEYE_SIZE mainStreamSize; // 对应主码流原始宽高，当传入分辨率与之不等时表明为辅码流是此分辨率缩放而来 int originX; // 输入图像中鱼眼圆的圆心横坐标, 归一化至0-8192坐标系 int originY; // 输入图像中鱼眼圆的圆心纵坐标, 归一化至0-8192坐标系 int radius; // 输入图像中鱼眼圆的半径, 归一化至0-8192坐标系 int lensDirection; // 旋转角度, Q7格式, 范围0-360*128, 一般配为0 FISHEYE_MOUNTMODE mainMountMode; // 主安装模式 FISHEYE_CALIBRATMODE mainCalibrateMode; // 图像主校正模式 FISHEYE_MODEINITPARAM modeInitParam; // 外部传入模式初始化各画面信息，适用于模式切换恢复到上一次的状态, FISHEYE_OUTPUTFORMAT *outputFormat; // 输出图像信息 MHFPTZ_CONFIGPARAM *configParam; // 鱼球联动配置参数 int enableAutoContrast; // 开启自动对比度, 0关闭, 1开启, 该功能会增加算法耗时, 需要性能好的机器才建议开启 int alphaHistogram; // 直方图IIR强度0-255, 默认128, 越大越参考当前帧 int alphaGray; // 灰度拉伸强度0-255, 默认245, 越大越对比度弱 FISHEYE_SIZE captureSize; // 对应当前模式下的抓图分辨率 int mhfptzIndex; // IN 鱼球联动球机序号0,1,2.... int reserved[1]; // 保留字节 }FISHEYE_OPTPARAM; typedef struct { FISHEYE_EPTZCMD ePtzCmd; // 云台操作，说明见FISHEYE_EPtzCmd定义 int winId; // 要进行eptz的窗口编号，左上角winId为0，从左到右递增 int arg1; int arg2; int arg3; int arg4; int arg5; int arg6; int reserved0[6]; // 保留字节 void* pParam; // 鱼球联动 void* pResult; void* pArg; int reserved1[7]; // 保留字节 }FISHEYE_EPTZPARAM; /** * 开启视频鱼眼算法功能，需要包含fisheye.dll库。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_StartFisheye(LONG nPort); /** * 设置/获取鱼眼参数。 * * @param[in] nPort 通道号 * @param[in] operatetype 操作类型 * @param[in/out] pOptParam 鱼眼参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_OptFisheyeParams(LONG nPort, FISHEYE_OPERATETYPE operatetype, FISHEYE_OPTPARAM* pOptParam); /** * 用于浮动模式下开启或关闭第二个鱼眼窗口。 * * @param[in] nPort 通道号 * @param[in] hDestWnd 显示窗口句柄 * @param[in] pOptParam 第二个窗口对应的鱼眼参数 * @param[in] bEnable 打开或关闭显示区域 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_FisheyeSecondRegion(LONG nPort, HWND hDestWnd, FISHEYE_OPTPARAM* pOptParam, BOOL bEnable); /** * 开启eptz(电子云台），进行缩放移动。 * * @param[in] nPort 通道号 * @param[in/out] pEptzParam 调节参数 * @param[in] bSecondRegion 是否为浮动模式下的第二个窗口，1为真，默认填0 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_FisheyeEptzUpdate(LONG nPort, FISHEYE_EPTZPARAM* pEptzParam, BOOL bSecondRegion); /** * 停止视频鱼眼算法功能。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_StopFisheye(LONG nPort); /** * 鱼眼信息回调函数。 * * @param[in] nPort 通道号 * @param[in] byCorrectMode 矫正模式 * @param[in] wRadius 半径 * @param[in] wCircleX 圆心横坐标 * @param[in] wCircleY 圆心纵坐标 * @param[in] widthRatio 宽比率 * @param[in] heightRatio 高比率 * @param[in] gain 增益 * @param[in] denoiseLevel 降噪等级 * @param[in] InstallStyle 鱼眼安装方式 * @param[in] pUserData 用户自定义参数 */ typedef void (CALLBACK* fFishEyeInfoFun)( LONG nPort, BYTE byCorrectMode, WORD wRadius, WORD wCircleX, WORD wCircleY, UINT widthRatio, UINT heightRatio, BYTE gain, BYTE denoiseLevel, BYTE installStyle, void* pUserData ); /** * 设置获取鱼眼信息回调。 * * @param[in] nPort 通道号 * @param[out] pFishEyeInfoFun 鱼眼信息回调函数指针，不能为NULL * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetFishEyeInfoCallBack(LONG nPort, fFishEyeInfoFun pFishEyeInfoFun, void* pUserData); /************************************************************************/ //> 抓图 /************************************************************************/ /** * 抓图，将BMP图片保存为指定的文件。PLAY_SetDisplayCallBack设置的视频数 * 据回调函数，只有在有视频数据解码出来时才调用，并由用户处理视频数 * 据(如抓图)，如果不断有解码的数据，就不断调用这个回调函数。而PLAY_ * CatchPic一次只抓一幅图，并能在暂停和单帧播放时实现抓图。建议：如果 * 用户想实现抓图(一次抓一幅图)，调用PLAY_CatchPic，而如果想得到一段 * 时间内的视频数据，调用PLAY_SetDisplayCallBack。 * * @param[in] nPort 通道号 * @param[in] sFileName 文件名 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_CatchPic(LONG nPort,char* sFileName); /** * 抓图，将图片保存为指定的文件。PLAY_SetDisplayCallBack设置的视频数 * 据回调函数，只有在有视频数据解码出来时才调用，并由用户处理视频数 * 据(如抓图)，如果不断有解码的数据，就不断调用这个回调函数。而PLAY_ * CatchPicEx一次只抓一幅图，并能在暂停和单帧播放时实现抓图。建议：如果 * 用户想实现抓图(一次抓一幅图)，调用PLAY_CatchPicEx，而如果想得到一段 * 时间内的视频数据，调用PLAY_SetDisplayCallBack。 * @param[in] nPort 通道号 * @param[in] sFileName 文件名 * @param[in] ePicfomat 图片格式，见tPicFormats * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_CatchPicEx(LONG nPort,char* sFileName,tPicFormats ePicfomat); /** * 图像格式转为BMP格式。 * * @param[in] pBuf 图像数据指针 * @param[in] nSize 图像数据大小 * @param[in] nWidth 图像宽度 * @param[in] nHeight 图像高度 * @param[in] nType 数据类型，如T_YV12，T_UYVY * @param[in] sFileName 要保存的文件名。最好以BMP作为文件扩展名 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_ConvertToBmpFile(char * pBuf,LONG nSize,LONG nWidth,LONG nHeight,LONG nType, char *sFileName); /* * 图像格式转为JPEG格式。 * * @param[in] pYUVBuf 图像数据指针 * @param[in] nWidth 图像宽度 * @param[in] nHeight 图像高度 * @param[in] YUVtype YUV数据类型，如T_YV12，T_UYVY * @param[in] quality 图片压缩质量，范围(0, 100] * @param[in] sFileName 文件名 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_ConvertToJpegFile(char *pYUVBuf, LONG nWidth, LONG nHeight, int YUVtype, int quality, char *sFileName); /** * 抓取BMP图像。 * * @param[in] nPort 通道号 * @param[in] pBmpBuf 存放BMP图像数据的缓冲地址，由用户分配，不得小于bmp 图像大小， * 推荐大小：sizeof(BITMAPFILEHEADER)+sizeof(BITMAPINFOHEADER)+w*h*4， * 其中w和h分别为图像宽高 * @param[in] dwBufSize 缓冲区大小 * @param[out] pBmpSize 获取到的实际bmp图像大小 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetPicBMP(LONG nPort, PBYTE pBmpBuf, DWORD dwBufSize, DWORD* pBmpSize); /** * 抓取BMP图像。 * * @param[in] nPort 通道号 * @param[in] pBmpBuf 存放BMP图像数据的缓冲地址，由用户分配，不得小于bmp 图像大小， * 推荐大小：sizeof(BITMAPFILEHEADER)+sizeof(BITMAPINFOHEADER)+w*h*4， * 其中w和h分别为图像宽高。 * @param[in] dwBufSize 缓冲区大小 * @param[out] pBmpSize 获取到的实际bmp图像大小 * @param[in] nWidth 指定的bmp的宽 * @param[in] nHeight 指定的bmp的高 * @param[in] nRgbType 指定RGB格式 0：RGB32；1：RGB24； * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetPicBMPEx(LONG nPort, PBYTE pBmpBuf, DWORD dwBufSize, DWORD* pBmpSize, LONG nWidth, LONG nHeight, int nRgbType); /** * 抓取JPEG图像。 * * @param[in] nPort 通道号 * @param[in] pJpegBuf 存放JPEG图像数据的缓冲地址，由用户分配，不得小于JPEG图像大小， 推荐大小：w*h*3/2，其中w和h分别为图像宽高 * @param[in] dwBufSize 缓冲区大小 * @param[out] pJpegSize 获取到的实际JPEG图像大小 * @param[in] quality JPEG图像的压缩质量，取值范围为(0,100] * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetPicJPEG(LONG nPort, PBYTE pJpegBuf, DWORD dwBufSize, DWORD* pJpegSize, int quality); /** * 抓取TIFF图像。 * * @param[in] nPort 通道号 * @param[in] pTiffBuf 存放TIFF图像数据的缓冲地址，由用户分配，不得小于tiff图像大小， 推荐大小：w*h*3+1024， 其中w和h分别为图像宽高 * @param[in] dwBufSize 缓冲区大小 * @param[out] pTiffSize 获取到的实际TIFF图像大小 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetPicTIFF(LONG nPort, PBYTE pTiffBuf, DWORD dwBufSize, DWORD* pTiffSize); /** * 抓图，可选择格式并指定宽高。 * * @param[in] nPort 通道号 * @param[in] sFileName 文件名 * @param[in] lTargetWidth 指定的图像宽度 * @param[in] lTargetHeight 指定的图像高度 * @param[in] ePicfomat 图片格式，详见tPicFomats * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_CatchResizePic(LONG nPort, char* sFileName, LONG lTargetWidth, LONG lTargetHeight, tPicFormats ePicfomat); /************************************************************************/ //> 画图回调 /************************************************************************/ /* *画图回调函数 * * @param[in] nPort 通道号 * @param[in] hDc OffScreen表面设备上下文 * @param[in] pUserData 用户自定义参数 */ typedef void (CALLBACK* fDrawCBFun)(LONG nPort,HDC hDc, void* pUserData); /* * 注册一个回调函数，获得当前表面的device context，你可以在这个DC上画图(或文字)， * 就好像在窗口的客户区DC上绘图，但这个DC不是窗口客户区的DC，而是DirectDraw里 * 的Off-Screen表面的DC。注意，如果是使用overlay表面，这个接口无效，可以直接在 * 窗口上绘图，只要不是透明色就不会被覆盖。 * * @param[in] nPort 通道号 * @param[out] DrawFun 画图回调函数 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_RigisterDrawFun(LONG nPort, fDrawCBFun DrawCBFun, void* pUserData); /* *画图回调函数 * * @param[in] nPort 通道号 * @param[in] nReginNum 显示区域序号，范围[0,(MAX_DISPLAY_WND-1)]。如果nRegionNum为0， * 则将设置的区域显示在主窗口中。 * @param[in] hDc OffScreen表面设备上下文 * @param[in] pUserData 用户自定义参数 */ typedef void (CALLBACK* fDrawCBFunEx)(LONG nPort,LONG nReginNum,HDC hDc, void* pUserData); /* * 注册一个回调函数，获得当前表面的上下文(HDC)，这个DC不是窗口客户区的DC， * 而是DirectDraw里的Off-Screen表面的DC。注意。如果是使用overlay表面， * 这个接口无效，overlay方式可以直接在窗口上绘图，只要不是透明色就不会被覆盖。 * * @param[in] nPort 通道号 * @param[in] nReginNum 显示区域序号，范围[0,(MAX_DISPLAY_WND-1)]。如果nRegionNum为0， * 则将设置的区域显示在主窗口中 * @param[out] DrawFunEx 画图回调函数 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_RigisterDrawFunEx(LONG nPort, LONG nReginNum, fDrawCBFunEx DrawFunEx, void* pUserData); /************************************************************************/ //> 录制或转码功能 /************************************************************************/ /* * 开始预录。 * * @param[in] nPort 解码通道 * @param[in] sFileName 录像位置 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_StartPrepareRecord(LONG nPort,const char* pFileName); /* * 停止预录。 * * @param[in] nPort 解码通道 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_StopPrepareRecord(LONG nPort); /* * 开始流数据录像，只对流模式有用，在PLAY_Play之后调用。 * * @param[in] nPort 通道号 * @param[in] sFileName 文件名 * @param[in] idataType 取值DATA_RECORD_TYPE * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ typedef enum { DATA_RECORD_ORIGINAL = 0, // 录制原始视频流 DATA_RECORD_AVI, // 录制AVI DATA_RECORD_ASF, // 录制ASF DATA_RECORD_ORIGINAL_SEGMENT, // 录制分段的原始视频流（废弃，分段下载请使用PLAY_StartDataRecordEx接口） DATA_RECORD_RESIZE_AVI, // 录制转变分辨率的AVI，使用PLAY_ResolutionScale设置宽高 DATA_RECORD_MP4, // 录制MP4 DATA_RECORD_RESIZE_MP4, // 录制转变分辨率的MP4，使用PLAY_ResolutionScale设置宽高 DATA_RECORD_MP4_NOSEEK, // 录制不回写MP4 DATA_RECORD_RESIZE_MP4_NOSEEK,// 录制转变分辨率的不回写MP4，使用PLAY_ResolutionScale设置宽高 DATA_RECORD_TS, // 录制TS DATA_RECORD_PS, // 标准PS封装 DATA_RECORD_RESIZE_DAV, // 录制DAV(需要重新编解码) DATA_RECORD_DAV, // 录制DAV(不需要重新编解码) // 如果需要增加枚举，在此之前增加 DATA_RECORD_COUNT // 录制类型数目 }DATA_RECORD_TYPE; PLAYSDK_API BOOL CALLMETHOD PLAY_StartDataRecord(LONG nPort, char *sFileName, int idataType); /* * 保存原始码流，该接口需与PLAY_StartDataRecord或者PLAY_StartDataRecordEx配合着使用。 * * @param[in] nPort 通道号 * @param[in] pBuf 流数据 * @param[in] nSize 大小 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_WriteData(LONG nPort, PBYTE pBuf,DWORD nSize); /* * 停止流数据录像。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_StopDataRecord(LONG nPort); /* * 回调函数 AVIConvertCallback。 * * @param[in] nPort 通道号 * @param[in] lMediaChangeType AVI_MEDIACHANGE_FRAMERATE表示帧率改变；AVI_MEDIACHANGE_RESOLUTION表示分辨率改变 * @param[in] pUserData 用户自定义参数 * @param[out] pIsNewFile TRUE 分段转换；FALSE 不分段；默认不分段 * @param[out] sNewFileName 如果分段转换，新的录像文件名 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ typedef void (CALLBACK* fAVIConvertCallback)(LONG nPort, LONG lMediaChangeType, void* pUserData, BOOL *pIsNewFile, char *sNewFileName); /* * 开始AVI转换并设置AVI转换状态回调。 * * @param[in] nPort 通道号 * @param[in] sFileName 文件名 * @param[out] pAVIFunc 回调函数 * @param[in] pUserData 用户自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_StartAVIConvert(LONG nPort, char *sFileName, fAVIConvertCallback pAVIFunc, void* pUserData); /* * 停止AVI转换。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_StopAVIConvert(LONG nPort); /************************************************************************/ //> 解码及显示设置 /************************************************************************/ /* * 指定解码器(Windows平台)， PLAY_Play之前调用有效。 * * @param[in] nPort 通道号 * @param[in] decodeType 解码模式（仅限于H264， Hevc) * @param[in] renderType 渲染模式 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetEngine(LONG nPort,DecodeType decodeType,RenderType renderType); /* * 设置图像质量，当设置成高质量时画面效果好，但CPU利用率高。在支持多路播放时， * 可以设为低质量，以降低CPU利用率。当某路放大播放时将该路设置成高质量， * 以达到好的画面效果。 * * @param[in] nPort 通道号 * @param[in] bHighQuality 为TRUE(1)时图像高质量，为FALSE(0)时低质量(默认值) * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetPicQuality(LONG nPort,BOOL bHighQuality); /* * 获取图像质量。 * * @param[in] nPort 通道号 * @param[out] bHighQuality 输出参数，TRUE表示高质量，FALSE表示低质量 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_GetPictureQuality(LONG nPort,BOOL *bHighQuality); /* * 垂直同步显示开关。此接口需在PLAY_Play之后调用，重新播放时需重新设置。 * 在播放动态图像出现断层时，可以使用此接口打开垂直同步功能。 * * @param[in] nPort 通道号 * @param[in] bEnable TRUE打开垂直同步，FALSE关闭垂直同步 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_VerticalSyncEnable(LONG nPort, BOOL bEnable); /* * 是否启用高清图像内部调整策略。 * * @param[in] nPort 通道号 * @param[in] bEnable 详见PLAY_STRATEGE_E定义 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ typedef enum _PLAY_STRATEGE { PLAY_THROW_FRAME_NO = 0, // 不抽帧 PLAY_THROW_FRAME_FLAG_HIGHT = 1, // 默认策略抽帧，大于1080P码流4倍数(含)以上抽帧，[1080P,720P]码流8倍数(含)以上抽帧，小于720P码流16倍数(含)以上抽帧 PLAY_THROW_FRAME_FLAG_ALL = 2, // 强制抽I帧解码 PLAY_THROW_FRAME_FLAG_ADAPTION = 3, // 自适应解码能力抽帧 PLAY_THROW_FRAME_FLAG_ADAPTION_LOW_CPU = 4, // 自适应解码能力抽帧，低cpu占用率 } PLAY_STRATEGE_E; PLAYSDK_API BOOL CALLMETHOD PLAY_EnableLargePicAdjustment(LONG nPort, int bEnable); /* * 设置解码线程数。 * * @param[in] nPort 通道号 * @param[in] nNum 线程数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDecodeThreadNum(LONG nPort, DWORD nNum); /* * 设置解码策略，错误码流花屏或跳秒。 * * @param[in] nPort 通道号 * @param[in] nStrategyType * 16: 表示解码中遇到frame不连续，提前返回 * 8: 表示解码中遇到码流数据不符合协议当成解码错误 * 0 : 表示解码中遇到码流数据不符合协议继续解码，错误码流会花屏 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDecodeStrategy(LONG nPort, int nStrategyType); /* * 抗锯齿使能开关，仅支持Windows。 * * @param[in] nPort 通道号 * @param[in] bEnable TRUE打开抗锯齿处理，FALSE关闭抗锯齿处理 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_AntiAliasEnable(LONG nPort, BOOL bEnable); /************************************************************************/ //> 私有数据 /************************************************************************/ /* * 显示私有数据，例如规则框，规则框报警，移动侦测等。 * * @param[in] nPort 通道号 * @param[in] bTrue TRUE：打开 FALSE：关闭 * @param[in] nReserve 保留参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_RenderPrivateData(LONG nPort, BOOL bTrue, LONG nReserve); /* * 数据帧回调 PLAY_SetDataCallBack。 * * @param[in] nPort 通道号 * @param[in] pBuf 带大华头的原始数据 * @param[in] nSize 数据大小 * @param[in] pUserData 用户自定义数据 */ typedef void (CALLBACK* fDataCBFun)(LONG nPort,char * pBuf,LONG nSize, void* pUserData); /* * 数据帧回调，回调带大华头的原始数据，外层自己实现解析。 * * @param[in] nPort 通道号 * @param[out] pDataCBFun 回调函数 * @param[in] pUserData 用户自定义数据 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetDataCallBack(LONG nPort, fDataCBFun pDataCBFun, void* pUserData); /* * IVS解码回调函数。 * * @param[in] pIVSBuf 辅助帧数据(json或智能帧结构体数据)，当为智能帧结构体数据时，pIVSBuf为IVS Object结构体数组的起始地址 * @param[in] nIVSType 辅助帧数据类型,详见IVS_TYPE * 取值为IVSINFOTYPE_RAWDATA时，对应原始json数据 * 取值为IVSINFOTYPE_TRACK时，单个IVS object对应结构体 SP_IVS_OBJ_EX； * 取值为IVSINFOTYPE_TRACK_EX_B0时，单个IVS object对应结构体 SP_IVS_COMMON_OBJ； * @param[in] nIVSBufLen 辅助帧数据长度(json或智能帧结构体数据)， * 当为智能帧结构体数据时，nIVSBufLen为IVS Object的个数乘以单个IVS object的长度，单个IVS object的长度可由type备注类型获得 * @param[in] nFrameSeq 辅助帧id * @param[in] pReserved 保留参数 * @param[in] pUserData 自定义参数 */ /* IVS类型 */ typedef enum _IVS_TYPE { IVSINFOTYPE_PRESETPOS = 1, IVSINFOTYPE_MOTINTRKS = 2, IVSINFOTYPE_MOTINTRKS_EX = 3, IVSINFOTYPE_LIGHT = 4, IVSINFOTYPE_RAWDATA = 5, // jason数据 IVSINFOTYPE_TRACK = 6, // 智能分析信息 IVSINFOTYPE_TRACK_EX_B0 = 7, // 智能结构化数据信息 IVSINFOTYPE_MOTIONFRAME = 9, IVSINFOTYPE_VIDEO_CONCENTRATION = 10, IVSINFOTYPE_OVERLAY_PIC = 11, // 叠加图片帧 IVSINFOTYPE_OSD_INFO = 12, // OSD辅助帧 IVSINFOTYPE_GPS_INFO = 13, // GPS辅助帧 IVSINFOTYPE_TAGGING_INFO = 14, // 景物点信息标注帧，辅助帧(0x13) IVSINFOTYPE_TRACK_A1 = 15, // NVR浓缩信息轨迹点 IVSINFOTYPE_DATA_WITH_LARGE_AMOUNT = 16, IVSINFOTYPE_TRACK_A1_EX = 17, // NVR浓缩信息轨迹点(扩展) IVSINFOTYPE_DATA_WITH_WATER_LEVEL_MONITOR = 18, //水位检测水位尺信息帧(0x17) IVSINFOTYPE_INTELFLOW = 19, // 智能客流量 IVSINFOTYPE_DATA_WITH_SOUND_DECIBEL = 20, //声音警报分贝值信息帧(0x18) IVSINFOTYPE_DATA_WITH_SMART_MOTION = 21, //智能动检信息帧(0x19) }IVS_TYPE; /* IVSINFOTYPE_OVERLAY_PIC类型对应的结构 */ typedef struct { unsigned char nOverLayPicPurpose; // 叠加图片用途 unsigned char nOverLayPicAction; // 叠加图片动作 unsigned char nOverLayPicCodeFormat;// 叠加图片编码格式 }OVERLAY_PIC_INFO; /* IVSINFOTYPE_OSD_INFO类型对应的结构 */ typedef struct { unsigned short nOsdTopLeftCornercoordinateX; // 字符叠加区域左上角x坐标 unsigned short nOsdTopLeftCornercoordinateY; // 字符叠加区域左上角y坐标 unsigned char nOsdWordSize; // 字号(字符大小) unsigned char nOsdWordAlignment; // 字符对齐方式 unsigned char reverse[6]; unsigned int nOsdRgbaValue; // 字符颜色 }OSD_DATA_INFO; typedef void (CALLMETHOD *fIVSInfoCallbackFunc)(char* pIVSBuf, LONG nIVSType, LONG nIVSBufLen, LONG nFrameSeq, void* pReserved, void* pUserData); /* * IVS信息获取函数。 * * @param[in] nPort 通道号 * @param[out] pFunc 解码回调函数 * @param[in] pUserData 自定义参数 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetIVSCallBack(LONG nPort, fIVSInfoCallbackFunc pFunc, void* pUserData); /* * GPS信息回调函数。 * * @param[in] pBuf 辅助帧数据 * @param[in] nLen 辅助帧长度 * @param[in] pUserData 自定义 * @return int 无意义 */ typedef int (CALLBACK *fGPSInfoCallbackFunc)(char* pBuf, LONG nLen, void* pUserData); /* * GPS信息获取函数。 * * @param[in] nPort 通道号 * @param[out] pFunc 回调函数 * @param[in] pUserData 自定义 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetGPSCallBack(LONG nPort, fGPSInfoCallbackFunc pFunc, void* pUserData); /* 统计信息类型 */ typedef enum _STATISTIC_TYPE { TYPE_UNUSE = 0, // 未使用类型 INPUT_DATA_INTERVAL, // 输入流数据间隔,参数1为时间间隔，参数2为数据长度 PRASE_VIDEO_INTERVAL, // 视频帧解析间隔，参数1为时间间隔，参数2位帧号 VIDEO_PTS_INTERVAL, // 视频pts间隔，参数1为时间间隔，参数2为帧号 DECODE_VIDEO_TIME, // 视频解码耗时，参数1为接口耗时，参数2为帧号 PLAY_VIDEO_INTERVAL, // 视频帧播放间隔，参数1为时间间隔，参数2为帧号 RENDER_VIDEO_TIME, // 视频渲染耗时，参数1为接口耗时 VIDEO_DECODE_ERROR = 1000, // 视频解码报错，参数1无意义，参数2为帧号 }STATISTIC_TYPE; /* 统计信息对应的结构 */ typedef struct statistic_info { LONG nPort; // 通道号 LONG nStatisticType; // 信息类型 LONGLONG nParam1; // 参数1 LONGLONG nParam2; // 参数2 char szReserved[16]; // 保留参数 } STATISTIC_INFO, *PSTATISTIC_INFO; /* * 解码播放统计信息回调 * * @param[in] pStatisticData 统计数据 * @param[in] pUserData 自定义参数 * @return int 无意义 */ typedef int (CALLBACK *fStatisticCallbackFunc)(PSTATISTIC_INFO pStatisticData, void* pUserData); /* * 统计信息获取函数。 * * @param[in] nPort,通道号 * @param[out] pFunc 回调函数 * @param[in] pUserData 自定义 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetStatisticCallBack(LONG nPort, fStatisticCallbackFunc pFunc, void* pUserData); /* * 设置图像显示比例 * * @param[in] nPort,通道号 * @param[in] nWidthProportion 宽值，图像宽高比 * @param[in] nHeightProportion 高值，图像宽高比 * @return BOOL，成功返回TRUE，失败返回FALSE */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetViewProportion(LONG nPort, int nWidthProportion, int nHeightProportion); /************************************************************************/ //> 不推荐使用的接口 /************************************************************************/ /* * 获取错误码，此接口无效，请使用PLAY_GetLastErrorEx接口。 * * @param[in] nPort,通道号 * @return DWORD，获得错误码。 */ PLAYSDK_API DWORD CALLMETHOD PLAY_GetLastError(LONG nPort); /* * 打开文件并自动分配通道号。 * * @param[in] sFileName 文件名 * @return DWORD，失败返回0，否则返回通道号 * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API DWORD CALLMETHOD PLAY_CreateFile(LPSTR sFileName); /* * 关闭播放文件并释放自动分配的通道号。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_DestroyFile(LONG nPort); /* * 打开流接口并自动分配通道号。 * * @param[in] nBufPoolSize 置播放器中存放数据流的缓冲区大小，范围是[SOURCE_BUF_MIN,SOURCE_BUF_MAX] * @return DWORD,失败返回0，否则返回通道号 * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API DWORD CALLMETHOD PLAY_CreateStream(DWORD nBufPoolSize); /* * 关闭数据流，并释放自动分配的通道号。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_DestroyStream(LONG nPort); /* * 与PLAY_OneByOneBack重复，请使用PLAY_OneByOneBack。 * * @param[in] nPort 通道号 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_BackOne(LONG nPort); /* * 设置分辨率改变通知消息。 * * @param[in] nPort 通道号 * @param[in] hWnd 消息发送的窗口 * @param[in] nMsg 用户输入的消息，当解码时编码格式发生改变时用户在hWnd窗口过程中收到这个消息 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetEncChangeMsg(LONG nPort,HWND hWnd,UINT nMsg); /* * 设置文件结束时要发送的消息。 * * @param[in] nPort 通道号 * @param[in] hWnd 消息发送窗口 * @param[in] nMsg 用户自定义的输入的消息，当播放到文件结束时用户在hWnd窗口过程中 * @return BOOL，成功返回TRUE，失败返回FALSE * @note 如果返回失败，可以调用PLAY_GetLastErrorEx接口获取错误码。 */ PLAYSDK_API BOOL CALLMETHOD PLAY_SetFileEndMsg(LONG nPort,HWND hWnd,UINT nMsg); #ifdef __cplusplus } #endif #endif