1、 GY 中华人民共和国 广播电视和网络视听 行业标准 GY/T 332 2020 互联网互动视频数据格式规范 Specification of data format for interactive video over the internet 2020 - 10 - 12 发布 2020 - 10 - 12 实施 国家广播电视总局 发布 GY/T 332 2020 I 目 次 前言 . II 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 1 4 互动视频系统架构 . 3 5 互动组件分类和参数配置 . 4 5.1 剧情选择组件 . 4 5.2 视角切换组件 . 5 5.
2、3 画面交互组件 . 6 5.4 自定义交互组件 . 7 6 互动视频数据格式 . 7 6.1 数据组织结构 . 7 6.2 剧 . 8 6.3 章 . 9 6.4 播放区间 . 9 6.5 互动节点 . 9 附录 A（资料性） 数据格式示例一 . 13 附录 B（资料性） 数据格式示例 二 . 30 附录 C（资料性） 数据格式示例三 . 48 附录 D（资料性） 数据格式示例四 . 75 GY/T 332 2020 II 前 言 本文件按照 GB/T 1.1 2020标准化工作导则 第 1部分：标准化文件的结构和起草规则的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件发布机构不承
3、担识别这些专利的责任。 本文件 由全国广播电影电视标准化技术委员会（ SAC/TC 239）归口。 本文件 起草单位： 国家广播电视总局广播电视规划院、 北京爱奇艺科技有限公司、腾讯科技 （深圳） 有限公司、优酷信息技术（北京）有限公司、湖南快乐阳光互动娱乐传媒有限公司、中央广播电视总台 、 国家广播电视总局广播电视科学研究院、 中国电子 技术标准化研究院、 国广东方网络（北京）有限公司、 央视频融媒体发展有限公司 、好易购家庭购 物有限公司、智令互动（深圳）科技有限公司、 百视通网络 电视技术发展有限责任公司 、 咪咕视讯科技有限公司 、中国传媒大学、 清华大学、北京航空航天大学 、 互影科
4、技（北京）有限公司 、 中移（杭州）信息技术有限公司 。 本文件 主要 起草人 ： 邓向冬、刘文翰 、 杨子斌 、刘里、 章兢 、薛潋、 梅 剑 平 、 黄卓伟、 宁金辉、 杨 光 、 王涛 、 郑磊 、 雷彬 、 洪薇、 张旭 、 徐昊 、 王磊、范科峰、 梁自强 、李凯东、 张 瑞 圣、郑炜、 刘松鹏 、 张 歌东 、 张松海、 陆峰 、 鹍鹏 、 罗红 。 GY/T 332 2020 1 互联网互动视频数据格式 规范 1 范围 本文件 规定了互联网互动视频的数据格式。 本文件 适用于互联网互动视频系统 的 建设 、运维 ，以及内容的制作、 交换、 分发 、 播放 等。 2 规范性 引用文
5、件 本文件没有规范性引用文件。 3 术语 和定义 下列术语和 定义适用于 本 文件 。 3.1 互联网互动视频 interactive video over the internet 通过互联网 (含移动互联网 )向公众提供的 具有分支剧情选择、视角切换、 画面交互 等 交互能力，能 够为用户带来互动观看体验的一种视频业务 ，以下简称“互动视频”。 3.2 互动视频制作平台 interactive video production platform 为视频添加互动能力， 制作互动视频 内容的生产工具 平台。 3.3 互动视频服务 平台 interactive video service pla
6、tform 为互动视频提供上传、 编目 、审核、存储、 版权、 分发、统计、分析等功能的服务 平台 。 3.4 互动视频播放系统 interactive video play system 播放互动视频并实现互动能力的播放软硬件和 播放服务的 统称。 3.5 播放区间 video play segment 互动视频中 ， 每一个视频片段 及其 相关 属性 信息的集合 ， 一个完整的互动视频包含多个 视频片段和 相关属性信息的集合。 3.6 互动组件 interactive component GY/T 332 2020 2 由 样式 模板 和参数配置封装 组成的 对象 ，其中 样式 模板 定义
7、 互动能力 的 界面 样式 ， 参数配置定义标 题、倒计时 控件 、 按钮 、 按钮 触发 后 的播放区间 链接 等信息。 3.7 互动 节点 interactive node 互动视频中， 每一组描述视频互动逻辑的交互信息集合 ， 包含所在的播放区间信息，以及单个或多 个互动组件。 3.8 故事线 story line 由 播放 区间 和 互动节点 组成的分支结构，以 节点和 分支 的方式体现 。 3.9 互动事件 interactive event 互动视频中响应 用户交互 动作 的 消息 事件， 包括但不限于单次点击、连续点击、滑动特定路径、长 按、摇一摇、姿态、 手势、 语音命令等。
8、3.10 互动视频交互能力 interaction-ability of interactive video 互动视频播放系统提供给 用户 进行 剧情选择、视角切换、画面 交互 等 交互类型的能力 ， 通过互动组 件进行定义和实现。 3.11 剧情选择 story choice 用户 选择 进入 到不同 剧情 分支的 互动 能力 。 3.12 视角切换 viewpoint switch 用户 选择不同 摄像机视角或 角色视角 进行 观看的 互动 能力。 3.13 画面 交互 screen interaction 用户 在视频 画面中 通过 互动事件 实 现交互和 信息探索 的互动能力 ， 其
9、包括 多 种表现形式 ， 例如 ： 文 字 、图片、视频 、小游戏 等 。 3.14 自定义 交互 custom interaction 创作 者 自己 定义 交互 方式的能力 ， 用于 交互 能力的扩展 。 3.15 互动因子 interactive factor 用户在较长时间跨度内互动操作参数的 集合 ， 通过互动操作参数的累计数值可触发不同观看内容。 GY/T 332 2020 3 3.16 互动引擎 interactive engine 在播放终端中，集成互动视频播放控制接口、设备控制接口、用户接口及互动管理接口等，为互动 程序提供运行环境 ， 并支撑与播放器、终端设备及后台服务交互
10、数据的模块。 3.17 互动视频 数据格式 interactive video data format 互动视频 互动 内容 和 组织 结构的数据 规则 。 3.18 互动 视频脚本文件 集 interactive video script files 对 互动视频内容 、 组织结构 及其参数 描述 的脚本文件集合 。 4 互动视频系统架构 互动视频系统 架构 包括 互动视频制作平台、互动视频服务平台、互动视频播放 系统 等模块 ，见图 1。 创 作 者 互 动 视 频 制 作 平 台 制 作 互 动 视 频 了 解 用 户 偏 好 再 创 作 内 容 互 动 视 频 播 放 系 统 （ 含
11、播 放 器 和 互 动 引 擎 ） 电 视 电 脑 手 机 平 板 用 户 互 动 视 频 服 务 平 台 账 号 管 理 媒 资 管 理 网 络 分 发 统 计 分 析 互 动 操 作 生 成 数 据 文 件 反 馈 互 动 数 据 记 录 互 动 数 据 分 发 数 据 文 件 内 容 生 产 端 用 户 应 用 端 平 台 服 务 端 剧 情 选 择 组 件 视 角 切 换 组 件 画 面 互 动 组 件 自 定 义 交 互 组 件 V R / A R 设 备 图 1 互动视频 系统架构 互动视频制作平台 通过 互动视频制作工具 为视频添加 剧情选择 、 视角切换 、 画面交互 等 互动
12、组件 ， 并为其设定 样式 和参数，编辑、预览视频互动效果， 实现互动视频 交互 能力。 互动视频服务平台通过互联网 提供 互动视频服务，完成互动视频的 账号管理 、媒资管理（ 上传 、转 码、编目、审核、 存储 、 版权、 发布） 、 网络分发、统计分析 等业务。 互动视频播放 系统 通过 播放器和互动引擎 实现互动视频的播放、缓冲 、 渲染 和交互 等功能，同时采 集用户互动数据。 创作者在互动视频制作平台完成互动视频制作并传输至互动视频服务平台，互动视频服务平台将互 动视频内容分发至互动视频播放 系统 ， 用户 在互动视频播放 系统 上观看 体验 视频 内容 ，同时播放 系统 收 集互动
13、数据并反馈至 互动视频 服务平台，供 平台 统计分析或 指导 创作者再创作。 GY/T 332 2020 4 5 互动组件 分类和参数配置 5.1 剧情选择 组件 剧情选择组件包括以下 互动 参数 配置内容 。 a) 配置 剧情选择 标 题（可选） 。 b) 配置 两个及以上不同 分支 选项 的 按钮及 出现时间 。 c) 配置选项跳转方式， 包括 计时 式 和暂停 式两种 。 1) 计时 式 ：视频播放 至 互动节点，出现选项，并开始倒计时。如计时过程中，用户选择了选 项，则进入下一个 情节。如 计时完成但用户未选择，则进入默认选项 。 2) 暂停 式：视频 播放 至 互动 节 点， 视频暂
14、停播放，仅当用户选择后，播放对应视频。 d) 配置 不同 分支选项 按钮 所 触发 的播放区间链 接信息 。 剧情选择 组件样式 示意 图 见 图 2， 具体的组件 形状、 大小、位置、颜色、字体 、数量 等均可自行规 定。 选 项 A 视 频 内 容 选 项 B 分 支 选 项 按 钮 浮 层 背 景 图 剧 情 选 择 标 题 剧 情 选 择 标 题 倒 计 时 进 度 条 图 2 剧情选择 组件 样式 示意 图 应用剧情选择能力 的互动视频 应 支持以故事线形式进行 剧情浏览。用户通过单击已完成故事线中的 互动节点 或播放区间 ， 可 回到原情节 处重新选择故事线路径观影 。故事线样式示
15、意 图 见图 3，具体的组 件形状、大小、位置、颜色、字体 、数量 及是否显示观看进度、用户选项百分比等内容均可自行规定。 GY/T 332 2020 5 故事线结构图 播放区间 N （ 已选择 ） 互动节点 1 互动节点 2 播放区间互动节点 关 闭 关闭故事线 已观看 X % 解锁 Y 个结局 观看进度 播放区间 B （ 未选择 ） 播放区间 A （ 已选择 ） 图 3 故事线样式 示意 图 5.2 视角切换 组件 视角切换组件包括以下 互动 参数 配置内容 ： a) 配置 视角切换 标题（可选） ； b) 配置 两个及以上不同 切换 选项 的 按钮及出现时间 ； c) 配置 触发事件，
16、包括 ： 点击 、 长按等方式 ； d) 配置不同切换 选项 按钮 所触发 的 播放区间链 接信息 。 视角切换 组件 的两种常用 样式 示意 图 见图 4和图 5， 具体的组件 形状、 大小、位置、颜色、字体 、数 量 等均可自行规定。 视 频 内 容 切 换 选 项 按 钮 视 角 A 视 角 切 换 标 题 视 角 切 换 标 题 浮 层 背 景 图 视 角 B 视 角 C 图 4 视角切换 组件 样式 1 示意 图 GY/T 332 2020 6 图 5 视角切换组件样式 2 示意 图 5.3 画面 交互 组件 画面交互 组件 包括 以下 互动 参数 配置内容 ： a) 配置 画面交互
17、 标题（可选） ； b) 配置选项按钮及出现时间 ； c) 配置触发 事件 ，包括 ： 默认 、 点击、快速重复点击、长按、滑动、滑动特定路径等方式 ； d) 配置 选项 按钮所触发的 信息。 画面交互 组件 样式 示意 图 见 图 6和 图 7， 具体的组件 形状、 大小、位置、颜色、字体 、数量 等均可自 行规定。 画面互动标题 主视频 可探索视频 画面互动标题 图 6 画面交互 组件样式 1 示意 图 GY/T 332 2020 7 视频场景图 5&vele25&vele25&vele25&vele25&vele25&vele210, actionType: SWITCHVIDEO, n
18、extVideo: video004 , ctrls: / 特殊控件配置，例如倒计时控件 name: countdown-default, prop: time: 7000 , / 特殊控件配置，例如背景音效 name: bgd-audio, prop: audio: backgroundMusic.mp3 , id: video002, filename: video2.mp4 , id: video003, filename: video3.mp4 , id: video004, GY/T 332 2020 46 filename: video4.mp4 , customInteractT
19、emplate: base: template001, metas: style: color: #000, backgroundColor: #000, left: 10, top: 10, width: 100px, height: 10%, opacity: 0.5, rotate: 30 , imgs: style: color: #000, backgroundColor: #000, left: 10, top: 10, width: 100px, height: 10%, opacity: 0.5, rotate: 30 , btns: style: color: #000, b
20、ackgroundColor: #000, left: 10, top: 10, width: 100px, height: 10%, opacity: 0.5, rotate: 30 , ctrls: style: color: #000, GY/T 332 2020 47 backgroundColor: #000, left: 10, top: 10, width: 100px, height: 10%, opacity: 0.5, rotate: 30 GY/T 332 2020 48 附 录 C （资料性） 数据格式示例三 C.1 概述 本附录的数据格式在遵循第 6章规定的基础上，对
21、 脚本文件命名规范、索引脚本结构、互动节点属 性 等内容进行了补充细化。 C.2 脚本文件 集 结构 C.2.1 脚本 文件 集 构成 脚本文件集由 索引脚本文件、资源 文件 两 部分构成， 见表 C.1。 表 C.1 脚本 文件 集 结构 序号 文件 类型 功能 描述 示例名称 1 索引 脚本文件 描述所有的播放区间 、 互动节点和互动组件 信 息 index.json 2 资源 文件 互动节点脚本使用的图像 、 音视频 资源 支持的格式主要包括 ： png、 jpg、 mpg、 mp3、 mp4 button.png C.2.2 脚本文件 命名规范 脚本文件命名规范 见表 C.2。 表 C
22、.2 脚本文件命名规范 序号 文件类型 命名规范 约束限制 1 索引 脚本文件 名称固定为 /ivp/platform/cid/ivp_vid.json 全小写，半角英文 C.3 索引脚本文件 C.3.1 索引脚本结构 索引 脚本文件描述所有播放区间和 互动节点 信息。 其 属性说明 见表 C.3。 表 C.3 索引 脚本属性说明 序号 参数 名称 类型 是否 必填 说明 1 Version String 是 互动脚本版本号 2 Name String 是 互动脚本名称 3 Description String 是 互动脚本描述 4 ControlPanel Dictionary 是 播放控件
23、 UI 描述 5 InteractNode Array 是 互动视频所需的全部 互动节点 GY/T 332 2020 49 表 C.3（续） 序号 参数 名称 类型 是否 必填 说明 6 Video Array 是 互动视频所需的全部播放区间 7 Interact Array 是 互动视频所需的全部 互动组件 8 Medias Array 是 互动视频所需的全部媒体资源，包括图片，音频，视频 示例： Version: 1, Name: 测试互动视频 , Description: 测试视频用于测试目的 , Global: , ControlPanel: , Video: , Medias: ,
24、Interact: , InteractNode: C.3.2 剧 剧的组织，创作者可通过互动 视频制作 平台 将视频文件存储在媒资系统中管理，故此处不做额外说 明。 C.3.3 章 章的组织，同上，基于 互动视频 制作平台 和媒资系统的视频 partId关联管理，此处不做额外说明。 C.3.4 播放控件 播放控件配置 属性说明 见表 C.4,其中 web端 所有 播放控件按钮均可自定义配置。 表 C.4 脚本播放控件配置属性说明 序号 参数 名称 类型 是否 必填 说明 1 backButton Dictionary 是 退出全屏按钮 2 fullButton Dictionary 是 进入
25、全屏按钮 3 interactButton Dictionary 是 直跳互动按钮 4 loading Dictionary 是 加载 图 5 pauseButton Dictionary 是 暂停按钮 6 playButton Dictionary 是 播放按钮 7 reInteractButton Dictionary 是 重头开始按钮 8 storyLineButton Dictionary 是 故事线按钮 9 speedButton Dictionary 是 倍速按钮 10 switchVideoButton Dictionary 是 选集按钮 GY/T 332 2020 50 表 C
26、.4（续） 序号 参数 名称 类型 是否 必填 说明 11 definitionButton Dictionary 是 清晰度按钮 12 customButtons Array 否 自定义按钮 示例： controlPanel: fullButton: , backButton: , interactButton: , loading: , pauseButton: , playButton: , reInteractButton: , storyLineButton: , speedButton: , definitionButton: , switchVideoButton: , cust
27、omButtons: 播放控件元素属性 说明 见表 C.5。 表 C.5 播放控件元素属性说明 序号 参数 名称 类型 是否 必填 说明 1 id String 是 控件元素 id 2 show Number 是 是否展示次控件元素 3 image String 否 控件元素图片 4 defaultStyle Number 否 元素是否使用默认样式： 1 使用默认样式， 0 不使用默认样式 5 style Dictionary 否 元素展示样式描述，默认样式 defaultStyle 为 0 时，此属性必须设置。 6 interactive Dictionary 否 同 C.3.6.3 Int
28、eractive,只有自定义按钮有此属性 示例： fullButton: id:fullButton_1, show:1, image:, GY/T 332 2020 51 text:, defaultStyle:1, style: fontSize:36, color:#44444, selectColor:#ff7777, shadowColor:#888888, backgroundNormalImage:, backgroundFocusImage:, backgroundColor:#000000, backgroundSelectColor:#ffffff, left:94.79,
29、 top:91.85, width:2.92, height:5.19, alpha:100 C.3.5 播放区间 互动脚本播放区间属性 说明 见表 C.6。 表 C.6 互动脚本播放区间属性说明 序号 参数 名称 类型 是否 必填 说明 1 id String 是 播放区间 ID 格式为 Video_+编号 命名示例： Video_1 2 hasInteractive Number 是 播放区间上是否存在交互， 0：不存在交互， 1：存在交互 3 vid String 是 播放区间对应的视频 ID 4 in Array 否 播放区间的来源数组 5 out Array 否 播放区间的出口数组
30、6 isFeedback Number 否 是否错误反馈 播放区间 1： 错误反馈 播放区间 0 或为空 ： 普通 播放区间 7 name String 是 播放区间名称 8 defaultOut String 否 视频播放结束时是否有默认 播放区间 可以播放，为空则 不继续播放，即互动剧播放结束。不为空则为默认播放 的 播放区间 ID 9 image String 是 播放区间 缩略图 GY/T 332 2020 52 表 C.6（续） 序号 参数 名称 类型 是否 必填 说明 10 Videos Array 否 播放区间 上所有弹窗视频 ID,用于预加载弹窗视频 11 isVip Numb
31、er 否 播放区间 是否 vip 播放区间 0：不是 1：是 12 viewports Array 否 播放区间 视频视角窗口描述 13 defaultViewport String 否 默认播放的 播放区间 视频视角窗口 ID 示例： id:branch_274, hasInteractive:1, vid:5162132, image:, name:前期争执 , in:branch_272,branch_273, out:branch_278,branch_279,branch_276, isFeedback:1， viewports: id:viewport_001, x1:0, y1:
32、0, x2:100, y2:100 , defaultViewport:branch_001, defaultOut: image_908, videos: video_001,video_002, isVip: 0 C.3.6 互动节点 C.3.6.1 互动节点 属性 互动节点 属性 说明 见表 C.7。 GY/T 332 2020 53 表 C.7 互动节点 属性说明 序号 参数 名称 类型 是否 必填 说明 1 id String 是 互动节点 ID 本节点内容格式： InteractNode_+编号 InteractNode_为固定字符 命名示例： InteractNode_1 2 V
33、ideo String 是 该 互动节点 所在的播放区间 ID 该节点需在索引脚本文件 Video 节点中存在定义，与 Video 中的 id 节点相对应 3 time String 否 互动节点 开始时间 单位为秒 （ s） 本节点可取值为 0 36000.0 的浮点数 实际取值需要满足以下公式： time 互动节点 所对应的视频片段的总时长 -互动节点 展示时长 4 label String 否 互动节点 的描述 ， 仅用于统计，不用做实际展示 5 actions Array 是 互动节点 展示行为列表 示例： InteractNode: id: InteractNode_001, Vid
34、eo: Video_001, time: 35, label: InteractNode_001, actions: type: OpenInteract, data: target: Interact_1 C.3.6.2 actions 脚本 actions属性 说明 见表 C.8。 GY/T 332 2020 54 表 C.8 脚本 actions属性说明 序号 参数 名称 类型 是否 必填 说明 1 type String 是 表示 互动节点 展示时行为类型，如： OpenInteract 2 data Dictionary 是 表示 互动节点 展示时行为数据，如： target: In
35、teract_1 ，在行为类型为 OpenInteract 时， data 中 target 属性中记录的是 Interact 属性中的 id 示例： actions: type: OpenInteract , data: target: Interact_1 C.3.7 互动因子 互动因子属性 说明见表 C.9。 表 C.9 互动因子属性说明 序号 参数 名称 类型 是否 必填 说明 1 name String 是 互动 因子名称，在本文其他部分中使用的 互动 因子都需 在此处定义 这些部分包括： 互动节点信息 InteractNodes 播放区间信息 Videos 按钮元素信息 butto
36、ns 因子元素信息 factors 2 init String 是 互动 因子初始值，不填写默认为 0 示例： factorList: name:var_24, init:0 , GY/T 332 2020 55 name:var_26, init:0 C.4 互动节点 配置 C.4.1 互动节点脚本属性 互动节点 脚本 属性 说明见表 C.10。 表 C.10 互动节点 脚本 属性说明 序号 参数 名称 类型 是否 必填 说明 1 id String 是 互动节点 ID 本节点内容格式： InteractNode_+编号 InteractNode_为固定字符 命名示例： InteractNo
37、de_1 2 Video String 是 该互动节点所在的播放区间 ID 该节点需在索引脚本文件 Video 节点中存在定义，与 Video 中的 id 节点相对应 3 time String 否 互动节点开始时间 单位为秒 （ s） 本节点可取值为 0 36000.0 的浮点数 实际取值需要满足以下公式： time 互动节点所对应的视频片段的总时长 -互动节点 展示时长 4 label String 否 互动节点的描述 ， 仅用于统计，不用做实际展示 5 actions Array 是 互动节点展示行为列表 示例： InteractNode: id: InteractNode_001, V
38、ideo: Video_001, time: 35, label: InteractNode_001, actions: type: OpenInteract, data: target: Interact_1 GY/T 332 2020 56 C.4.2 互动组件 互动 组件 脚本文件为互动组件样式文件提供组件展示所需必要信息，作为互动组件样式文件的输入， 实现组件内容的动态化处理、展示。 互动 组件 脚本 文件属性 说明见表 C.11。 表 C.11 互动 组件 脚本文件属性说明 序号 参数 名称 类型 是否 必填 说明 1 InteractTemplate String 是 互动组件 样
39、式模板 2 id String 是 互动组件 ID 3 duration String 是 互动组件显示 显示时长 4 profile String 是 交互行为类型 5 skipType String 是 是否可跳过交互， 0 可跳过，继续播放视频， 1：不可跳 过，停止在最后播放帧， 2：可跳过，跳转到默认分支， 需结合 defaultData 字段， 3：不可跳过，循环播放，需 结合 loop 字段 6 defaultData Dictionary 否 skipType 为 2 时，默认跳过时的默认跳转分支，支持可不跳，直接续播。数据结构通 Action 7 loop Dictionar
40、y 否 skipType 为 3 时，不能跳过时，循环播放的起止时间定义 8 texts Array 否 包含了组件中可供内容制作者配置的全部文本元素 9 icons Array 否 包含了组件中可供内容制作者配置的全部图像元素 10 buttons Array 否 包含了组件中可供内容制作者配置的全部按钮元素 11 countTime Dictionary 否 包含了组件中倒计时 UI 信息，只有 InteractTemplate为 countTime 时才有 12 title String 否 包含了组件中标题信息，目前只有 InteractTemplate 为countTime 时才有
41、13 showConditionList Array 否 当组件展示时，元素可能会受到 互动因子 的影响，根据 互动因子 的值来确定是否能够展示，此时可以使用本节 点来判断元素是否满足展示条件 当本节点不为空时展示条件中有任意一条满足则展示元 素，否则不展示 当本节点为空或不存在时默认为展示对应的元素 14 popContent Dictionary 否 当 InteractTemplate 类型为 popOverlay 时才存在此字段描述弹窗显示内容 示例： GY/T 332 2020 57 InteractTemplate: countTime, id: overlay_1, profil
42、e: tap, skipType: 1, texts : , icons : , showConditionList:, duration : 5, title: id: title_001, text: 标题 , defaultStyle:0, style: fontSize: 22, color: #44444, selectColor: #ff777777, shadowColor: #888888, alpha: 100, backgroundNormalImage: , backgroundFocusImage: , left: , top: , width: , height: , buttons: , countTime: id: counttime_001, progressColor: #
