大华播放SDK开发手册Word文档格式.docx
- 文档编号:13026445
- 上传时间:2022-10-02
- 格式:DOCX
- 页数:96
- 大小:106.90KB
大华播放SDK开发手册Word文档格式.docx
《大华播放SDK开发手册Word文档格式.docx》由会员分享,可在线阅读,更多相关《大华播放SDK开发手册Word文档格式.docx(96页珍藏版)》请在冰豆网上搜索。
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_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
获取视频实时码率
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
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 大华 播放 SDK 开发 手册