YD_T 3904-2021 视频应用与视频服务平台播放状态信息上报接口技术要求.docx

ICS 35.240.99 L67 中 华 人 民 共 和 国 通 信 行 业 标 准 YD/T 3904—2021 视频应用与视频服务平台播放 状态信息上报接口技术要求 Technical requirements for playing status reporting interf ace between video application and video server 2021-05-17发布 2021-07-01 实施 中华人民共和国工业和信息化部 发布 I YD/T 3904—2021 目 次 前言 Ⅱ 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 延时上报 2 6 接口定义 3 6.1 上报接口方式 3 6.2 基本参数 3 6.3 动作参数 3 6.4 时间参数 4 附录A(资料性)状态上报示例 5 Ⅱ YD/T 3904—2021 前 言 本标准按照GB/T1.1—2009 给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由中国通信标准化协会提出并归口。 本标准起草单位：中国移动通信集团有限公司、中国信息通信研究院。 本标准主要起草人：郭嵩、方波、杨崑、聂秀英、王超。 YD/T 3904—2021 视频应用与视频服务平台播放状态信息上报接口技术要求 1 范围 本标准规定了在互联网视频播放过程中，由视频应用向视频服务平台上报视频播放过程中的基本状 态信息的类型、上报方式、采用的接口及字段定义。 本标准适用于互联网视频应用Web 服务及APP 开发及应用，为应用的运营提供技术参考。 2 缩略语 下列缩略语适用于本文件。 APP 应 用 程 序 Application UTC 协调世界时 Universal Coordinated Time HTTP 超文本传输协议 HyperText Transfer Protocol 3 视频应用与视频服务平台的关系 视频应用指安装在终端上的互联网视频应用APP 或者运行在Web 浏览器上互联网视频网页，用于 与用户交互并为用户提供视频播放界面。视频服务平台指视频服务提供商部署在云端的服务平台，用于 与视频应用交互，获取视频应用运行状态，供管理人员监测业务运行状态。视频应用与视屏服务平台间 的关系如图1所示。 视频 应用视频播放状态信息上报 视频 应用 视频播放状态信息上报 服务 平台 图 1 视频应用与视频服务平台的关系 4 上报状态类型 视频应用在播放视频过程中出现的播放状态会通过本标准定义的接口将状态信息上报给视频服务 2 YD/T 3904—2021 平台，需上报的状态信息包括首帧出现、广告开始、广告结束、卡顿出现、卡顿结束、视频结束等。 4.1 首帧出现 首帧出现指用户点击视频播放后，视频第一个画面出现在播放界面时的状态，视频应用会将该状态 相关的信息上报给视频服务平台。 4.2 广告开始 广告开始指视频播放过程中每次播放广告开始时对应的状态，视频应用会将该状态相关的信息上报 给视频服务平台。 4.3 广告结束 广告结束指视频播放过程中每次广告播放结束时对应的状态，视频应用会将该状态相关的信息上报 给视频服务平台。 4.4 卡顿出现 卡顿出现指视频播放过程中视频出现停顿状态的开始时刻，视频应用会将该状态相关的信息上报给 视频服务平台。 4.5 卡顿结束 卡顿结束指视频播放过程中视频出现停顿状态的结束时刻，视频应用会将该状态相关的信息上报给 视频服务平台。 4.6 视频结束 视频结束指视频播放过程中，用户点击退出或完整视频播放完成，视频播放结束对应的状态，视频 应用会将该状态相关的信息上报给视频服务平台。 5 工作模式 本标准定义的接口工作模式有两种，分别是实时上报和延时上报。 5.1 实时上报 实时上报指当视频应用在播放视频过程中，出现本标准定义接口的相关状态时，将即时触发接 口开启，并按照接口定义的格式及方式向视频服务平台上报状态信息，必要时，视频服务平台会返 回响应消息。 5.2 延时上报 延时上报指视频应用本次播放结束时，将本次播放过程中出现的一系列状态统一上报给视频服务平 台，上报顺序按照状态出现的时间顺序依次上报。 3 YD