中国电信网络视频监控业务技术规范（V3.0）—客户端单元（CU）分册

中中中国国国电电电信信信网网网络络络视视视频频频监监监控控控业业业务务务 技技技术术术规规范范 VVV333...000 客客客户户户端端端单单单元元元（（（CCCUUU）））分分分册册册（（（征征征求求求意意意见见见稿稿稿））） 中国电信股份有限公司上海研究院 2007 年 9 月 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 0 页 内部资料，注意保密，未经同意，请勿翻印 文档信息 文档名称 文件编号 编 制 人 保密级别 修改过程 版 本 号 日期 作者 概述 0.98 2007-04-13 电信上海 研究院 删除所有电信客户端内容， 建议在网管客户端体现。 0.98 2007-04-13 CU 讨论组 平台信令需增加电子地图 经纬度信息设置和查询，以 及电子地图的动态加载机 制。 0.98 2007-04-14 CU 讨论组 历史录像记录查询的返回 结果应根据 CU 与平台的 定义进行规范 评审过程 版本号 日期 评审者 概述 分发范围 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 1 页 目 录 1. 适用范围 ........................................................................................................................................3 2. 引用 ........................................................................................................................................3 3. 定义和缩略语 ................................................................................................................................3 4. 系统结构 ........................................................................................................................................3 5. CU 客户端系统 ...............................................................................................................................3 5.1 CU 概述 ........................................................................................................................................3 5.2 CU 在系统中的位置 ...................................................................................错误！未定义书签。 5.3 CU 的组成 .....................................................................................................................................4 5.4 CU 应用架构 ................................................................................................................................6 5.5 CU 应用分类 ................................................................................................................................6 5.4 CU 实现方式要求 ........................................................................................................................7 6. CU 功能要求..................................................................................................................................7 6.1 企业客户端 ...................................................................................................................................8 6.2 电信客户端 .................................................................................................................................12 7. CU 性能要求 .................................................................................................................................13 7.1 网络延迟.....................................................................................................错误！未定义书签。 7.2 使用环境.....................................................................................................................................13 7.3 外观.............................................................................................................................................13 7.4 电磁兼容性.................................................................................................................................13 7.5 抗雷性.........................................................................................................................................13 7.5.1 防雷......................................................................................................................13 7.5.2 接地设计方案......................................................................................................................13 7.6 环境适应性.................................................................................................................................13 7.7 可靠性要求.................................................................................................................................14 7.8 结构要求.....................................................................................................错误！未定义书签。 8. 软件的要求 ..................................................................................................................................14 8.1 基本要求 .....................................................................................................................................14 8.2 软件设计要求 .............................................................................................................................14 9. 接口协议 ......................................................................................................................................15 9.1 接口通信协议结构.....................................................................................................................15 9.1.1 Message Header: .................................................................................错误！未定义书签。 9.1.2Message: ...............................................................................................错误！未定义书签。 9.1.3Information Element(IE):......................................................................错误！未定义书签。 9.1.4 IE 结构的基本数据类型定义 .............................................................错误！未定义书签。 9.2 CU 与 VTDU 的通信协议 .........................................................................................................15 9.3 集成应用二次开发接口规范 .....................................................................................................15 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 2 页 9.3.1 接口规范目标.....................................................................................................................15 9.3.2 接口原则 ............................................................................................................................15 9.3.3 接口规范 ............................................................................................................................16 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 3 页 1. 适用范围 本规范规定了中国电信网络视频监控系统的客户端单元实现要求。包括客户 端的功能、性能指标、接口、传输的通信协议，以及子系统的和环境要求等。 本规范主要适用于客户端子系统的开发设计。 2. 引用标准 参见《中国电信网络视频监控业务技术规范 V3.0-总体技术要求》。 3. 定义和缩略语 参见《中国电信网络视频监控业务技术规范 V3.0-总体技术要求》。 4. 系统结构 参见《中国电信网络视频监控业务技术规范 V3.0-总体技术要求》。 5. CU 客户端系统 5.1. CU 概述 CU 是系统的客户端单元，负责对系统功能对用户的集中呈现、人机交互。可 实现监控中心及普通客户端等多种应用。 在系统中，CU 所处位置如图 5.1.1 所示。 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 4 页 图 5.1.1 CU 在系统中的位置 CU 对前端设备的访问和控制信令都需要通过中心服务系统交互实现。CU 和 中心服务系统构成完整的服务器/客户应用架构，CU 作为客户端应用。 5.2. CU 的组成 CU 主要分为监控中心、普通客户端两种应用模式。监控中心由数字矩阵、软 /硬件解码器、控制台等设备组成。 利用数字矩阵实现的监控中心设备组成如图 5.2.1 所示： 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 5 页 HITACHI 图 5.2.1 监控中心设备（一） 利用解码器实现的监控中心设备组成如图 5.2.2 所示： 控制台 电视墙 A B C D E F G H SELECTED ON-LINE A B C D E F G H SELECTED ON-LINE A B C D E F G H SELECTED ON-LINE A B C D E F G H SELECTED ON-LINE A B C D E F G H SELECTED ON-LINE A B C D E F G H SELECTED ON-LINE A B C D E F G H SELECTED ON-LINE A B C D E F G H SELECTED ON-LINE （ ）解码器 堆叠 图 5.2.2 监控中心设备（二） 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 6 页 5.2.1. 数字矩阵 数字矩阵可以将从网络接收到的视频解码，输出到一台或多台监视器上，并 可实现多画面分割显示，单画面轮巡显示，多画面分割轮巡显示。 一般通过在工控机中加装解码卡实现。 输出接口为标准 BNC 接口或 RCA 接口 可通过控制台设置、控制数字矩阵。 5.2.2. 解码器 解码器可以将从网络接收到的视频解码，输出到一台或多台监视器上，并可 实现多画面分割显示，单画面轮巡显示，多画面分割轮巡显示。 一般通过嵌入式系统实现。 输出接口为标准 BNC 接口或 RCA 接口。 可通过控制台设置、控制各个解码器。 5.2.3. 控制台 控制台由控制台软件实现，主要完成平台的接入、视频接收播放、报警信号 接收/联动、画面控制、系统设置、数字矩阵及解码器的控制等功能。 5.2.4. 客户端 客户端由客户端软件实现，主要完成平台的接入、视频接收播放、报警信号 接收/联动、画面控制、系统设置等功能。 5.3. CU 分类 CU 实现需提供下列客户端管理应用系统： 1） 企业客户端 针对电信全球眼业务客户使用，提供远程图象监控系统应用，包括提供电视 墙应用解决方案。 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 7 页 A、 普通用户客户端 B、 企业管理员客户端 2） 电信客户端 针对电信运维部门使用，提供设备维护（添加、删除、划归）、用户维护、权 限分配、系统维护以及网管等功能。 5.4. CU 实现方式要求 1）跨操作系统平台的支持 要求应用系统必须支持 WINDOWS 平台用户，建议支持 LINUX 平台用户。 2）模块化设计 系统采用模块化的结构设计思想，将数据业务（音视频数据、控制命令、报 警数据、可选电子地图）和应用逻辑（监控应用）分开，并提供二次开发插件。 „ 音视频控件 音视频软解压控件是整个软件设计的核心，它嵌入在客户端应用软件中，应 具备与中心服务（CMS/VTDU）或直接与 PU 的图像监控数据接收，图像显 示、录像及云台控制，I/O 监控等基本功能，并须向用户提供统一编程接口。 „ 报警模块 业务报警的采集，比如：视频丢失报警、开关量报警、移动侦测报警信号。 „ 电子地图 采用多图层、可伸缩、可平移的地图展示方式。 3）支持 C/S 、B/S 两种企业客户端应用系统 企业 CU 客户端系统可以考虑提供 C/S 结构的胖客户端系统，也可以考虑基 于 WEB 方式的客户端系统，基于 WEB 方式的客户端系统需要在中心服务 端提供相应的 WEB 服务应用。 6. CU 功能要求 用于浏览和控制远端视频及系统的设备。企业客户端包括播放图像、云台控 制、录像检索、录像配置、报警联动、设备配置、用户登录、用户管理、电视墙 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 8 页 控制、日志察看等。 6.1. 企业控制台/客户端 企业 CU 客户端是面向业务客户的集中监控应用系统。主要功能应： 1）登录认证： 提供登录验证界面，实现与平台 PAG（或 CCS）及 CMS 的交互后进入系统。 2）远程浏览： „ 支持自动以树形结构将浏览的前端设备和摄影头排列出来，可以根据业 务、区域等进行分组。同时结合手工自由点播实时或历史画面 „ 支持 1、4、6、9、16 等多种画面分割模式，以及全屏显示；要求程序界 面能够自适应屏幕显示分辨率 „ 支持对音频的实时接收，可选择静音/打开音频，本地音量调节 „ 支持多画面轮巡，即系统应具备视频自动巡视功能，在可设定的间隔时 间内对所有的监控点进行图像巡检，参与轮巡的对象可以任意设定，包 括不同监控点的图像、同一监控点内不同摄像机、同一摄像机的不同预 置位等，轮巡间隔时间可设置 „ 支持本地字幕半透明叠加，且字幕位置可调 „ 支持图象实时抓拍功能 „ 支持本地实时录像功能 „ 抓拍和录像路径可设置 „ 提供实时码率显示功能，显示与关闭提供开关操作 „ 可通过 web 方式监视即时画面并调阅录像资料 2）提供电子地图功能 „ 支持多级电子地图（可选择矢量图、三维立体图或图片格式的地图） „ 支持电子地图的伸缩、平移、分图层显示 „ 图片格式的地图的方式支持客户自动上载更新图片 „ 报警发生时，报警地点以醒目的标记闪烁在电子地图上，准确判断报警 类型和地点 2）远程控制 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 9 页 „ 云台控制（上、下、左、右），包括自动巡航，预置位、灯光/雨刷功能 的支持 „ 摄象机色度、亮度、饱和度、对比度的实时控制 „ 镜头控制应包括变倍、调焦（应具有手动和自动调焦功能）、光圈（应具 有手动和自动光圈调节功能） „ 镜头控制要求客户端在图像分屏和全屏显示状态下都可进行 3）报警信息的接收以及报警联动： „ 支持报警信息的接收。报警信息经管理中心服务器转发，能够精确的将 报警信息传送到客户机，同时具备语音、图像（画面弹出）的提示，并 在本机生成报警日志，报警提示可根据设备一直发生作用，终止条件是 操作人员人工进行干预 „ 报警类别，可能包括消防报警、防盗报警、防火报警、门禁报警、非法 闯入及画面异动报警、图像设备故障报警以及通过温度、湿度探测器发 出报警信息等 „ 支持红外、光敏报警，当发生报警时，监控中心能自动进行存盘录像， 并自动在地理图上提示报警位置及类型 „ 当发生报警时，能联动多路相关设备，如临近摄像头、启动现场照明、 警笛等，且联动策略可按不同时段独立设定 „ 报警信息应该和录像数据相结合，可由报警信息检索回放相应的图像录 像 „ 支持报警信息的查询，并提供报警信息查询和浏览窗口 „ 支持开关量/移动侦测的布防、撤防的设置 „ 画面移动侦测报警的参数可设置 „ 支持联动策略的配置 （支持联动输出报警设备/灯光打开/录像开启） „ 对移动目标具有自动跟踪功能，该功能应能随时启动关闭（可选） 4）支持录像控制 „ 支持前端录像、中心录像、本地录像三种录像存储方式 „ 支持手动、定时、周期录像 „ 录像的远程检索回放、下载本地回放 „ 可依输入时间、地点直接搜寻历史录像，并可实现快进、快退、单帧放、 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 10 页 慢放、暂停等功能 „ 客户端的录像资料支持通用播放软件播放。(RealPlayer 或 MediaPlayer) 5）远程操作： „ 对指定的远端 PU 进行远程操作，如 PU 的参数设置、通道参数的设置、 串口参数的配置、报警参数的设置和查询、字母叠加设置、字母位置调 节 6）系统功能 „ 支持键盘快捷键云台控制(建议) 快捷键 功能 TAB 焦点视频窗口切换 空格 焦点视频窗口最大化/回复切换 方向键 焦点摄像头云台转动 Home/End 焦点摄像头镜头放大/缩小 F11 全屏 „ 锁定系统功能 “锁定系统”：就是将系统控制权限降为最低，使当前系统处于锁定状态， 只提供最基本的监视功能，包括禁用关闭系统。 “解除锁定”：在锁定系统后，要重新恢复对系统的控制权，必须首先解除 锁定。 „ 在线升级 客户端软件需提供新版本提示及在线升级 „ 系统日志 支持系统日志的查询，并提供当前系统日志的查询和浏览窗口。 7）与 PU 双向语音交流 能与自己权限的前端设备之间进行双向的实时语音对讲，同时具有对前 端设备分组进行语音广播。 8）辅助功能(可选) „ 操作杆功能 „ 辅助键盘控制 9）电视墙的控制（可选） xuminrong Underline xuminrong Highlight xuminrong Note 与业内习惯冲突，空格键一般为暂停和恢复播放 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 11 页 电视墙是由多个监视器组成的，每个监视器对应一路视频输出（比如对应一 个解码器的视频输出），这些关系是固定的。可以从 PU 列表中把某个 PU 拖到电 视墙上，并能对这个 PU 的图像控制，如开始播放和停止播放；还可以控制该 PU 的云镜。 支持手动调看、序列切换、群组序列调看、群组序列切换功能： „ 通过中文名称列表方式或电子地图图标方式手动在任意监视器上切 换系统中任一个摄像机图像 „ 在任一个监视器上调用任一个序列进行自动切换显示 „ 在多个监视器一次性同时调看任一个编组序列的所有摄像机图像 „ 将多个编组序列同时在多个监视器上进行群组的自动切换显示 „ 切换间隔时间可调 10）多画面合成的控制（可选） 支持对用户选择的多个 PU 视频流合成包括多个画面的一路视频流。 11）解码器/解码矩阵的管理功能（可选） „ 对中心一个或多个解码器/解码矩阵的配置管理；其 IP 地址、通道数、 每个通道对应的默认的显示图象的 IP 地址、通道号配置信息的存储 „ 每个解码器通道对应的电视墙信息的存储 „ 每个监视器可显示多个通道的信息（IP）配置管理 „ 是否轮跳配置管理。轮跳策略 „ 可设定每个解码器/解码矩阵报警时输出图象的通道；当收到报警联 动输出信息时将指定图象在设定的通道输出 „ 可设定每个解码器/解码矩阵音频的通道选择和控制 „ 将网络中任意若干个摄像机编组成若干个切换序列 12）客户自助管理 可由客户管理员自助进行相应的管理如，配置管理、权限管理、操作员管理、 告警管理、日志管理等。 13）图像辨识功能（可选） 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 12 页 通过图像辨识处理实现行业的智能辨识需要，如交通系统和交警系统需要的 车牌辨识功能。 6.2. 电信客户端 电信客户端是电信运维部门实施业务开通,设备管理以及权限管理的系统，为 业务开展提供支持平台。 1）设备管理： „ 监控设备的系统添加维护管理操作界面 „ 支持设备状态的查询，并提供系统设备（如前端）状态浏览、参数设置、 初始化等操作界面 „ 支持平台间设备划归 2）用户管理： „ 用户组的维护，可以实现一个企业的多个用户为一个组 „ 负责客户用户的受理，使用情况的统计 „ 提供用户帐号、口令等控制界面 „ 提供多级区域、机构的设置界面 3）权限设置： „ 用户/用户组可访问的设备的列表信息维护 „ 用户/用户组相应的控制操作权限设置界面 4）业务开通： „ 提供开户、禁用/启用、注销等业务开通管理 5）系统维护： „ 系统日志管理 „ 对中心各功能服务运行状态的监控 „ 前端设备的状态管理 6）巡检与校时： „ 定时对前端设备进行巡检，当设备有故障时（断线、无视频），产生告警 信息 „ 可以统一对系统中的设备进行校时 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 13 页 7）平台注册： „ 对有跨平台访问的平台的信息注册 7. CU 性能要求 CU 的控制台、客户端、解码器及数字矩阵必须达到如下性能要 iu1 7.1. 使用环境 工作温度要求为 0 ℃～50 ℃范围内，相对湿度要求在 10%～90%内。 7.2. 外观 按照中国电信 2.0＋测试规范要求。 7.3. 电磁兼容性 符合我国电磁兼容标准 GB 3907－1983。符合 class A 级别。 7.4. 抗雷性 7.4.1. 防雷设计方案 为增强电源的防雷击效果，需要在电源的输入前端加入电源避雷器，这样可 大大增强电源的抗雷击能力。 7.4.2. 接地设计方案 保证设备用接地线与大地保持良好接触，保证交流电源插座的中性线与大地 良好接触。 7.5. 环境适应性 交流电源电压标称值为 220 V，频率标称值为 50 Hz。电压在 187 V～253 V 范 围内波动、频率在 47.5 Hz～52.5 Hz 范围内波动时，设备应能正常工作。 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 14 页 7.6. 可靠性要求 应该满足 5 个 9 的要求，达到 99.999%。 8. 软件的要求 8.1. 基本要求 1) 要求软件采用分层的模块化结构，模块之间的通信应按规定接口进行。 任何一层的任何一个模块的维护和更新以及新模块的追加都不影响其 它模块。 2) 系统参数、用户资料与处理程序应有相对的独立性。用户资料的任何变 更都不应引起运行版本程序的变更。处理程序应与系统参数、用户资料 相适应。 3) 软件应有容错能力，一般的软件故障不应引起各类严重的系统再激活。 4) 软件设计应有防护性能，某一软件模块内的软件错误应限制在本模块 内，而不应造成其它软件模块的错误。 5) 应具有软件运行故障的监视功能。一旦软件出现死循环等重大故障，应 能自动再激活，并能出实时故障报告信息。 6) 系统中所有涉及到时间的信息和资料其年份部分采用带纪元表示法。 7) 软件具有详细、完善、灵活的业务、用户等资料的统计、分析、预测能 力。 8.2. 软件设计要求 1) 应用软件应采用分层次的体系结构，以便于系统的维护和扩展； 2) 应用软件应能根据用户规模的不同支持集中处理模式和分布式处理； 3) 应用软件应具有很好的开放性，以便于与其它应用系统的连接；系统应 提供完整的二次开发工具及使用说明，便于进行客户化工作； 4) 应用软件应具有很好的可移植性，支持多种操作系统，并能移植到不同 厂家的硬件平台上运行； 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 15 页 5) 系统的运行应是安全、可靠的，具备完善的、分级的操作/访问权限控制； 6) 系统应具有资料备份及灾难恢复功能。 9. 接口协议 9.1. 接口通信协议结构 9.2. CU 与 VTDU 的通信协议 9.2.1. 接口定义对象 9.2.2. 音视频数据流格式 9.2.3. 视频数据流传输方式 9.3. 集成应用二次开发接口规范 9.3.1. 接口规范目标 要求提供标准的客户端二次开发控件，便于第三方的二次开发。 9.3.2. 接口原则 插件封装 CU 与 VTDU 音视频数据请求和回应接口；同时可以封装 CU 预 CMS 的控制命令接口。 接口使对外提供调用的方法，使用的属性以及事件。 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 16 页 9.3.3. 接口规范 9.3.3.1. 客户端插件功能需求 控件基本要求： 控件可以在同一个程序中进行多个实例化； 控件可以初始化，自动销毁销毁，并支持多线程调用； 控件可以通过认证登录到平台服务器； 控件可以根据用户权限获取视频列表，以及分组信息。 控件能够支持动态获取视频点的情况，如设备上线或者下线等情况。 控件能够支持动态获取告警信息。 实时流模式的功能要求： 在指定的窗口中播放实时视频 视频播放可以暂停，暂停时窗口要保持为当时的帧图像 取消暂停后要能继续播放当前的实时视频（要丢掉暂停时没有观看的帧） 清除播放缓冲区中的数据，以改善播放迟时 把当前帧以 BMP 或 JPEG 文件格式保存 在播放过程中，打开或关闭声音， 并支持双向语音功能。（同时播多个 图像时，可以同时播放声音） 关闭视频播放 录像功能要求： 能够进行本地录像；录像时候，可以播放视频，也可以不播放。 录像格式可以直接用MediaPlay 进行播放或者点播，推荐使用ASF格式； 文件播放模式的功能要求： 在指定的窗口中播放视频文件 视频播放可以暂停，暂停时窗口要保持为当时的帧图像 取消暂停后要能继续播放当前的视频文件 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 17 页 查询当前播放的位置，第几帧 设置当前播放的位置，第几帧 查询文件的总长度，多少帧 支持 1/2 1/4 1/8 1/16 每秒一帧 五种慢放功能 可以支持向前或向后两种回放方向 支持 ×2 ×4 ×8 ×16 四种快放功能 可以把当前帧以 BMP 或 JPEG 文件格式保存 在播放过程中，打开或关闭声音。（同时播多个图像时，可以同时播放声 音） 9.3.3.2. 音视频插件接口定义 9.3.3.2.1 插件初始化 HRESULT Initialize() 功能描述 初始化插件资源 参数说明 无参数 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.2 插件反初始化 HRESULT Uninitialize() 功能描述 释放插件资源 参数说明 无参数 返回说明 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 18 页 执行成功返回 0，错误时返回错误码 9.3.3.2.3 打开文件播放模式 HRESULT OpenFile(long* phHandle, BSTR strFileName, long lPos, long hWnd) 功能描述 打开文件播放模式 参数说明 phHandle 用于接收返回播放句柄的地址。 strFileName 要播放的文件名（绝对路径）。文件大小不能超过 4G 或小于 4K lPos 播放位置（百分数），为 0~100 之间的整数 hWnd 窗口句柄，不允许为空 返回说明 执行成功返回 0，*phHandle 保存解码资源的句柄；错误时返回错误码。 9.3.3.2.4 关闭文件播放模式 HRESULT CloseFile(long hHandle) 功能描述 关闭文件播放模式 参数说明 hHandle 要关闭的播放句柄 返回说明 执行成功返回 0，错误时返回错误码 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 19 页 9.3.3.2.5 打开 URL 播放模式 HRESULT OpenUrl(long* phHandle, BSTR strUrl, long lPos, long hWnd, BSTR strFileName) 功能描述 打开URL播放模式 参数说明 phHandle 用于接收返回播放句柄的地址。 strUrl 要播放的 URL。 lPos 播放位置（百分数），为 0~100 之间的整数 hWnd 窗口句柄，为空表示直接下载 strFileName 保存文件的绝对路径（带.asf扩展名），文件格式：ASF格式 返回说明 执行成功返回 0，*phHandle 保存解码资源的句柄；错误时返回错误码。 9.3.3.2.6 关闭 URL 播放模式 HRESULT CloseUrl(long hHandle) 功能描述 关闭URL播放模式 参数说明 hHandle 要关闭的播放句柄 返回说明 执行成功返回 0，错误时返回错误码 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 20 页 9.3.3.2.7 打开流播放模式 HRESULT OpenStream(long* phHandle, BSTR strRemoteIP, long lRemotePort, long lNetType, long lPacketType, long hWnd, BSTR strFileName) 功能描述 打开流播放模式 参数说明 phHandle 要打开的播放句柄 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.8 关闭流播放模式 HRESULT CloseStream(long hHandle) 功能描述 关闭流播放模式 参数说明 hHandle 要关闭的播放句柄 返回说明 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 21 页 执行成功返回 0，错误时返回错误码 9.3.3.2.9 开始音频发送 HRESULT StartAudio(long* phHandle, BSTR strRemoteIP, long lRemotePort, long lNetType, long lPacketType) 功能描述 开始音频编码，并发送给对方 参数说明 phHandle 要打开的音频发送句柄 strRemoteIP 远端 IP 地址 lRemotePort 远端 IP 端口 lNetType 0:UDP 1:TCP 2:Multicast lPacketType 0:RTP 1:TS 返回说明 执行成功返回 0，错误时返回错误码 与OpenStream配合，可实现双向语音对讲 9.3.3.2.10 停止音频发送 HRESULT StopAudio(long hHandle) 功能描述 停止发送声音，停止音频编码， 参数说明 hHandle 播放句柄 返回说明 执行成功返回 0，错误时返回错误码 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 22 页 9.3.3.2.11 设置音量大小 HRESULT SetVolume(long hHandle, long lVolume, bool bCapture) 功能描述 设置音量大小 参数说明 hHandle 播放句柄 lVolume 音量的值，范围 0-0XFFFF bCapture 播放音量或采集音量 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.12 开始播放实时视频 HRESULT Play(long hHandle) 功能描述 开始播放实时视频 参数说明 hHandle 播放句柄 hWnd 播放视频的窗口句柄 返回说明 执行成功返回 0，错误时返回错误码 如果已经播放，只是改变当前播放速度为正常速度。 9.3.3.2.13 停止播放 HRESULT Stop(long hHandle) 功能描述 停止播放 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 23 页 参数说明 hHandle 播放句柄 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.14 暂停播放 HRESULT Pause(long hHandle, long lPause) 功能描述 暂停播放 参数说明 hHandle 播放句柄 lPause lPause=TRUE暂停；否则恢复播放 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.15 刷新显示区域 HRESULT RefreshSurface(long hHandle)(可删除) 功能描述 刷新显示区域 参数说明 hHandle 播放句柄 返回说明 执行成功返回 0，错误时返回错误码 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 24 页 9.3.3.2.16 读取播放位置 HRESULT GetPlayPos(long hHandle, long* pPos) 功能描述 读取播放位置 参数说明 hHandle 播放句柄 pPos 播放位置(百分数)，为 0~100 之间的整数 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.17 设置播放位置 HRESULT SetPlayPos(long hHandle, long lPos) 功能描述 设置播放位置 参数说明 hHandle 播放句柄 lPos 播放位置（百分数），为 0~100 之间的整数 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.18 设置回放方向 HRESULT SetPlayDirection(long lDirection) 功能描述 设置回放方向 参数说明 lDirection 回放方向，1表示向前，0表示向后 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 25 页 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.19 快速播放 HRESULT Fast(long hHandle, long lSpeed) 功能描述 快速播放速度调节 参数说明 hHandle 播放句柄 lSpeed 加快倍速：1=1x / 2=2x / 4=4x / 8=8x / 16=16x 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.20 慢速播放 HRESULT Slow(long hHandle, long lSpeed) 功能描述 慢速播放速度调节 参数说明 hHandle 播放句柄 lSpeed 减慢倍速：1=1x / 2=2x / 4=4x / 8=8x / 16=16x，0 为单帧播放 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.21 文字合成 HRESULT OverlayText(long hHandle, long lPointX, long lPointY, long lColor, long lAlpha, BSTR strText) 功能描述 将文字合成到视频上 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 26 页 参数说明 hHandle 播放句柄 lPointX X轴坐标，单位：象素 lPointY Y轴坐标，单位：象素 lColor 文本颜色，RGB lAlpha 透明度：0－100 strText 需要参与合成的文字 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.22 清除文字合成 HRESULT ClearOverlayText(long hHandle, BSTR strText) 功能描述 清除显示的文字 参数说明 hHandle 播放句柄 strText 被清除的文字，空字符串表示清除所有 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.23 开始录像 HRESULT StartRecord(long hHandle, BSTR strFileName) 功能描述 本地录像开始 参数说明 hHandle 播放句柄 strFileName 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 27 页 录像文件的绝对路径（带.asf扩展名），文件格式：ASF格式 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.24 停止录像 HRESULT StopRecord(long hHandle) 功能描述 本地录像停止 参数说明 hHandle 播放句柄 返回说明 执行成功返回 0，错误时返回错误码 9.3.3.2.25 抓屏 HRESULT CapPic(long hHandle, BSTR strFileName, long lPicType) 功能描述 抓取当前帧存储为 BMP/JPEG 图片 参数说明 hHandle 播放句柄 strFileName 图像文件的绝对路径（BMP带.bmp扩展名，JPEG带.jpg扩展名） lPicType 0:BMP 1:JPEG 返回说明 执行成功返回 0，错误时返回错误码 中国电信网络视频监控业务技术规范(V3.0) CU 分册 第 28 页 9.3.3.2.26 读取流信息 HRESULT GetStreamInfo(long hHandle, long* lBitRate, long* lLostRate, long* lFrameRate, BSTR* strVideo, BSTR* strAudio, long* lWidth, long* lHeight) 功能描述 读取流信息 参数说明 hHandle 播放句柄 lBitRate 当前流码率，单位：bps lLostRate 当前丢包率，为实际丢包率×10000 返回