大华播放SDK开发手册.docx
《大华播放SDK开发手册.docx》由会员分享，可在线阅读，更多相关《大华播放SDK开发手册.docx（96页珍藏版）》请在冰豆网上搜索。
大华播放SDK编程手册
VERSION3.28.2（Build100129）
2010-01-29
版权所有侵权必究
前言
非常感谢您使用我们公司的设备，我们将为您提供最好的服务。
本手册可能包含技术上不准确的地方或印刷错误，欢迎指正。
我们将会定期更新手册的内容。
修订记录
日期
修订内容
修订者
2010-1-29
添加接口：
PLAY_SetFileRefCallBackEx
PLAY_GetRealFrameBitRate
金志贤
2010-1-22
添加接口:
PLAY_SetVisibleDecCallBack;
PLAY_CatchResizePic
金志贤
2009-10-26
添加接口说明：
PLAY_GetFreePort,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概述
播放SDK是大华压缩卡和硬盘录像机的配套产品，支持大华所有码流格式以及海思公司的h264码流和ADI的h264码流。
本文档详细描述了开发包中各函数实现的功能及接口
播放SDK的主要功能有：
支持文件或流数据的播放、回放控制（如暂停\恢复、快放慢放）、音频控制、流数据录像、多区域显示、按帧序号或按时间定位、数据回调、消息回调、字符叠加、抓图…….
开发包中包括的文件有:
、、、底层mpeg4解码库（）、底层h264解码库（解大华的h264码流和ADI公司的码流）和海思的h264解码库，包括、、。
1.2适用性
v支持大华所有码流以及ADI的h264码流和海思的h264码流的解码
v支持HB、HBE、LB、LBE、GB、GBE、NVS机型码流设计原则
2设计原则
2.1典型调用
2.1.1多显卡初始化
初始化多显卡设备
PLAY_InitDDrawDevice
获取显卡数目
PLAY_GetDDrawDeviceTotalNums
设置播放窗口使用的显卡
PLAY_SetDDrawDevice
获取显卡信息
PLAY_GetDDrawDeviceInfo
获取显卡功能
PLAY_GetCapsEx
关闭多显卡设备
PLAY_RealeseDDraw
2.1.2回调及功能设置
设置文件结束消息回调
PLAY_SetFileEndMsg
设置文件结束函数回调
PLAY_SetFileEndCallBack
设置图像格式改变消息回调
PLAY_SetEncChangeMsg
设置图像格式改变函数回调
PLAY_SetEncTypeChangeCallBack
设置文件索引建立后回调
PLAY_SetFileRefCallBack
设置流缓冲小于阀值回调
PLAY_SetSourceBufCallBack
设置数据解码回调
PLAY_SetDecCallBack
PLAY_SetDecCallBackEx
设置数据解码回调同时显示视频
PLAY_SetVisibleDecCallBack
设置视频解码回调
PLAY_SetDisplayCallBack
设置音频解码回调
PLAY_SetAudioCallBack
设置水印数据回调
PLAY_SetVerifyCallBack
设置分析数据回调
PLAY_SetDemuxCallBack
设置文件索引
PLAY_SetRefValue
设置播放缓冲帧数
PLAY_SetDisplayBuf
设置overlay模式及关键色
PLAY_SetOverlayMode
设置流打开模式
PLAY_SetStreamOpenMode
设置定时器类型
PLAY_SetTimerType
设置水印数据回调
PLAY_SetWaterMarkCallBack
2.1.3打开文件或数据流
创建文件
PLAY_CreateFile
打开文件
PLAY_OpenFile
创建流文件
PLAY_CreateStream
打开流
PLAY_OpenStream
PLAY_OpenStreamEx
2.1.4播放
播放开始
PLAY_Play
2.1.5各功能操作及信息获取
播放声音
PLAY_PlaySound
PLAY_PlaySoundShare
设置音量
PLAY_SetVolume
获取音量
PLAY_GetVolume
关闭声音
PLAY_StopSound
PLAY_StopSoundShare
开始流数据录像
PLAY_StartDataRecord
获取空闲的通道号
PLAY_GetFreePort
释放通道号
PLAY_ReleasePort
输入流数据
PLAY_InputData
PLAY_InputVideoData
PLAY_InputAudioData
结束流数据录像
PLAY_StopDataRecord
重置流缓冲回调标志
PLAY_ResetSourceBufFlag
快放
PLAY_Fast
慢放
PLAY_Slow
暂停
PLAY_Pause
按帧号定位
PLAY_SetCurrentFrameNum
按时间定位
PLAY_SetPlayedTimeEx
按文件偏移定位
PLAY_SetPlayPos
刷新
PLAY_RefreshPlay
PLAY_RefreshPlayEx
单帧播放
PLAY_OneByOne
单帧倒放
PLAY_OneByOneBack
PLAY_BackOne
反向回放
PLAY_Back
抓图（写文件）
PLAY_CatchPic
PLAY_CatchPicEx
PLAY_CatchResizePic
抓图（获取图片数据）
PLAY_GetPicBMP
PLAY_GetPicJPEG
清缓冲
PLAY_ResetBuffer
颜色调整
PLAY_SetColor
多区域显示
PLAY_SetDisplayRegion
显示模式设置
PLAY_SetDisplayType
垂直同步使能
PLAY_VerticalSyncEnable
调整图象播放的流畅性
PLAY_AdjustFluency
改变图象播放的帧率
PLAY_ChangeRate
打开音频采集功能
PLAY_OpenAudioRecord
关闭音频采集功能
PLAY_CloseAudioRecord
获取颜色参数
PLAY_GetColor
获取关键色
PLAY_GetColorKey
获取当前帧数
PLAY_GetCurrentFrameNum
获取当前帧率
PLAY_GetCurrentFrameRate
获取缓冲帧数
PLAY_GetDisplayBuf
获取显示类型
PLAY_GetDisplayType
获取当前时间
PLAY_GetPlayedTime
PLAY_GetPlayedTimeEx
获取当前信息状态
PLAY_QueryInfo
获取总帧数
PLAY_GetFileTotalFrames
获取总时间
PLAY_GetFileTime
获取文件偏移
PLAY_GetPlayPos
获取索引信息
PLAY_GetRefValue
获取流剩余缓冲
PLAY_GetSourceBufferRemain
获取流打开模式
PLAY_GetStreamOpenMode
获取关键帧信息
PLAY_GetKeyFramePos
PLAY_GetNextKeyFramePos
获取OVERLAY模式
PLAY_GetOverlayMode
获取图像大小
PLAY_GetPictureSize
获取已播放的桢数
PLAY_GetPlayedFrames
获取视频实时码率
PLAY_GetRealFrameBitRate
2.1.6停止
播放停止
PLAY_Stop
2.1.7结束
关闭创建的文件
PLAY_DestroyFile
关闭文件
PLAY_CloseFile
关闭创建的流
PLAY_DestroyStream
关闭流
PLAY_CloseStream
PLAY_CloseStreamEx
释放多显卡资源
PLAY_ReleaseDDrawDevice
2.1.8可随时调用的函数
获取系统功能
PLAY_GetCaps
转BMP文件
PLAY_ConvertToBmpFile
获取文件头长度
PLAY_GetFileHeadLength
获取版本信息
PLAY_GetSdkVersion
2.2编程补充说明
Ø步骤A中的操作用于支持多显卡，目前播放库暂不支持，采用默认的显卡。
Ø步骤B中的功能设置操作只能在PLAY_play之前设置一次。
如果用户不调用这些函数，播放库会采用默认值，如播放缓冲帧数默认为15帧，默认用overlay显示，默认流打开模式为最实时模式。
Ø要使播放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最大通道数
#defineFUNC_MAX_PORT 501//最大播放通道数
3.1.2声音波形范围
#defineMIN_WAVE_COEF -100
#defineMAX_WAVE_COEF 100
3.1.3定时器类型
#defineTIMER_1 1 //默认定时器，精确定时，但一个进程中最多只有16个
#defineTIMER_2 2 //不精确定时，个数据不限制
3.1.4缓冲类型
#defineBUF_VIDEO_SRC 1 //视频源缓冲
#defineBUF_AUDIO_SRC 2 //音频源缓冲
#defineBUF_VIDEO_RENDER 3 //解码后视频数据缓冲
#defineBUF_AUDIO_RENDER 4 //解码后音频数据缓冲
注：
BUF_VIDEO_SRC
视频数据源缓冲，缓冲解码之前视频数据，只对流模式有效，单位byte
BUF_AUDIO_SRC
音频数据源缓冲，缓冲解码之前音频数据，只对流模式有效,单位byt
升级会员 