播控平台接口协议

       中央集成播控总平台可与全国内容平台之间建立北向的内容导入接口，供中央集成播控平台导入内容。集成播控分平台也可与本地内容平台之间建立内容导入接口，供集成播控平台导入内容。

       中央集成播控总平台与省市播控分平台的南向接口定义为c系列接口。中央集成播控总平台通过C系列接口向省市播控分平台分发内容、产品、EPG信息，收集播控分平台的运营数据。省市播控分平台通过C系列接口向分发系统分发内容、产品、EPG信息，收集分发系统的运营数据。C系列接口为IPTV集成播控平台的标准接口，C系列接口包含有Cl、C2、C3三个接口，如图3-6所示。

       C1接口是指中央播控平台和省播控分平台之间、省播控分平台和分发系统之间的EPG模板管理接口，如图3-7所示。EPG模板定义为EPG菜单呈现方式的单个或多个文件的文件组，包含有HTML文件和必须的图像文件。EPG服务器通常部署在省市分平台或CDN侧，为了实现对EPG管理，播控平台制作好EPG模板后，把EPG模板的文件或压缩包放置在播控平台的管理服务器上，通过C1接口分发给集成播控分平台的EPG服务器或分发系统侧的EPG服务器，替换旧的EPG模板文件，从而完成EPG模板的下发和管理。同时，集成播控分平台通过中央播控总平台的授权，可以制作、管理本地化的EPG。

图3-6  播控平台接口

图3-7  EPG模板管理C1接口

      C2接口是播控平台与播控平台间、播控平台与CDN分发系统间的内容、分类、内容包的分发接口，中央播控平台向播控分平台、播控分平台向CDN分发系统分发内容、内容编排、内容打包、产品定价等信息，如图3-8所示。 

图3-8 内容分发管理C2接口

       C3接口指播控平台内容运营管理模块和分发系统的业务运营管理模块之间的接口，主要完成用户数据同步、订购数据同步、收视数据同步等功能。为了进行用户对节目和频道的点播及其观看行为的统计分析，分发系统的业务运行管理系统向播控平台上传运营数据，如用户订购记录、观看记录、浏览记录、开机记录等。运营管理C3接口如图3-9所示。

图3-9运营管理C3接口

      内容分发接口釆用SOAP协议加XML（ExtensibleMarkupLanguage,可扩展标记语言）指令文档的方式。其中，SOAP消息是与具体指令内容无关的通用消息，仅用于表达命令请求，具体的命令及参数利用独立的XML文档来描述。采用与具体指令无关的通用SOAP消息有利于指令扩展及在异步环境中实现通用的可靠消息传递机制。

       中央播控平台以SOAP协议加XML指令文档的方式主动向播控分平台发布内容，播控分平台根据SOAP消息中的文件URL获取XML并解析执行。省播控分平台以SOAP协议+XML指令文档的方式主动向分发系统平台发布内容，分发系统平台根据SOAP消息中的文件URL获取XML并解析执行，流程如图3-10所示。

图3-10  内容分发接口流程

（1）内容下发流程描述

① 模板同步命令请求（SOAP:ExecCmdRequest）。

      •  请求方向：从CSP（CentreServicePlatform,中心运营平台）至ULSP（LocalServicePlatform,本地运营平台）。

      •  在此请求消息中，包含操作指令信息的XML文件的URL描述信息。

② 模板同步命令应答(SOAP:ExecCmdResponse)。

      •  模板同步命令请求的同步应答消息。

③ 获取XML指令文件。

      •  CSP平台根据SOAP:ExecCmdRequest中的信息获取XML指令文件。

      • CSP平台获取XML文件后，进行文件解析处理，处理完成后，生成XML应答文件。

④ 模板同步结果通知请求(SOAP:ResultNotifyRequest)»

      •  请求方向：从LSP平台到CSP平台。

      •  LSP平台将模板同步命令的执行结果，通过此消息反馈给CSP平台。

⑤ 模板同步结果通知应答(SOAP:ResultNotifyResponse)。

      •  模板同步结果通知请求的同步应答消息。

⑥ CSP平台获取XML应答文件。

(2)SOAP消息定义

C2接□SOAP消息定义如表3-1、表3-2、表3-3所示。

       • 执行指令请求：ExecCmdReq。

       •  消息方向：CSP-LSP。

表3-1    C2接口SOAP消息定义(1)

注：M表示必选，0衣示可选。

      • 执行指令响应：ExecCmdReSo

      • 消息方向：CSP-LSPo

表3-2    C2接口SOAP消息定义(2)

    •  结果通知请求：ResultNotifyReq。
    •  消息方向：CSP-LSP。

表3-3   C2接口SOAP消息定义（3）

•  结果通知响应：ResultNotifyReS。
•  消息方向：CSP-LSP。

表3-4    C2接口SOAP消息定义（4）

 

（3）XML文件规范概述

XML文件的结构，如图3-11所示。

图3-11XML文件的结构

       ADI/Objects/Mappings是接口XML的通用基础框架，基于该通用框架定义不同的Object.ElementType和不同的Property.Name来满足对不同对象的定义需求，规范描述中应用以下规则。

       ① 对于任何符合Schema的XML文件，LSP应该忽略那些不能识别的Property或XMLTag或属性。

       ② Object.ElementType与Object.ID联合起来在接口中唯一定位一个对象实例，它们是一个接口中针对对象进行任何操作的唯一索引。当对象之间有父子关系或多对多关系时，Object.ID也被用作关联引用标识。

        ③ XML文件内容的编码全部采用UTF-8格式。

EPG信息下发流程如图3-12所示。

图3-1 2  EPG信息下发流程

(1)EPG下发流程描述

① 模板同步命令请求(SOAP:ExecCmdRequest)。

     • 请求方向：从播控平台到EPG服务平台。

     • 在此请求消息中，包含一个EPG文件集(EPGFileSet)的描述信息，同时包含这个文件集中一个或多个EPG文件的操作指令信息。

② 模板同步命令应答(SOAP:ExecCmdResponse)。

     • 模板同步命令请求的同步应答消息。

③ 获取XML指令文件。

     • EPG服务平台根据SOAP:ExecCmdRequest中的信息获取XML指令文件。

     • EPG服务平台中央节点获取模板文件并生效，中央节点以异步方式分发到服务平台边缘节点。

④ EPG服务平台中央节点获取模板文件并生效，中央节点以异步方式分发到服务平台边缘节点。

⑤ 模板同步结果通知请求（SOAP:ResultNotifyRequest）<>

     • 请求方向：从EPG服务平台到播控平台。

     • EPG服务平台将模板同步命令的执行结果，通过此消息反馈给播控平台。

⑥ 模板同步结果通知应答（SOAP:ResultNotifyResponse）。

     •  模板同步结果通知请求的同步应答消息。

⑦ 播控平台获取XML应答文件。

（2） C1接口协议参数要求

① ExecCmdRequest（播控平台一EPG服务平台）

     •  请求参数：如表3-5所示。

表3-5  C1接口SOAP消息定义（1）

    •  返回参数：如表3-6所示。

表3-6  C1接口SOAP消息定义（2）

②ResultNotifyRequest（EPG服务平台-*播控平台）。
   •   请求参数：如表3-7所示。

表3-7     C1接口SOAP消息定义(3)

(3)XML文件规范概述

XML文件的结构如图3-13所示。

图3-13XML文件结构

       ADI/Objects/Mappings是接口XML的通用基础框架，基于该通用框架定义不同的Object.ElementType和不同的Property.Name来满足对不同对象的定义需求，规范描述应用以下规则。

       ① 对于任何符合Schema的XML文件，LSP应该忽略那些不能识别的Property或XMLTag或属性。

       ② Object.ElementType与Object.ID联合起来在接口中唯一定位一个对象实例，它们是一个接口中针对对象进行任何操作的唯一索引。当对象之间有父子关系或多对多关系的时候，Object.ID也被用作关联引用标识。

       ③ XML文件内容的编码全部釆用UTF-8格式。

C3数据采集流程如图3-14所示。

图3-14  C3数据采集流程

 

(1)接口协议：FTP(FileTransferProtocol,文件传输协议)

(2) 流程描述

      ① LSP平台向CSP平台发起FTPrequest请求。

      ② CSP平台向LSP平台回应FTPresponse请求。

      ③ LSP平台向CSP平台传送运营数据文件。

      ④ 运营数据传输结束，LSP平台向CSP平台发送断开连接FTPFINACK请求。

      ⑤ CSP平台向LSP平台发送FTPACK请求回应，断开FTP连接。

(3) 基本要求

     ① 文件采用ASCII文本格式，文件体中每条记录的属性值按顺序排列，各属性间使用分隔符(默认为T，建议可配置)分隔，在生成文件时，如果相应的属性值为空，则用大写字符串“NULL”表示。

     ② 文件中一行作为一条记录，各条记录之间用“回车，换行符”作为分隔符并在文件中连续书写。

     ③ 当文件中的某字段不足规定长度时，采用左对齐的方式，不需要补足规定长度。

     ④ 文件生成周期及生成时间应可以根据文件类型分别设置，默认设置文件生成周期为一天一次，数据文件以每日增量模式提供，文件生成时间为每天凌晨1点。

(4) 文件要求

文件命名规则：SOPID.COPID.文件类型.日期.序列号.txt

    ① 文件类型定义如下所述。

     • Userinfo：表示用户信息的数据同步；

     • Orderinfo：表示用户订购信息的数据同步；

     • Viewinfo：表示用户收视信息的数据同步。

    ② 日期表示生成该文件的时间，其格式为年年年年月月日日时时分分秒秒，如20070703201200表示文件生成时间为2007年7月3日20时12分00秒。

    ③ 序列号：0000-9999,由0000开始顺序增1。

例如：

     SOPID00000000

     COPID00000001

文件名：运营数据文件名规则如图3-15所示。

图3-15运营数据文件名规则

不同的文件类型，其文件内容格式也不同，分别定义如表3-8〜表3-10所示。

表3-8用户信息数据定义

表3-9订购信息数据定义

表3-10  收视信息数据定义