1、 ICS 中 华 人 民 共 和 国 通 信 行 业 标 准 YD YD/T-XXXX-XXXX 视频应用与视频服务平台播放状态信息上 报接口技术要求 Technical requirements for playing status reporting interface between video application and video sever （报批稿） 20-发布 20-实施 中 华 人 民 共 和 国 工 业 和 信 息 化 部 发布 ICS 35.240.99 L67 I 目 次 前 言 .II 1 范围 .1 2 缩略语 .1 3 视频应用与视频服务平台的关系 .1 4
2、上报状态类型 .1 4.1 首帧出现 .2 4.2 广告开始 .2 4.3 广告结束 .2 4.4 卡顿出现 .2 4.5 卡顿结束 .2 4.6 视频结束 .2 5 工作模式 .2 5.1 实时上报 .2 5.2 延时上报 .3 6 接口定义 .3 6.1 上报接口方式 .3 6.2 基本参数 .3 6.3 动作参数 .4 6.4 时间参数 .5 附录 A （资料性）状态上报示例 .6 II 前 言 本标准按照 GB/T 1.1-2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由中国通信标准化协会提出并归口。 本标准起草单位：中
3、国移动通信集团有限公司、中国信息通信研究院 本标准主要起草人：郭嵩、方波、杨崑、聂秀英、王超 YD/T XXXX-XXXX 1 视频应用与视频服务平台播放状态信息上报接口技术要求 1 范围 本标准规定了在互联网视频播放过程中 ， 由视频应用向视频服务平台上报视频播放过程中的基本状 态信息的类型、上报方式、采用的接口及字段定义。 本标准适用于互联网视频应用 Web服务及 APP开发及应用，为应用的运营提供技术参考。 2 缩略语 下列缩略语适用于本文件。 APP 应用程序 Application UTC 协调世界时 Universal Coordinated Time HTTP 超文本传输协议 H
4、yperText Transfer Protocol 3 视频应用与视频服务平台的关系 视频应用指安装在终端上的互联网视频应用 APP或者运行在 Web浏览器上互联网视频网页 ， 用于与用 户交互并为用户提供视频播放界面 。 视频服务平台指视频服务提供商部署在云端的服务平台 ， 用于与视 频应用交互 ， 获取视频应用运行状态 ， 供管理人员监测业务运行状态 。 视频应用与视屏服务平台间的关 系如图 1所示。 图 1 视频应用与视频服务平台的关系图 4 上报状态类型 视 频应 用 视 频服 务平 台视 频 播 放 状 态 信 息 上 报 YD/T XXXX-20XX 2 视频应用在播放视频过程中
5、出现的播放状态会通过本标准定义的接口将状态信息上报给视频服务 平台，需上报的状态信息包括首帧出现、广告开始、广告结束、卡顿出现、卡顿结束、视频结束等。 4.1 首帧出现 首帧出现指用户点击视频播放后 ， 视频第一个画面出现在播放界面时的状态 ， 视频应用会将该状态 相关的信息上报给视频服务平台。 4.2 广告开始 广告开始指视频播放过程中每次播放广告开始时对应的状态 ， 视频应用会将该状态相关的信息上报 给视频服务平台。 4.3 广告结束 广告结束指视频播放过程中每次广告播放结束时对应的状态 ， 视频应用会将该状态相关的信息上报 给视频服务平台。 4.4 卡顿出现 卡顿出现指视频播放过程中视频
6、出现停顿状态的开始时刻 ， 视频应用会将该状态相关的信息上报给 视频服务平台。 4.5 卡顿结束 卡顿结束指视频播放过程中视频出现停顿状态的结束时刻 ， 视频应用会将该状态相关的信息上报给 视频服务平台。 4.6 视频结束 视频结束指视频播放过程中 ， 用户点击退出或完整视频播放完成 ， 视频播放结束对应的状态 ， 视频 应用会将该状态相关的信息上报给视频服务平台。 5 工作模式 本标准定义的接口工作模式有两种，分别是实时上报和延时上报。 5.1 实时上报 YD/T XXXX-XXXX 3 实时上报指当视频应用在播放视频过程中 ， 出现本标准定义接口的相关状态时 ， 将即时触发接口开 启 ，
7、并按照接口定义的格式及方式向视频服务平台上报状态信息 ， 必要时 ， 视频服务平台会返回响应消 息。 5.2 延时上报 延时上报指视频应用本次播放结束时 ， 将本次播放过程中出现的一系列状态统一上报给视频服务平 台，上报顺序按照状态出现的时间顺序依次上报。 6 接口定义 视频应用向视频服务平台上报状态信息应支持两种方式，分别是 HTTP GET和 HTTP POST。通过对各类 上报状态信息的关键参数分析分类 ， 其中包含的参数可分为基本参数 、 动作参数 、 时间参数三类 。 通过 上述三类参数的具体定义和组合，可以用于表达本标准中定义的全部状态类型。 6.1 上报接口方式 以下是状态上报的
8、两种方式： a) HTTP GET 当采用 HTTP GET方式上报时，应采用如下格式： HTTP:/域名 /路径 /?参数 1=XXX/参数 2=XXX/参数 3=XXX/扩展参数 =XXX/其中域名是视频服务商的域名，如腾讯视频对应的域名为“ ”； 路 径为每一个视频对应的路径地址， 由视频服务平台决定 ； “？ ”后为状态参数，包括本标准定义的参数 及视频服务提供商自己定义的扩展参数。 b) HTTP POST 当采用 HTTP POST方式上报时 ， 上报 URL为 HTTP:/域名 /路径 。 其中域名是视频服务商的域名 ， 如腾讯 视频对应的域名为“ ”； 路径为每一个视频对应的路
9、径地址，由视频服务平台决定。上报状态 参数包含在 HTTP POST报文的数据体中，参数采用明文传输。 6.2 基本参数 基本参数包含视频标识、上报类型、状态发生时间三个参数，具体参数定义见表 1。 YD/T XXXX-20XX 4 表 1 基本参数列表 标识 说明 长度 约束 vid 视频标签 ， 由视频提 供者分配 ， 保证唯一 性 256 必选 type 上报消息类型： 0=实时上报； 1=延时上报 2 必选 time 状态发生 UTC时间， 从 1970/1/1 00:00:00开始到该 时刻的毫秒数 64 必选 6.3 动作参数 动作参数包含状态类型、终端类型两个参数，具体参数定义见
10、表 2。 表 2 动作参数列表 标识 说明 长度 约束 act 状态类型： 0=广告开始 1=广告结束 2=首帧出现 3=视频结束 4=卡顿开始 5=卡顿结束 2 必选 UAType 终端类型 : 0=安卓 1=苹果 2 必选 YD/T XXXX-XXXX 5 2=PC 3=其他 终端型号 填写终端具体型号 20 可选 6.4 时间参数 时间参数包含视频时长、广告时长两个参数，具体参数定义见表 3。 表 3 时间参数列表 标识 说明 长度 约束 vlen 视频时长，单位秒（ s） 根据具体状态类型决定该参 数是否生效 ， 当 act=2、 3时该 参数生效。 64 可选 adlen 广告时长，单位秒（ s） 根据具体状态类型决定该参 数是否生效 ， 当 act=0、 1时该 参数生效。 64 可选 YD/T XXXX-20XX 6 附录 A （资料性） 状态上报示例 以 HTTP GET的上报方式为例，给出各种上报状态的消息示例。 a) 首帧出现： HTTP:/ vlen=300 b) 广告开始： HTTP:/ adlen=60 c) 广告结束： HTTP:/ adlen=60 d) 卡顿出现： HTTP:/ e) 卡顿结束： HTTP:/ f) 视频结束： HTTP:/ vlen=300
