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 L67I目 次 前 言 ....................................................................... II 1 范围 ........................................................................ 1 2 缩略语 ...................................................................... 1 3 视频应用与视频服务平台的关系 ................................................ 1 4 上报状态类型 ................................................................ 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 给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由中国通信标准化协会提出并归口。 本标准起草单位：中国移动通信集团有限公司、中国信息通信研究院 本标准主要起草人：郭嵩、方波、杨崑、聂秀英、王超 YD/T XXXX-XXXX 1 视频应用与视频服务平台播放状态信息上报接口技术要求 1　范围 本标准规定了在互联网视频播放过程中 ，由视频应用向视频服务平台上报视频播放过程中的基本状 态信息的类型、上报方式、采用的接口及字段定义。 本标准适用于互联网视频应用 Web服务及APP开发及应用，为应用的运营提供技术参考。 2　缩略语 下列缩略语适用于本文件。 APP 应用程序 Application UTC 协调世界时 Universal Coordinated Time HTTP 超文本传输协议 HyperText Transfer Protocol 3　视频应用与视频服务平台的关系 视频应用指安装在终端上的互联网视频应用 APP或者运行在 Web浏览器上互联网视频网页 ，用于与用 户交互并为用户提供视频播放界面 。视频服务平台指视频服务提供商部署在云端的服务平台 ，用于与视 频应用交互 ，获取视频应用运行状态 ，供管理人员监测业务运行状态 。视频应用与视屏服务平台间的关 系如图1所示。 图 1 视频应用与视频服务平台的关系图 4　上报状态类型 视频 应用视频 服务 平台视频播放状态信息上报 YD/T XXXX-20XX 2 视频应用在播放视频过程中出现的播放状态会通过本标准定义的接口将状态信息上报给视频服务 平台，需上报的状态信息包括首帧出现、广告开始、广告结束、卡顿出现、卡顿结束、视频结束等。 4.1　首帧出现 首帧出现指用户点击视频播放后 ，视频第一个画面出现在播放界面时的状态 ，视频应用会将该状态 相关的信息上报给视频服务平台。 4.2　广告开始 广告开始指视频播放过程中每次播放广告开始时对应的状态 ，视频应用会将该状态相关的信息上报 给视频服务平台。 4.3　广告结束 广告结束指视频播放过程中每次广告播放结束时对应的状态 ，视频应用会将该状态相关的信息上报 给视频服务平台。 4.4　卡顿出现 卡顿出现指视频播放过程中视频出现停顿状态的开始时刻 ，视频应用会将该状态相关的信息上报给 视频服务平台。 4.5　卡顿结束 卡顿结束指视频播放过程中视频出现停顿状态的结束时刻 ，视频应用会将该状态相关的信息上报给 视频服务平台。 4.6　视频结束 视频结束指视频播放过程中 ，用户点击退出或完整视频播放完成 ，视频播放结束对应的状态 ，视频 应用会将该状态相关的信息上报给视频服务平台。 5　工作模式 本标准定义的接口工作模式有两种，分别是实时上报和延时上报。 5.1　实时上报 YD/T XXXX-XXXX 3 实时上报指当视频应用在播放视频过程中 ，出现本标准定义接口的相关状态时 ，将即时触发接口开 启，并按照接口定义的格式及方式向视频服务平台上报状态信息 ，必要时，视频服务平台会返回响应消 息。 5.2　延时上报 延时上报指视频应用本次播放结束时 ，将本次播放过程中出现的一系列状态统一上报给视频服务平 台，上报顺序按照状态出现的时间顺序依次上报。 6　接口定义 视频应用向视频服务平台上报状态信息应支持两种方式，分别是 HTTP GET和HTTP POST。通过对各类 上报状态信息的关键参数分析分类 ，其中包含的参数可分为基本参数 、动作参数 、时间参数三类 。通过 上述三类参数的具体定义和组合，可以用于表达本标准中定义的全部状态类型。 6.1　上报接口方式 以下是状态上报的两种方式： a) HTTP GET 当采用HTTP GET方式上报时，应采用如下格式： HTTP://域名/路径/?参数1=XXX/参数2=XXX/参数 3=XXX/ …/扩展参数 =XXX/ …其中域名是视频服务商的域名，如腾讯视频对应的域名为“ v.qq.com ”；路 径为每一个视频对应的路径地址， 由视频服务平台决定 ；“？”后为状态参数，包括本标准定义的参数 及视频服务提供商自己定义的扩展参数。 b) HTTP POST 当采用HTTP POST方式上报时 ，上报URL为HTTP://域名/路径。