GB-T 43827-2024 手机动漫文件格式

ICS35.040CCSL71中华人民共和国国家标准GB/T43827—2024手机动漫文件格式Mobileanimationandcomicsfileformat(ITU-TT.621Filestructureforinteractivemobilecomicandanimationcontent,MOD)2024-03-15发布2024-03-15实施国家市场监督管理总局国家标准化管理委员会GB/T43827—2024前言 Ⅰ1范围 12规范性引用文件 13术语和定义 14缩略语 25常规表述 26数据类型 27文件格式 27.1文件格式的数据组织方式 27.2文件扩展名 27.3基本文件结构 27.4文件头 37.5资源文件列表 47.6资产清单 47.7影片索引 107.8影片列表 10附录A(资料性)行为列表 14附录B(资料性)动作列表 15ⅠGB/T43827—2024本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定起草。本文件修改采用ITU-TT.621《交互式移动漫画和动画内容的文件结构》。本文件与ITU-TT.621相比做了下述结构调整:—第7章对应ITU-TT.621第7章,增加了7.1;7.2~7.8分别对应ITU-TT.621的7.1~7.7;本文件与ITU-TT.621技术差异及其原因如下:—更改了ITU-TT.621附录A中表A.1的“字段描述”:“手机的旋转变化”修改为“手机中陀螺仪所反映的手机姿态变化”,更符合专业图形学的表述;—更改了ITU-TT.621附录A中表A.1的“值描述”:“前后翻转起始角度”“前后翻转结束角度”Roll”,“水平旋转起始角度”“水平旋转结束角度”合并改为“俯仰角Pitch”,更符合专业图形学的表述。本文件做了下列编辑性改动:—为使标准名称更符合国内行业通用命名方式,将标准名称改为《手机动漫文件格式》。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中华人民共和国文化和旅游部提出。本文件由全国动漫游戏产业标准化技术委员会(SAC/TC536)归口。本文件起草单位:北京邮电大学、华邮数字文化技术研究院(厦门)有限公司、咪咕动漫有限公司、天翼爱动漫文化传媒有限公司、北京邮电大学世纪学院、浪潮云信息技术股份公司。1GB/T43827—2024手机动漫文件格式1范围本文件规定了手机动漫文件的结构。本文件适用于手机动漫文件的组织和存储。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。IETFRFC1321MD5信息摘要算法(TheMD5Message-DigestAlgorithm)ISO/IEC16262信息技术ECMA脚本语言规范(Informationtechnology—ECMAScriptlan-3术语和定义下列术语和定义适用于本文件。动作action用户行为所引起的可以用作动作轨道输出的变化。3.2动画对象animationobject包含资产及其随时间变化信息的物体。3.3资产asset用于制作动画的数字资源,包括位图、矢量图、纹理、子纹理、声音以及影片剪辑等。3.4可以用作动作轨道的输入的用户交互。3.5影片剪辑movieclip可以容纳一个或多个动画对象的容器。3.6子纹理subtexture包含其在纹理中的大小和偏移位置信息的、可以独立使用的纹理一部分。3.7纹理texture可应用在计算机图形学里表面的位图图像。2GB/T43827—20243.8轨道track描述动画对象中单个属性变化的一组数据。4缩略语下列缩略语适用于本文件。GPS:全球定位系统(GlobalPositioningSystem)ID:标识符(Identification)JSON:JavaScript对象符号(JavaScriptObjectNotation)MACF:手机动漫文件格式(MobileAnimationandComicFileFormats)MD5:IETFRFC1321MD5算法,即信息摘要算法5(Message-DigestAlgorithm5)5常规表述本文件中所描述的文件结构称为手机动漫文件格式(MACF)。6数据类型动画文件结构中所使用的数据类型如下所示:—NUMBER(数字类型):双精度浮点数据类型;—BOOLEAN(布尔类型):值为true或false;—STRING(字符串类型):长度可能为0;—ARRAY(数组类型):按某种顺序排序的数据元素的集合;—OBJECT(对象类型):对象类型包含子字段的数据类型。7文件格式7.1文件格式的数据组织方式文件结构中的数据以键/值对的方式存在。文件格式的数据组织方式按照ISO/IEC16262中定义的JavaScript对象符号(JSON)。7.2文件扩展名文件扩展名应为“MACF”。7.3基本文件结构一个手机动漫文件应由文件头、资源文件列表、资产清单、影片索引以及一个或多个影片标记组成。图1描述了文件结构的组成。3GB/T43827—2024图1文件结构7.4文件头7.4.1文件头的结构文件头用来描述文件的基本信息,其中包括:作品名称、作品关键字、作品描述等信息。文件头的键是“head”,值是一个对象。表1描述了文件头的结构。表1文件头的结构字段名称类型是否必填(Y/N)说明headOBJECTY文件头中包含了该文件内容的相关信息7.4.2文件头的属性表2描述了文件头的属性。表2文件头的属性字段名称类型是否必填(Y/N)说明versionSTRINGY文件符合的MACF格式的主版本号;主版本号的变化将不能保证向后兼容性subVersionSTRINGY文件符合的MACF格式的次版本号;次版本号的变化将不能保证向后兼容性nameSTRINGY本文件对应的作品正式名称volumeCountSTRINGY本文件对应的作品总集数volumeSTRINGY本文件对应的作品当前分集keywordARRAYY本文件对应的作品的关键字,关键字之间以逗号分隔STRINGY本文件对应的作品使用的语言,如中文、英文等STRINGY本文件对应的作品的详细描述信息authorARRAYY本文件的创作公司名称和创作者姓名、详细描述等dateSTRINGY本文件的创作日期producerARRAYY本文件的制作公司名称和创作者姓名、详细描述等STRINGY本文件的制作日期4GB/T43827—2024表2文件头的属性(续)字段名称类型是否必填(Y/N)说明publisherARRAYY本文件的发布公司名称、详细描述等publishDateSTRINGY本文件的发布日期copyrightSTRINGY本文件的版权声明7.5资源文件列表7.5.1资源文件列表的结构资源文件列表是包含影片所需的所有资产数据的数组。资源文件列表的键是“files”,值是数组。表3描述了自由文件列表的结构。表3资源文件列表的结构字段名称类型是否必填(Y/N)说明filesARRAYY影片所用到的所有资源文件数据,具体项按表4规定注:本文件对资源文件类型没有限定。7.5.2单个资源文件的结构资源文件列表中的每个项都是一个对象。单个资源文件包含有文件数据,文件数据里包括文件的路径和文件的数据。通常,数据是二进制格式。遵循此标准,二进制数据将以Base64模式转换为字符串数据。哈希数据是通过使用MD5算法转换资源文件的二进制数据而获得的字符串。哈希字符串用于验证资源文件的数据完整性。表4描述了单个资源文件的属性。表4单个资源文件的属性字段名称类型是否必填(Y/N)说明idSTRINGY资源文件的唯一标识符pathSTRINGY资源文件的路径dataSTRINGY资源文件的二进制数据以字符串的形式hashSTRINGY使用MD5算法转换二进制数据而得到的哈希字符串数据,以检验数据的完整性7.6资产清单7.6.1资产清单的数组结构资产清单是包含影片所需的所有资产的数组,资产是指资源文件数据包。5GB/T43827—2024资产清单的键是“assets”,值是包含所有资产的数组。表5描述了资产清单的数组结构。表5资产清单的数组结构字段名称类型是否必填(Y/N)说明assetsARRAYY影片所用到的所有资产数据,具体项见表6所述7.6.2单个资产的结构表6描述了单个资产的结构。表6单个资产的结构字段名称类型是否必填(Y/N)说明idSTRINGY资产的唯一标识符typeSTRINGY不同类型的资产属性不同fileIdARRAYY当前资产所使用的资源文件的唯一标识assetattribute Y不同类型的资产属性列表不同,对于不同类型的资产属性参照表7~表127.6.3资产类型7.6.3.1资产类型的种类资产类型一共有4种:图片、纹理、声音和影片剪辑。7.6.3.2图片的属性图片包含多种属性,有些属性是必填的,有些属性不是必填的,如果某一属性没有填写,则这个属性使用默认值,所有可选属性都有默认值。表7描述了图片的属性。表7图片的属性字段名称类型是否必填(Y/N)说明widthNUMBERY图片的宽度,单位是像素heightNUMBERY图片的高度,单位是像素pivotXNUMBERN默认值是宽度的一半pivotYNUMBERN默认值是宽度的一半maskARRAYN图片的遮罩层的形状,由一系列的点来构成。默认值是nullzOrderNUMBERY图片的层顺序,下面的图层会被上面的图层覆盖pathARRAYN用贝塞尔曲线描述。默认值是nullxNUMBERN图片的X坐标值。默认值是06GB/T43827—2024表7图片的属性(续)字段名称类型是否必填(Y/N)说明yNUMBERN图片的Y坐标值。默认值是0scaleXNUMBERN图片X轴方向的缩放。默认值是1scaleYNUMBERN图片Y轴方向的缩放。默认值是1rotationNUMBERN图片的旋转角度。默认值是0skewXNUMBERN图片在X轴方向上的倾斜角度。默认值是0skewYNUMBERN图片在Y轴方向上的倾斜角度。默认值是0blendSTRINGN当前图片和下层图片的混合方式。默认值是正常visibleBOOLN是否可见。默认值是可见alphaNUMBERN图片的透明度,取值范围是0~1。0表示全透明,1表示不透明。默认值为1注1:遮罩是一个图形,如果图片的遮罩属性不为null,那么这个图片在遮罩图形的区域才会被显示出来,在遮罩图形外的区域不会显示出来。遮罩用一个数组表示,数组中存放多个点的坐标值,它表示把这些点连接起来组成的一个图形,例如:mask:[0,0,100,0,100,100,0,100],它表示一个宽和高都是100的正方形。注2:图片旋转角度由图片X轴和Y轴方向上的倾斜角度共同表示,因此倾斜属性和旋转角度属性是相互独立的。7.6.3.3纹理的属性纹理是指以特定方式布置的多个较小图片组成的图片,每张小图都是一个子纹理。纹理的键是“subTexture”,值是数组,数组中的每一项都是子纹理的一个属性。纹理由一个或多个子纹理组成,图2显示了纹理和子纹理的每个属性的含义。图2纹理和子纹理7GB/T43827—2024表8描述了纹理的属性。表8纹理的属性字段名称类型是否必填(Y/N)说明subTextureARRAYY子纹理即一个纹理中所包含的图片。具体每个子纹理的属性见表9所述表9描述了子纹理的属性。表9子纹理的属性字段名称类型是否必填(Y/N)说明nameSTRINGY子纹理的名称heightNUMBERY子纹理去掉透明区域后的高度widthNUMBERY子纹理去掉透明区域后的宽度XNUMBERY子纹理在大图中X方向位置YNUMBERY子纹理在大图中Y方向位置frameXNUMBERN子纹理补全透明区域后的X方向的位置偏移frameYNUMBERN子纹理补全透明区域后的Y方向的位置偏移frameHeightNUMBERN子纹理补全透明区域后的高度frameWidthNUMBERN子纹理补全透明区域后的宽度注:如果一个子纹理被许多透明区域包围,这些区域可以在形成纹理时被切割以节省空间。7.6.3.4声音的属性声音的属性包含播放和音量。声音的属性一般和时间轴配合使用,应符合表10的规定。表10声音的属性字段名称类型是否必填(Y/N)说明playNUMBERN表示播放的次数。如果为0则表示为循环播放模式volumeNUMBERN表示声音的大小,值的区间是0~100。0表示没有声音,100表示音量最大7.6.3.5影片剪辑的属性图片或者声音再加上时间轴就组成了一个动画对象,一个或多个动画对象就组成了影片剪辑。一个影片剪辑里可以没有任何内容,则把它称为空剪辑。8GB/T43827—2024一个影片剪辑就是一个动画对象,同时也可以是多个动画对象的容器,其属性应符合表11的规定。表11影片剪辑的属性字段名称类型是否必填(Y/N)说明childrenARRAY—影片剪辑里包含的所有动画对象pivotXNUMBERN默认值是宽度的一半pivotYNUMBERN默认值是高度的一半maskARRAYN遮罩层的形状,由一系列的点来构成。默认值是nullzOrderNUMBERY影片剪辑的层顺序,下面的图层会被上面的图层覆盖pathARRAYN用贝塞尔曲线描述。默认值是nullxNUMBERN影片剪辑的X坐标值。默认值是0yNUMBERN影片剪辑的Y坐标值。默认值是0scaleXNUMBERN影片剪辑X轴方向的缩放。默认值是1scaleYNUMBERN影片剪辑Y轴方向的缩放。默认值是1rotationNUMBERN影片剪辑的旋转角度。默认值是0skewXNUMBERN影片剪辑在X轴方向上的倾斜角度。默认值是0。影片剪辑旋转角度由其X轴和Y轴方向上的倾斜角度共同表示,因此倾斜属性和旋转角度属性是相互独立的skewYNUMBERN影片剪辑在Y轴方向上的倾斜角度。默认值是0blendSTRINGN当前图层和下层图层的混合方式。默认值是正常visibleBOOLN是否可见。默认值是可见alphaNUMBERN图片的透明度,取值范围是0~1。0表示全透明,1表示不透明。默认值为1tracksOBJECTY时间轴是一个对象,包含一个或多个属性。时间轴记录的是某个属性随时间变化的数据,不是所有属性都有时间轴。时间轴的结构应符合表13的规定,时间轴的属性应符合表27的规定actionTracksARRAYN动作轨道记录由于用户的交互行为所发生的变化。用户的交互行为有多种类型,具体见附录A表A.1。用户的交互行为引起的变化称为动作,动作也有多种类型,具体见附录B表B.1。动作轨道的结构应符合表15的规定表12描述了动画对象属性。9GB/T43827—2024表12动画对象的属性字段名称类型是否必填(Y/N)说明assetIdSTRINGY资产的唯一标识符,可以通过此ID找到对应的资产数据,通过资产数据可以知道资产的类型nameSTRINGN如果资产是纹理,表示子纹理的名称attributelist—Y不同类型的资产的属性不同。具体每个类型的资产属性见表27tracksOBJECTY时间轴是一个对象,包含一个或多个属性。不是所有属性都有时间轴。时间轴的结构应符合表13的规定,时间轴的属性应符合表27的规定attributenameARRAYN动作轨道记录由于用户的交互行为所发生的变化。用户的交互行为有多种类型,具体见表A.1。用户的交互行为引起的变化称为动作,动作也有多种类型,具体见表B.1。动作轨道的属性应符合表15的规定表13描述了时间轴的结构。表13时间轴的结构字段名称类型是否必填(Y/N)说明attributenameARRAYY属性名称根据动画对象类型不同的而不同。属性名称是键,值是数组,数组中的每一项是一个关键帧,关键帧定义特定时间点的属性值。时间轴的属性应符合表27的规定表14描述了关键帧的属性。表14关键帧的属性字段名称类型是否必填(Y/N)说明timeNUMBERY当前关键帧的时间点valueNUMBERY对应当前关键帧的属性的值curveARRAYN当前关键帧到下一关键帧的补间曲线数据。默认值是null,如果曲线的值是null,表示曲线是折线,属性瞬时变化表15描述了动作轨道的属性。10GB/T43827—2024表15动作轨道的属性字段名称类型是否必填(Y/N)说明STRINGY触发动作的条件类型valueARRAYY触发动作的条件需要满足的值actionSTRINGY触发动作的类型paramsARRAYY触发动作的参数7.7影片索引7.7.1影片索引的结构影片索引是一个数组,数组中包含了影片ID、地址、总时长等信息,但不包含影片的实际数据。一个文件中可以包含一个或者多个影片数据,索引与数据分开存放可以实现边下载边播放的功能。表16描述了影片索引的结构。表16影片索引的结构字段名称类型是否必填(Y/N)说明movieIndexARRAYY影片索引数组基于播放顺序排列。影片索引的属性应符合表23的规定7.7.2影片索引的属性表17描述了影片索引的属性。表17影片索引的属性字段名称类型是否必填(Y/N)说明movieIdSTRINGY影片的唯一标识符addressNUMBERY用于标记内容在文件中的实际偏移量totaltimeNUMBERY影片总的持续时间sizeNUMBERY影片在文件中的实际大小7.8影片列表7.8.1基本结构7.8.1.1舞台坐标影片列表中的每一项表示一个影片。一个影片包含一个舞台,影片中的所有动画对象都会呈现在这个舞台上,图3描述了舞台坐标。11GB/T43827—2024图3舞台坐标7.8.1.2影片列表的结构表18描述了影片列表中存储的所有的影片数据的结构。表18影片列表的结构字段名称类型是否必填(Y/N)说明moviesARRAYY影片数组基于播放顺序排列7.8.1.3影片的属性影片是一种特殊的影片剪辑,所以影片剪辑的所有属性和结构在影片中都有。不同的是影片中的属性和时间轴数据是分开存放的,并且时间轴的数据是按照时间顺序分段存放,这样的结构可以支持实现边下载边播放的功能。表19描述了影片索引的属性。表19影片索引的属性字段名称类型是否必填(Y/N)说明idSTRINGY影片的唯一标识符movieClipIndexNUMBERY影片中所有影片剪辑的索引信息。影片剪辑索引的结构应符合表21的规定movieClipsARRAYY影片中所有影片剪辑的信息streamARRAYY影片中所有影片剪辑的时间轴数据,采用分段描述的方式7.8.2影片剪辑索引影片剪辑索引是一个数组,其中记录了包含所有影片剪辑的索引信息。一个影片剪辑的索引包含了影片剪辑ID、地址、尺寸、生命属性等。表20描述了影片剪辑索引数组的结构。12GB/T43827—2024表20影片剪辑索引数组的结构字段名称类型是否必填(Y/N)说明movieClipIndexARRAYY影片中所有影片剪辑的索引信息表21描述了影片剪辑索引的结构。表21影片剪辑索引的结构字段名称类型是否必填(Y/N)说明mcIdSTRINGY影片剪辑的唯一标识符addressNUMBERY用于标记内容在文件中的实际偏移量sizeNUMBERY内容的长度lifeARRAYY影片剪辑的生命周期注:生命属性表示影片剪辑的生命周期,实际上是影片剪辑的时间轴的一个缩影。生命属性的值是一个数组,包含了该影片剪辑在舞台上出现和消失的时间,例如life:[0,100,400,500],表示该影片剪辑在第0秒时出现在舞台上,在第100秒时消失在舞台上,在第400秒时又出现在舞台上,在第500秒时消失。7.8.3影片剪辑数组表22描述了影片剪辑数组的结构。表22影片剪辑数组的结构字段名称类型是否必填(Y/N)说明movieClipsARRAYY影片中所有影片剪辑的信息注:影片剪辑数组中包含除了时间轴外的所有其他属性,时间轴的属性信息在影片流数据中。表23描述了影片剪辑的属性。表23影片索引的属性字段名称类型是否必填(Y/N)说明idSTRINGY影片剪辑的唯一标识符objectsARRAYY不同类型的对象的属性不同。具体每个类型的对象属性见表127.8.4影片流数组表24描述了影片流数组的结构。13GB/T43827—2024表24影片流数组的结构字段名称类型是否必填(Y/N)说明streamARRAYY分段表述的时间轴信息表25描述了影片流的属性。表25影片流的属性字段名称类型是否必填(Y/N)说明timeStampSTRINGY影片流的时间段timelinesARRAYY影片流的时间轴数据7.8.5时间轴表26描述了影片流的时间轴结构。表26影片流的时间轴结构字段名称类型是否必填(Y/N)说明mcIdSTRINGY影片剪辑的唯一标识符tracksARRAYY影片剪辑的时间轴数据信息。