中国移动机顶盒软探针北向接口技术规范v1.0.0

中国移动通信企业标准 中国移动机顶盒软探针北向接口技术规范 Te c h n i c a l S p e c i f i c a t i o n s f o r S e t To p B o x S o f t P r o b e a n d N o r t h -I n t e r f a c e 版本号：1.0.0 中国移动通信集团公司 发布
╳╳╳╳-╳╳-╳╳发布 ╳╳╳╳-╳╳-╳╳实施 QB-╳╳-╳╳╳-╳╳╳╳
目录
1前言 (2)
2范围 (2)
3规范性引用文件 (2)
4术语、定义和缩略语 (2)
5软探针与监测平台接口 (3)
6接口协议定义 (4)
6.1.BOOT接口（IF1） (4)
6.1.1.BOOT请求 (4)
6.1.2.BOOT响应 (6)
6.2.PERIODIC接口（IF2） (9)
6.2.1.PERIODIC请求 (9)
6.2.2.PERIODIC响应 (11)
6.3.PROGRAM INFO接口（IF3） (12)
6.3.1.PROGRAM INFO请求 (12)
6.3.2.PROGRAM INFO响应 (15)
6.4.ALARM接口（IF4） (16)
6.4.1.ALARM请求 (16)
6.4.2.ALARM响应 (20)
6.5.CONNECTION REQUEST之网络测试接口（IF5） (21)
6.5.1.网络测试任务下发 (21)
6.5.2.网络测试数据上报请求 (23)
6.6.常量表 (25)
6.6.1.EventCode (25)
6.6.2.AlarmCode (25)
workTestCode (26)
6.6.4.ProgramInfoCode (26)
6.6.5.Result (26)
6.6.6.OperationCode (27)
1前言
本规范定义了机顶盒软探针和软探针监测平台（省级数字家庭管理平台-软探针前置机）的接口协议，用以规范平台和机顶盒软探针的对接与实现，保证整个探针平台及机顶盒软探针中间件顺畅运行。

本标准由中国移动通信集团公司网络部提出并归口。

本标准起草单位：中国移动通信集团公司网络部、中国移动通信研究院。

本标准主要起草人：陈书炫、李颖、吴博、郭毅峰、王天竹、吴文雯。

本标准解释单位：中国移动通信集团公司网络部。

本标准由中国移动通信集团公司XXX号文发布。

2范围
本规范定义了机顶盒软探针与软探针监测平台的接口协议，是中国移动家庭宽带质量监测平台相关产品开发的依据，适用于机顶盒软探针的开发和软探针监测平台的对接。

3规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。

凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。

凡是不注日期的引用文件，其最新版本适用于本标准。

表3-1 规范性引用文件
4术语、定义和缩略语
下列术语、定义和缩略语适用于本标准：
5软探针与监测平台接口
图5-1 软探针与监测平台接口框图
软探针从底层播放器、网络口和系统采集数据，进行预处理后，根据触发上报的条件不同向软探针监测平台上报数据，目前软探针与软探针监测平台的接口可分为：
表5-1 接口列表
6接口协议定义
这里定义的是应用层协议，和具体采用的编码方式无关。

为了提高服务器和机顶盒之间的交互速度，决定采用相对简单的一次交互流程进行交互。

目前选择的编码方式是JSON。

Bean的数据组织格式为：
“beanName”:{ “para1”:”value1”,”para2”,”value2”}
List of String的数据格式为：
“listName”: [“value1”,”value2”]
List of Bean 的数据格式为：
“listName”:[{“para1”:”value1”,”para2”:”value2”}, {“para1”:”value1”, ”para2”:”value2”}]
目前后台端采用标准的json解析库来解析数据，机顶盒端通过字符串匹配的方式来解析数据。

6.1.BOOT接口（IF1）
6.1.1.BOOT请求
消息方向：软探针（启动数据）—>软探针监测平台
消息格式如下：
POST <Request URI> HTTP/1.1
Host:
Content-Type:
Content-Length:
User-Agent:
Date:
Accept:
Referrer:
<payload>
Request URI：默认为“/ ”
Host：软探针监测平台的域名及端口
Content-Type：application/json
Content-Length：表明了消息体长度；
User-Agent：表明了客户端的信息；
Date：发起请求的日期、时间
Accept：终端可以接收的响应消息的媒体类型
<payload>：消息体中包含一个json文档，具体信息如下：
6.1.2.BOOT响应
消息方向：软探针监测平台—>软探针（启动数据）消息格式如下：
Server：服务器软件信息
Content-Type：application/json
Content-Length：消息体长度
<payload>：消息体中包含一个json文档，具体信息如下：
样例如下：。