中国电信网络视频监控业务技术规范V3—客户端单元分册-V5.doc

中国电信网络视频监控业务中国电信网络视频监控业务中国电信网络视频监控业务中国电信网络视频监控业务中国电信网络视频监控业务中国电信网络视频监控业务 技术规范技术规范技术规范技术规范技术规范技术规范 V3 0 V3 0 V3 0 V3 0 V3 0 V3 0 客户端分册 送审客户端分册 送审客户端分册 送审客户端分册 送审客户端分册 送审客户端分册 送审稿 稿 稿 稿 稿 稿 中国电信集团公司中国电信集团公司 中国电信股份有限公司上海研究院中国电信股份有限公司上海研究院 20082008 年年 0404 月月 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 22 内部资料 注意保密 未经同意 请勿翻印内部资料 注意保密 未经同意 请勿翻印 文档信息文档信息 文档名称文档名称 文件编号文件编号 编编 制制 人人 保密级别保密级别 修改过程修改过程 版版 本本 号号日期日期作者作者概述概述 0 982007 04 13 电信上海 研究院 删除所有电信客户端内容 建议在网管客户端体现 0 982007 04 13 CU 讨论组平台信令需增加电子地图 经纬度信息设置和查询 以及电子地图的动态加载 机制 0 982007 04 14 CU 讨论组历史录像记录查询的返回 结果应根据 CU 与平台的定 义进行规范 评审过程评审过程 版本号版本号日期日期评审者评审者概述概述 V3 0 v52008 04 02 梁笃国提交 分发范围分发范围 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 11 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 22 目目 录录 1 1 适用范围适用范围 1 2 2 引用标准引用标准 1 3 3 定义和缩略语定义和缩略语 1 4 4 系统结构系统结构 1 5 5 CUCU 客户端系统客户端系统 1 5 1 CU 概述 1 5 2 CU 的组成 2 5 3 CU 分类 4 5 4 CU 实现方式要求 5 6 6 CUCU 功能要求功能要求 5 6 1 企业控制台 客户端 6 6 2 电信客户端 10 7 7 CUCU 性能要求性能要求 11 7 1 使用环境 11 7 2 外观 11 7 3 电磁兼容性 11 7 4 抗雷性 11 7 5 环境适应性 11 7 6 可靠性要求 12 8 8 软件的要求软件的要求 12 8 1 基本要求 12 8 2 软件设计要求 12 9 9 接口协议接口协议 13 9 1 集成应用二次开发接口规范 13 1 1 适用范围适用范围 1 2 2 引用标准引用标准 1 3 3 定义和缩略语定义和缩略语 1 4 4 系统结构系统结构 1 5 5 CUCU 客户端系统客户端系统 1 5 1 CU 概述 1 5 2 CU 的组成 2 5 3 CU 分类 4 5 4 CU 实现方式要求 5 6 6 CUCU 功能要求功能要求 5 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 33 6 1 企业控制台 客户端 6 6 2 电信客户端 10 7 7 CUCU 性能要求性能要求 11 7 1 使用环境 11 7 2 外观 11 7 3 电磁兼容性 11 7 4 抗雷性 11 7 5 环境适应性 11 7 6 可靠性要求 12 8 8 软件的要求软件的要求 12 8 1 基本要求 12 8 2 软件设计要求 12 9 9 接口协议接口协议 13 9 1 集成应用二次开发接口规范 13 1 1 适用范围适用范围 本规范规定了中国电信网络视频监控系统的客户端单元实现要求 包括客 户端的功能 性能指标 接口 传输的通信协议 以及子系统的和环境要求等 本规范主要适用于客户端子系统的开发设计 本标准起草单位 中国电信股份有限公司上海研究院 2 2 引用标准引用标准 参见 中国电信网络视频监控业务技术规范 V3 0 总体技术要求 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 22 3 3 定义和缩略语定义和缩略语 参见 中国电信网络视频监控业务技术规范 V3 0 总体技术要求 4 4 系统结构系统结构 参见 中国电信网络视频监控业务技术规范 V3 0 总体技术要求 5 5 CUCU 客户端系统客户端系统 5 1 5 1 CUCU 概述概述 CU 是系统的客户端单元 负责对系统功能对用户的集中呈现 人机交互 可实现监控中心及普通客户端等多种应用 在系统中 CU 所处位置如图 5 1 1 所示 前端单元 客客户户端端单单元元 视频转分发单元 客户端接入网关前端接入网关呼叫控制服务器 中心管理服务器 网络录像单元 AAACMS CCSPAGCAG VTDUNRU PUCU 中中心心服服务务平平台台 图 5 1 1 CU 在系统中的位置 CU 对前端设备的访问和控制信令都需要通过中心服务系统交互实现 CU 和 中心服务系统构成完整的服务器 客户应用架构 CU 作为客户端应用 5 2 5 2 CUCU 的组成的组成 CU 主要分为监控中心 普通客户端两种应用模式 监控中心由数字矩阵 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 33 软 硬件解码器 控制台等设备组成 利用数字矩阵实现的监控中心设备组成如图 5 2 1 所示 HITACHI 数字矩阵控制台 电视墙 图 5 2 1 监控中心设备 一 利用解码器实现的监控中心设备组成如图 5 2 2 所示 控制台 电视墙 ABCDEFGH SELECTED ON LINE ABCDEFGH SELECTED ON LINE ABCDEFGH SELECTED ON LINE ABCDEFGH SELECTED ON LINE ABCDEFGH SELECTED ON LINE ABCDEFGH SELECTED ON LINE ABCDEFGH SELECTED ON LINE ABCDEFGH SELECTED ON LINE 解码器 堆叠 图 5 2 2 监控中心设备 二 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 44 5 2 1 5 2 1 数字矩阵数字矩阵 数字矩阵可以将从网络接收到的视频解码 输出到一台或多台监视器上 并可实现多画面分割显示和视频拼接 单画面轮巡显示 多画面分组轮巡显示 一般通过在工控机中加装视频转换卡实现 输出接口为标准 BNC 接口或 RCA 接口 可通过控制台设置 控制数字矩阵 5 2 2 5 2 2 解码器解码器 解码器可以将从网络接收到的视频解码 输出到一台或多台监视器上 并 可实现多画面分割显示 单画面轮巡显示 多画面分割轮巡显示 一般通过嵌入式系统实现 输出接口为标准 BNC 接口或 RCA 接口 可通过控制台设置 控制各个解码器 5 2 3 5 2 3 控制台控制台 控制台由控制台软件实现 主要完成平台的接入 视频接收播放 报警信号 接收 联动 画面控制 系统设置 数字矩阵及解码器的控制等功能 5 2 4 5 2 4 客户端客户端 客户端由客户端软件实现 主要完成平台的接入 视频接收播放 报警信号 接收 联动 画面控制 系统设置等功能 5 3 5 3 CUCU 分类分类 CU 实现需提供下列客户端管理应用系统 1 企业客户端 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 55 针对电信全球眼业务客户使用 提供远程图象监控系统应用 包括提供电 视墙应用解决方案 包括 1 普通用户客户端 2 企业管理员客户端 2 电信客户端 针对电信运维部门使用 提供设备维护 添加 删除 划归 用户维护 权限分配 设备参数的设置和控制 系统维护以及网管等功能 5 4 5 4 CUCU 实现方式要求实现方式要求 1 跨操作系统平台的支持 要求应用系统必须支持 WINDOWS 平台用户 宜支持 LINUX 平台用户 2 模块化设计 系统采用模块化的结构设计思想 将数据业务 音视频数据 控制命令 报 警数据 可选电子地图 和应用逻辑 监控应用 分开 并提供二次开发插件 音视频控件 音视频软解压控件是整个软件设计的核心 它嵌入在客户端应用软件 中 应具备与中心服务 CMS VTDU 或直接与 PU 的图像监控数据接收 图 像显示 录像及云台控制 I O 监控等基本功能 并须向用户提供统一编程 接口 2 报警模块 业务报警的采集 比如 视频丢失报警 开关量报警 移动侦测报警 信号 3 电子地图 采用多图层 可伸缩 可平移的地图展示方式 3 支持 C S B S 两种企业客户端应用系统 企业 CU 客户端系统可以考虑提供 C S 结构的胖客户端系统 也可以考虑基 于 WEB 方式的客户端系统 基于 WEB 方式的客户端系统需要在中心服务端提供 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 66 相应的 WEB 服务应用 6 6 CUCU 功能要求功能要求 用于浏览和控制远端视频及系统的设备 企业客户端包括播放图像 云台 控制 录像检索 录像配置 报警联动 设备配置 用户登录 用户管理 电 视墙控制 日志察看等 6 1 6 1 企业企业控制台控制台 客户端客户端 企业 CU 客户端是面向业务客户的集中监控应用系统 主要功能有应 1 1 登录认证 提供登录验证界面 实现与平台 PAG 或 CCS 及 CMS 的交互后进入系 统 2 2 远程浏览 1 支持自动以树形结构将浏览的前端设备和摄影头排列出来 可以根 据业务 区域等进行分组 同时结合手工自由点播实时或历史画面 2 支持 1 4 6 9 16 等多种画面分割模式 以及全屏显示 要求 程序界面能够自适应屏幕显示分辨率 3 支持对音频的实时接收 可选择静音 打开音频 本地音量调节 4 支持多画面轮巡 即系统应具备视频自动巡视功能 在可设定的间 隔时间内对所有的监控点进行图像巡检 参与轮巡的对象可以任意 设定 包括不同监控点的图像 同一监控点内不同摄像机 同一摄 像机的不同预置位等 轮巡间隔时间可设置 5 支持本地字幕半透明叠加 且字幕位置可调 6 支持图象实时抓拍功能 7 支持本地实时录像功能 8 抓拍和录像路径可设置 9 提供实时码率显示功能 显示与关闭提供开关操作 10 可通过 web 方式监视即时画面并调阅录像资料 3 2 提供电子地图功能 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 77 1 支持多级电子地图 可选择矢量图 三维立体图或图片格式的地图 2 支持电子地图的伸缩 平移 分图层显示 3 图片格式的地图的方式支持客户自动上载更新图片 4 报警发生时 报警地点以醒目的标记闪烁在电子地图上 准确判断 报警类型和地点 4 2 远程控制 1 云台控制 上 下 左 右 包括自动巡航 预置位 灯光 雨刷 功能的支持 2 摄象机色度 亮度 饱和度 对比度的实时控制 3 镜头控制应包括变倍 调焦 应具有手动和自动调焦功能 光圈 应具有手动和自动光圈调节功能 4 镜头控制要求客户端在图像分屏和全屏显示状态下都可进行 5 3 报警信息的接收以及报警联动 1 支持报警信息的接收 报警信息经管理中心服务器转发 能够精确 的将报警信息传送到客户机 同时具备语音 图像 画面弹出 的 提示 并在本机生成报警日志 报警提示可根据设备一直发生作用 终止条件是操作人员人工进行干预 2 报警类别 可能包括消防报警 防盗报警 防火报警 门禁报警 非法闯入及画面异动报警 图像设备故障报警以及通过温度 湿度 探测器发出报警信息等 3 支持红外 光敏报警 当发生报警时 监控中心能自动进行存盘录 像 并自动在地理图上提示报警位置及类型 4 当发生报警时 能联动多路相关设备 如临近摄像头 启动现场照 明 警笛等 且联动策略可按不同时段独立设定 5 报警信息应该和录像数据相结合 可由报警信息检索回放相应的图 像录像 6 支持报警信息的查询 并提供报警信息查询和浏览窗口 7 支持开关量 移动侦测的布防 撤防的设置 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 88 8 画面移动侦测报警的参数可设置 9 支持联动策略的配置 支持联动输出报警设备 灯光打开 录像开 启 10 对移动目标具有自动跟踪功能 该功能应能随时启动关闭 可 选 6 4 支持录像控制 1 支持前端录像 中心录像 本地录像三种录像存储方式 2 支持手动 定时 周期录像 3 录像的远程检索回放 下载本地回放 4 可依输入时间 地点直接搜寻历史录像 并可实现快进 快退 单 帧放 慢放 暂停等功能 5 客户端的录像资料支持通用播放软件播放 RealPlayer 或 MediaPlayer 7 5 远程操作 对指定的远端 PU 进行远程操作 如 PU 的参数设置 通道参数的设 置 串口参数的配置 报警参数的设置和查询 字母叠加设置 字 母位置调节 8 6 系统功能 1 支持键盘快捷键云台控制 建议 快捷键快捷键功能功能 TAB 焦点视频窗口切换 空格焦点视频窗口最大化 回复切换 方向键焦点摄像头云台转动 Home End 焦点摄像头镜头放大 缩小 F11 全屏 锁定系统功能 锁定系统 就是将系统控制权限降为最低 使当前系统处于锁 定状态 只提供最基本的监视功能 包括禁用关闭系统 解除锁定 在锁定系统后 要重新恢复对系统的控制权 必须 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 99 首先解除锁定 3 在线升级 客户端软件需提供新版本提示及在线升级 4 系统日志 支持系统日志的查询 并提供当前系统日志的查询和浏览窗口 9 7 与 PU 双向语音交流 能与自己权限许可的前端设备之间进行双向的实时语音对讲 同时具有对 前端设备分组进行语音广播 10 8 辅助功能 可选 1 操作杆功能 2 辅助键盘控制 11 9 电视墙的控制 可选 电视墙是由多个监视器组成的 每个监视器对应一路视频输出 比如对应 一个解码器的视频输出 这些关系是固定的 可以从 PU 列表中把某个 PU 拖 到电视墙上 并能对这个 PU 的图像控制 如开始播放和停止播放 还可以控制 该 PU 的云镜 支持手动调看 序列切换 群组序列调看 群组序列切换功能 1 通过中文名称列表方式或电子地图图标方式手动在任意监视器上切 换系统中任一个摄像机图像 2 在任一个监视器上调用任一个序列进行自动切换显示 3 在多个监视器一次性同时调看任一个编组序列的所有摄像机图像 4 将多个编组序列同时在多个监视器上进行群组的自动切换显示 5 切换间隔时间可调 12 10 多画面合成的控制 可选 支持对用户选择的多个 PU 视频流合成包括多个画面的一路视频流 13 11 解码器 解码矩阵的管理功能 可选 1 对中心一个或多个解码器 解码矩阵的配置管理 其 IP 地址 通道 数 每个通道对应的默认的显示图象的 IP 地址 通道号配置信息 的存储 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1010 2 每个解码器通道对应的电视墙信息的存储 3 每个监视器可显示多个通道的信息 IP 配置管理 4 是否轮跳配置管理 轮跳策略 5 可设定每个解码器 解码矩阵报警时输出图象的通道 当收到报警 联动输出信息时将指定图象在设定的通道输出 6 可设定每个解码器 解码矩阵音频的通道选择和控制 7 将网络中任意若干个摄像机编组成若干个切换序列 14 12 客户自助管理 可由客户管理员自助进行相应的管理如 配置管理 权限管理 操作员管 理 告警管理 日志管理等 15 13 图像辨识功能 可选 通过图像辨识处理实现行业的智能辨识需要 如交通系统和交警系统需要 的车牌辨识功能 6 2 6 2 电信客户端电信客户端 电信客户端是电信运维部门实施业务开通 设备管理以及权限管理的系统 为业务开展提供支持平台 1 1 设备管理 1 监控设备的系统添加维护管理操作界面 2 支持设备状态的查询 并提供系统设备 如前端 状态浏览 参数 设置 初始化等操作界面 3 支持平台间设备划归 2 用户管理 1 用户组的维护 可以实现一个企业的多个用户为一个组 2 负责客户用户的受理 使用情况的统计 3 提供用户帐号 口令等控制界面 4 提供多级区域 机构的设置界面 3 3 权限设置 1 用户 用户组可访问的设备的列表信息维护 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1111 2 用户 用户组相应的控制操作权限设置界面 4 4 业务开通 提供开户 禁用 启用 注销等业务开通管理 5 5 系统维护 1 系统日志管理 2 对中心各功能服务运行状态的监控 3 前端设备的状态管理 6 6 巡检与校时 1 定时对前端设备进行巡检 当设备有故障时 断线 无视频 产 生告警信息 2 可以统一对系统中的设备进行校时 7 7 平台注册 对有跨平台访问的平台的信息注册 7 7 CUCU 性能要求性能要求 CU 的控制台 客户端 解码器及数字矩阵必须达到如下性能要 iu1 7 1 7 1 使用环境使用环境 工作温度要求为 0 50 范围内 相对湿度要求在 10 90 内 7 2 7 2 外观外观 按照中国电信 2 0 测试规范要求 7 3 7 3 电磁兼容性电磁兼容性 符合我国电磁兼容标准 GB 3907 1983 符合 class A 级别 7 4 7 4 抗雷性抗雷性 7 4 1 7 4 1 防雷设计方案防雷设计方案 为增强电源的防雷击效果 需要在 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1212 电源的输入前端加入电源避雷器 这样可大大增强电源的抗雷击能力 7 4 2 7 4 2 接地设计方案接地设计方案 保证设备用接地线与大地保持良好接触 保证交流电源插座的中性线与大地 良好接触 7 5 7 5 环境适应性环境适应性 交流电源电压标称值为 220 V 频率标称值为50 Hz 电压在187 V 253 V 范 围内波动 频率在 47 5 Hz 52 5 Hz 范围内波动时 设备应能正常工作 7 6 7 6 可靠性要求可靠性要求 应该满足 5 个 9 的要求 达到 99 999 8 8 软件的要求软件的要求 8 1 8 1 基本要求基本要求 1 要求软件采用分层的模块化结构 模块之间的通信应按规定接口进行 任何一层的任何一个模块的维护和更新以及新模块的追加都不影响其 它模块 2 系统参数 用户资料与处理程序应有相对的独立性 用户资料的任何 变更都不应引起运行版本程序的变更 处理程序应与系统参数 用户 资料相适应 3 软件应有容错能力 一般的软件故障不应引起各类严重的系统再激活 4 软件设计应有防护性能 某一软件模块内的软件错误应限制在本模块 内 而不应造成其它软件模块的错误 5 应具有软件运行故障的监视功能 一旦软件出现死循环等重大故障 应能自动再激活 并能出实时故障报告信息 6 系统中所有涉及到时间的信息和资料其年份部分采用带纪元表示法 7 软件具有详细 完善 灵活 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1313 的业务 用户等资料的统计 分析 预测能力 8 2 8 2 软件设计要求软件设计要求 1 应用软件应采用分层次的体系结构 以便于系统的维护和扩展 2 应用软件应能根据用户规模的不同支持集中处理模式和分布式处理 3 应用软件应具有很好的开放性 以便于与其它应用系统的连接 系统应 提供完整的二次开发工具及使用说明 便于进行客户化工作 4 应用软件应具有很好的可移植性 支持多种操作系统 并能移植到不同 厂家的硬件平台上运行 5 系统的运行应是安全 可靠的 具备完善的 分级的操作 访问权限控 制 6 系统应具有资料备份及灾难恢复功能 9 9 接口协议接口协议 9 1 9 1 集成应用二次开发接口规范集成应用二次开发接口规范 9 1 1 9 1 1 接口规范目标接口规范目标 要求提供标准的客户端二次开发控件 便于第三方的二次开发 9 1 2 9 1 2 接口原则接口原则 插件封装 CU 与 VTDU 音视频数据请求和回应接口 同时可以封装 CU 预 CMS 的控制命令接口 接口使对外提供调用的方法 使用的属性以及事件 9 1 3 9 1 3 接口规范接口规范 9 1 3 1 9 1 3 1 客户端插件功能需求客户端插件功能需求 控件基本要求 控件基本要求 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1414 控件可以在同一个程序中进行多个实例化 控件可以初始化 自动销毁销毁 并支持多线程调用 控件可以通过认证登录到平台服务器 控件可以根据用户权限获取视频列表 以及分组信息 控件能够支持动态获取视频点的情况 如设备上线或者下线等情况 控件能够支持动态获取告警信息 实时流模式的功能要求 实时流模式的功能要求 在指定的窗口中播放实时视频 视频播放可以暂停 暂停时窗口要保持为当时的帧图像 取消暂停后要能继续播放当前的实时视频 要丢掉暂停时没有观看的帧 清除播放缓冲区中的数据 以改善播放迟时 把当前帧以 BMP 或 JPEG 文件格式保存 在播放过程中 打开或关闭声音 并支持双向语音功能 同时播多个 图像时 可以同时播放声音 关闭视频播放 录像功能要求 录像功能要求 能够进行本地录像 录像时候 可以播放视频 也可以不播放 录像格式可以直接用 MediaPlay 进行播放或者点播 推荐使用 ASF 格 式 文件播放模式的功能要求 文件播放模式的功能要求 在指定的窗口中播放视频文件 视频播放可以暂停 暂停时窗口要保持为当时的帧图像 取消暂停后要能继续播放当前的视频文件 查询当前播放的位置 第几帧 设置当前播放的位置 第几帧 查询文件的总长度 多少帧 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1515 支持 1 2 1 4 1 8 1 16 每秒一帧 五种慢放功能 可以支持向前或向后两种回放方向 支持 2 4 8 16 四种快放功能 可以把当前帧以 BMP 或 JPEG 文件格式保存 在播放过程中 打开或关闭声音 同时播多个图像时 可以同时播放 声音 9 1 3 2 9 1 3 2 音视频插件接口定义音视频插件接口定义 9 3 3 2 19 3 3 2 1 插件初始化插件初始化 HRESULTHRESULT Initialize Initialize 功能描述功能描述 初始化插件资源 参数说明参数说明 无参数 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 29 3 3 2 2 插件插件反初始化反初始化 HRESULTHRESULT Uninitialize Uninitialize 功能描述功能描述 释放插件资源 参数说明参数说明 无参数 返回说明返回说明 执行成功返回 0 错误时返回错误码 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1616 9 3 3 2 39 3 3 2 3 打开文件播放模式打开文件播放模式 HRESULTHRESULT OpenFile long OpenFile long phHandle phHandle BSTRBSTR strFileName strFileName longlong lPos lPos longlong hWnd hWnd 功能描述功能描述 打开文件播放模式 参数说明参数说明 phHandle 用于接收返回播放句柄的地址 strFileName 要播放的文件名 绝对路径 文件大小不能超过 4G 或小于 4K lPos 播放位置 百分数 为 0 100 之间的整数 hWnd 窗口句柄 不允许为空 返回说明返回说明 执行成功返回 0 phHandle 保存解码资源的句柄 错误时返回错误码 9 3 3 2 49 3 3 2 4 关闭文件播放模式关闭文件播放模式 HRESULTHRESULT CloseFile longCloseFile long hHandle hHandle 功能描述功能描述 关闭文件播放模式 参数说明参数说明 hHandle 要关闭的播放句柄 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 59 3 3 2 5 打开打开 URLURL 播放模式播放模式 HRESULTHRESULT OpenUrl long OpenUrl long phHandle phHandle BSTRBSTR strUrl strUrl longlong lPos lPos longlong hWnd hWnd BSTRBSTR strFileName strFileName 功能描述功能描述 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1717 打开URL播放模式 参数说明参数说明 phHandle 用于接收返回播放句柄的地址 strUrl 要播放的 URL lPos 播放位置 百分数 为 0 100 之间的整数 hWnd 窗口句柄 为空表示直接下载 strFileName 保存文件的绝对路径 带 asf扩展名 文件格式 ASF格式 返回说明返回说明 执行成功返回 0 phHandle 保存解码资源的句柄 错误时返回错误码 9 3 3 2 69 3 3 2 6 关闭关闭 URLURL 播放模式播放模式 HRESULTHRESULT CloseUrl longCloseUrl long hHandle hHandle 功能描述功能描述 关闭URL播放模式 参数说明参数说明 hHandle 要关闭的播放句柄 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 79 3 3 2 7 打开流播放模式打开流播放模式 HRESULTHRESULT OpenStream long OpenStream long phHandle phHandle BSTRBSTR strRemoteIP strRemoteIP longlong lRemotePort lRemotePort longlong lNetType lNetType longlong lPacketType lPacketType longlong hWnd hWnd BSTRBSTR strFileName strFileName 功能描述功能描述 打开流播放模式 参数说明参数说明 phHandle 要打开的播放句柄 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1818 strRemoteIP 远端 IP 地址 lRemotePort 远端 IP 端口 lNetType 0 UDP 1 TCP 2 Multicast lPacketType 0 RTP 1 TS hWnd 窗口句柄 为空表示直接下载 strFileName 保存文件的绝对路径 带 asf扩展名 文件格式 ASF格式 返回说明返回说明 执行成功返回 0 phHandle 保存解码资源的句柄 错误时返回错误码 播放视频画面大小将根据 hWnd 窗口调整 要全屏显示 只要把 hWnd 窗口 放大到全屏 9 3 3 2 89 3 3 2 8 关闭流播放模式关闭流播放模式 HRESULTHRESULT CloseStream longCloseStream long hHandle hHandle 功能描述功能描述 关闭流播放模式 参数说明参数说明 hHandle 要关闭的播放句柄 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 9 3 3 2 9 9 开始音频发送开始音频发送 HRESULTHRESULT StartAudio long StartAudio long phHandle phHandle BSTRBSTR strRemoteIP strRemoteIP longlong lRemotePort lRemotePort longlong lNetType lNetType longlong lPacketType lPacketType 功能描述功能描述 开始音频编码 并发送给对方 参数说明参数说明 phHandle 要打开的音频发送句柄 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 1919 strRemoteIP 远端 IP 地址 lRemotePort 远端 IP 端口 lNetType 0 UDP 1 TCP 2 Multicast lPacketType 0 RTP 1 TS 返回说明返回说明 执行成功返回 0 错误时返回错误码 与OpenStream配合 可实现双向语音对讲 9 3 3 2 109 3 3 2 10 停止停止音频发送音频发送 HRESULTHRESULT StopAudio longStopAudio long hHandle hHandle 功能描述功能描述 停止发送声音 停止音频编码 参数说明参数说明 hHandle 播放句柄 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 119 3 3 2 11 设置音量大小设置音量大小 HRESULTHRESULT SetVolume longSetVolume long hHandle hHandle longlong lVolume lVolume boolbool bCapture bCapture 功能描述功能描述 设置音量大小 参数说明参数说明 hHandle 播放句柄 lVolume 音量的值 范围 0 0XFFFF bCapture 播放音量或采集音量 返回说明返回说明 执行成功返回 0 错误时返回错误码 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 2020 9 3 3 2 129 3 3 2 12 开始播放实时视频开始播放实时视频 HRESULTHRESULT Play longPlay long hHandle hHandle 功能描述功能描述 开始播放实时视频 参数说明参数说明 hHandle 播放句柄 hWnd 播放视频的窗口句柄 返回说明返回说明 执行成功返回 0 错误时返回错误码 如果已经播放 只是改变当前播放速度为正常速度 9 3 3 2 139 3 3 2 13 停止播放停止播放 HRESULTHRESULT Stop longStop long hHandle hHandle 功能描述功能描述 停止播放 参数说明参数说明 hHandle 播放句柄 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 149 3 3 2 14 暂停播放暂停播放 HRESULTHRESULT Pause longPause long hHandle hHandle longlong lPause lPause 功能描述功能描述 暂停播放 参数说明参数说明 hHandle 播放句柄 lPause lPause TRUE暂停 否则恢复播放 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 2121 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 159 3 3 2 15 刷新显示区域刷新显示区域 HRESULTHRESULT RefreshSurface longRefreshSurface long hHandle hHandle 可删除可删除 功能描述功能描述 刷新显示区域 参数说明参数说明 hHandle 播放句柄 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 169 3 3 2 16 读取播放位置读取播放位置 HRESULTHRESULT GetPlayPos longGetPlayPos long hHandle hHandle long long pPos pPos 功能描述功能描述 读取播放位置 参数说明参数说明 hHandle 播放句柄 pPos 播放位置 百分数 为 0 100 之间的整数 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 179 3 3 2 17 设置播放位置设置播放位置 HRESULTHRESULT SetPlayPos longSetPlayPos long hHandle hHandle longlong lPos lPos 功能描述功能描述 设置播放位置 参数说明参数说明 hHandle 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 2222 播放句柄 lPos 播放位置 百分数 为 0 100 之间的整数 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 189 3 3 2 18 设置回放方向设置回放方向 HRESULTHRESULT SetPlayDirection longSetPlayDirection long lDirection lDirection 功能描述功能描述 设置回放方向 参数说明参数说明 lDirection 回放方向 1 表示向前 0 表示向后 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 199 3 3 2 19 快速播放快速播放 HRESULTHRESULT Fast longFast long hHandle hHandle longlong lSpeed lSpeed 功能描述功能描述 快速播放速度调节 参数说明参数说明 hHandle 播放句柄 lSpeed 加快倍速 1 1x 2 2x 4 4x 8 8x 16 16x 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 209 3 3 2 20 慢速播放慢速播放 HRESULTHRESULT Slow longSlow long hHandle hHandle longlong lSpeed lSpeed 功能描述功能描述 慢速播放速度调节 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 2323 参数说明参数说明 hHandle 播放句柄 lSpeed 减慢倍速 1 1x 2 2x 4 4x 8 8x 16 16x 0 为单帧播放 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 219 3 3 2 21 文字合成文字合成 HRESULTHRESULT OverlayText longOverlayText long hHandle hHandle longlong lPointX lPointX longlong lPointY lPointY longlong lColor lColor longlong lAlpha lAlpha BSTRBSTR strText strText 功能描述功能描述 将文字合成到视频上 参数说明参数说明 hHandle 播放句柄 lPointX X轴坐标 单位 象素 lPointY Y轴坐标 单位 象素 lColor 文本颜色 RGB lAlpha 透明度 0 100 strText 需要参与合成的文字 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 229 3 3 2 22 清除文字合成清除文字合成 HRESULTHRESULT ClearOverlayText longClearOverlayText long hHandle hHandle BSTRBSTR strText strText 功能描述功能描述 清除显示的文字 参数说明参数说明 hHandle 播放句柄 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 2424 strText 被清除的文字 空字符串表示清除所有 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 239 3 3 2 23 开始录像开始录像 HRESULTHRESULT StartRecord longStartRecord long hHandle hHandle BSTRBSTR strFileName strFileName 功能描述功能描述 本地录像开始 参数说明参数说明 hHandle 播放句柄 strFileName 录像文件的绝对路径 带 asf扩展名 文件格式 ASF格式 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 249 3 3 2 24 停止录像停止录像 HRESULTHRESULT StopRecord longStopRecord long hHandle hHandle 功能描述功能描述 本地录像停止 参数说明参数说明 hHandle 播放句柄 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 259 3 3 2 25 抓屏抓屏 HRESULTHRESULT CapPic longCapPic long hHandle hHandle BSTRBSTR strFileName strFileName longlong lPicType lPicType 功能描述功能描述 抓取当前帧存储为 BMP JPEG 图片 参数说明参数说明 hHandle 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 2525 播放句柄 strFileName 图像文件的绝对路径 BMP带 bmp扩展名 JPEG带 jpg扩展名 lPicType 0 BMP 1 JPEG 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 269 3 3 2 26 读取流信息读取流信息 HRESULTHRESULT GetStreamInfo longGetStreamInfo long hHandle hHandle long long lBitRate lBitRate long long lLostRate lLostRate long long lFrameRate lFrameRate BSTR BSTR strVideo strVideo BSTR BSTR strAudio strAudio long long lWidth lWidth long long lHeight lHeight 功能描述功能描述 读取流信息 参数说明参数说明 hHandle 播放句柄 lBitRate 当前流码率 单位 bps lLostRate 当前丢包率 为实际丢包率 10000 返回 lFrameRate 当前视频帧率 strVideo 视频编码格式 如 MPEG4 H 264 strAudio 音频编码格式 如 G 711 A G 722 lWidth 视频帧宽度 CIF 为 352 lHeight 视频帧高度 CIF 为 288 返回说明返回说明 执行成功返回 0 错误时返回错误码 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 2626 9 3 3 2 279 3 3 2 27 读取版本读取版本信息信息 HRESULTHRESULT GetVersion BSTR GetVersion BSTR strVersion strVersion 功能描述功能描述 读取版本信息 参数说明参数说明 strVersion 格式 W X Y Z YYYY MM DD 版本文字描述可选 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 289 3 3 2 28 读取参数读取参数 HRESULTHRESULT GetParameter longGetParameter long hHandle hHandle longlong lType lType long long pPara1 pPara1 long long pPara2 pPara2 功能描述功能描述 读取参数 参数说明参数说明 hHandle 播放句柄 lType 参数类型 网络缓冲时间 0 60 秒 是否将播放窗口置于最上 层 lPara1 参数 1 lPara2 参数 2 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 299 3 3 2 29 设置参数设置参数 HRESULTHRESULT SetParameter SetParameter longlong hHandle hHandle longlong lType lType longlong lPara1 lPara1 longlong lPara2lPara2 功能描述功能描述 设置参数 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 2727 参数说明参数说明 hHandle 播放句柄 lType 参数类型 网络缓冲时间 0 60 秒 是否将播放窗口置于最上 层 lPara1 参数 1 lPara2 参数 2 返回说明返回说明 执行成功返回 0 错误时返回错误码 9 3 3 2 309 3 3 2 30 设置消息接收窗口设置消息接收窗口 HRESULTHRESULT SetMsgWnd longSetMsgWnd long hHandle hHandle longlong hWnd hWnd 功能描述功能描述 设置消息接收窗口 参数说明参数说明 hHandle 播放句柄 hWnd 窗口句柄 返回说明返回说明 执行成功返回 0 错误时返回错误码 消息定义 0 x0801回放结束通知消息 0 x0802实时流中断消息 0 x0803下载进度通知消息 每下载 1 通知一次 9 3 3 2 319 3 3 2 31 设置显示回调函数设置显示回调函数 HRESULTHRESULT SetDisplayCallBack longSetDisplayCallBack long hHandle hHandle long stdcall long stdcall pDisplayCallBackpDisplayCallBack long long pBuffer pBuffer longlong lLength lLength longlong lWidth lWidth longlong lHeight lHeight longlong nTimeStamp nTimeStamp longlong lColorSpace lColorSpace 功能描述功能描述 设置显示回调函数 中国电信网络视频监控业务技术规范 V3 0 客户端 CU 分册 中国电信集团公司 2828 参数说明参数说明 hHandle 播放句柄 pDisplayCallBack 显示回调函数 pBuffer 视频数据缓冲参数 lLength 视频数据缓冲参数长度 lWidth 显示宽度 lHeight 显示高度 lTimeStamp 视频数据时间戳 lColorSpace 颜色空间类型 0 I420 1 RGB24 2 RGB32