《大华播放SDK开发手册》由会员分享，可在线阅读，更多相关《大华播放SDK开发手册（107页珍藏版）》请在金锄头文库上搜索。
1、大华播放SDK编程手册VERSION 3.28.2(Build 100129)2010-01-29版权所有 侵权必究前 言非常感谢您使用我们公司的设备，我们将为您提供最好的服务。本手册可能包含技术上不准确的地方或印刷错误，欢迎指正。我们将会定期更新手册的内容。修订记录日期修订内容修订者2010-1-29添加接口：PLAY_SetFileRefCallBackExPLAY_GetRealFrameBitRate金志贤2010-1-22添加接口:PLAY_SetVisibleDecCallBack;PLAY_CatchResizePic金志贤2009-10-26添加接口说明：PLAY_GetFre
2、ePort, PLAY_ReleasePort;PLAY_VerticalSyncEnable;PLAY_GetPicBMP, PLAY_GetPicJPEG;添加媒体信息获取指令：PLAY_CMD_GetMediaInfo金志贤2009-8-14整理文档，修改文档版式，添加接口说明金志贤2009-07-15整理文档，增加对最新接口的说明张博2008-03-25整理文档，修改多显卡及设置高画质接口的定义周国锋2007-10-16整理文档周国锋、陈琼施2007-9-3增加对最新接口的说明王兰君2006-12-27整理文档周国锋、陈琼施2006-12-18创建冯江、周国锋目 录1 简 介1.1 概
3、述播放SDK是大华压缩卡和硬盘录像机的配套产品，支持大华所有码流格式以及海思公司的h264码流和ADI的h264码流。本文档详细描述了开发包中各函数实现的功能及接口播放SDK的主要功能有：支持文件或流数据的播放、回放控制（如暂停恢复、快放慢放）、音频控制、流数据录像、多区域显示、按帧序号或按时间定位、数据回调、消息回调、字符叠加、抓图.开发包中包括的文件有: 、底层mpeg4解码库（）、底层h264解码库(解大华的h264码流和ADI公司的码流)和海思的h264解码库，包括、 。1.2 适用性 v 支持大华所有码流以及ADI的h264码流和海思的h264码流的解码 v 支持HB、HBE、LB、
4、LBE、GB、GBE、NVS机型码流设计原则2 设计原则2.1 典型调用2.1.1 多显卡初始化初始化多显卡设备PLAY_InitDDrawDevice获取显卡数目PLAY_GetDDrawDeviceTotalNums设置播放窗口使用的显卡PLAY_SetDDrawDevice获取显卡信息PLAY_GetDDrawDeviceInfo获取显卡功能PLAY_GetCapsEx关闭多显卡设备PLAY_RealeseDDraw2.1.2 回调及功能设置设置文件结束消息回调PLAY_SetFileEndMsg设置文件结束函数回调PLAY_SetFileEndCallBack设置图像格式改变消息回调P
5、LAY_SetEncChangeMsg设置图像格式改变函数回调PLAY_SetEncTypeChangeCallBack设置文件索引建立后回调PLAY_SetFileRefCallBack设置流缓冲小于阀值回调PLAY_SetSourceBufCallBack设置数据解码回调PLAY_SetDecCallBackPLAY_SetDecCallBackEx设置数据解码回调同时显示视频PLAY_SetVisibleDecCallBack设置视频解码回调PLAY_SetDisplayCallBack设置音频解码回调PLAY_SetAudioCallBack设置水印数据回调PLAY_SetVerify
6、CallBack设置分析数据回调PLAY_SetDemuxCallBack设置文件索引PLAY_SetRefValue设置播放缓冲帧数PLAY_SetDisplayBuf设置overlay模式及关键色PLAY_SetOverlayMode设置流打开模式PLAY_SetStreamOpenMode设置定时器类型PLAY_SetTimerType设置水印数据回调PLAY_SetWaterMarkCallBack2.1.3 打开文件或数据流创建文件PLAY_CreateFile打开文件PLAY_OpenFile创建流文件PLAY_CreateStream打开流PLAY_OpenStreamPLAY_
7、OpenStreamEx2.1.4 播放播放开始PLAY_Play2.1.5 各功能操作及信息获取播放声音PLAY_PlaySoundPLAY_PlaySoundShare设置音量PLAY_SetVolume获取音量PLAY_GetVolume关闭声音PLAY_StopSoundPLAY_StopSoundShare开始流数据录像PLAY_StartDataRecord获取空闲的通道号PLAY_GetFreePort释放通道号PLAY_ReleasePort输入流数据PLAY_InputDataPLAY_InputVideoDataPLAY_InputAudioData结束流数据录像PLAY_
8、StopDataRecord重置流缓冲回调标志PLAY_ResetSourceBufFlag快放PLAY_Fast慢放PLAY_Slow暂停PLAY_Pause按帧号定位PLAY_SetCurrentFrameNum按时间定位PLAY_SetPlayedTimeEx按文件偏移定位PLAY_SetPlayPos刷新PLAY_RefreshPlayPLAY_RefreshPlayEx单帧播放PLAY_OneByOne单帧倒放PLAY_OneByOneBackPLAY_BackOne反向回放PLAY_Back抓图(写文件)PLAY_CatchPicPLAY_CatchPicExPLAY_CatchR
9、esizePic抓图(获取图片数据)PLAY_GetPicBMPPLAY_GetPicJPEG清缓冲PLAY_ResetBuffer颜色调整PLAY_SetColor多区域显示PLAY_SetDisplayRegion显示模式设置PLAY_SetDisplayType垂直同步使能PLAY_VerticalSyncEnable调整图象播放的流畅性PLAY_AdjustFluency改变图象播放的帧率PLAY_ChangeRate打开音频采集功能PLAY_OpenAudioRecord关闭音频采集功能PLAY_CloseAudioRecord获取颜色参数PLAY_GetColor获取关键色PLAY
10、_GetColorKey获取当前帧数PLAY_GetCurrentFrameNum获取当前帧率PLAY_GetCurrentFrameRate获取缓冲帧数PLAY_GetDisplayBuf获取显示类型PLAY_GetDisplayType获取当前时间PLAY_GetPlayedTimePLAY_GetPlayedTimeEx获取当前信息状态PLAY_QueryInfo获取总帧数PLAY_GetFileTotalFrames获取总时间PLAY_GetFileTime获取文件偏移PLAY_GetPlayPos获取索引信息PLAY_GetRefValue获取流剩余缓冲PLAY_GetSourceB
11、ufferRemain获取流打开模式PLAY_GetStreamOpenMode获取关键帧信息PLAY_GetKeyFramePosPLAY_GetNextKeyFramePos获取OVERLAY模式PLAY_GetOverlayMode获取图像大小PLAY_GetPictureSize获取已播放的桢数PLAY_GetPlayedFrames获取视频实时码率PLAY_GetRealFrameBitRate2.1.6 停止播放停止PLAY_Stop2.1.7 结束关闭创建的文件PLAY_DestroyFile关闭文件PLAY_CloseFile关闭创建的流PLAY_DestroyStream关闭
12、流PLAY_CloseStreamPLAY_CloseStreamEx释放多显卡资源PLAY_ReleaseDDrawDevice2.1.8 可随时调用的函数获取系统功能PLAY_GetCaps转BMP文件PLAY_ConvertToBmpFile获取文件头长度PLAY_GetFileHeadLength获取版本信息PLAY_GetSdkVersion2.2 编程补充说明 步骤A中的操作用于支持多显卡，目前播放库暂不支持，采用默认的显卡。 步骤B中的功能设置操作只能在PLAY_play之前设置一次。如果用户不调用这些函数，播放库会采用默认值，如播放缓冲帧数默认为15帧，默认用overlay显示
13、，默认流打开模式为最实时模式。 要使播放SDK能正常工作，步骤C和步骤D是必须的大部分操作集中在步骤E中，即在PLAY_Play和PLAY_ Stop之间调用。但其中播放声音的函数PLAY_PlaySound、PLAY_PlaySoundShare可以在PLAY_Play之前调用，以防止部分声音数据不能播放，这在播放一个纯音频文件时较为明显对D、E、F、G、H、I中的功能大部分之间没有调用先后顺序，当然对同一个功能还是应该按先打开再操作最后关闭的顺序。3 数据结构定义3.1 宏定义3.1.1 最大通道数#define FUNC_MAX_PORT 501 /最大播放通道数3.1.2 声音波形范围
14、#define MIN_WAVE_COEF -100#define MAX_WAVE_COEF 1003.1.3 定时器类型#define TIMER_11 /默认定时器，精确定时，但一个进程中最多只有16个#define TIMER_22 /不精确定时，个数据不限制3.1.4 缓冲类型#define BUF_VIDEO_SRC 1 /视频源缓冲#define BUF_AUDIO_SRC 2 /音频源缓冲#define BUF_VIDEO_RENDER 3 /解码后视频数据缓冲#define BUF_AUDIO_RENDER 4 /解码后音频数据缓冲注：BUF_VIDEO_SRC视频数据源缓冲，缓冲解码之前视频数据，只对流模式有效，单位byteBUF_AUDIO_SRC音频数据源缓冲，缓冲解码之前音频数据，只对流模式有效, 单位byt
