配饰工厂配饰资源包标准

2021-06-24 by uino 192 标准 配饰 资源工厂

1配饰包命名规则

  • 有主题资源为:配饰名称-主题名称,可以为两段或三段,中间用中划线分隔;
  • 无主题资源为:配饰名称,会放入资源网站中无主题资源;

2配饰包目录

2.1目录结构

[root@localhost 配饰包]# tree
.
├── frame.js
├── images
│   ├── iconImages
│   │   ├── instance.png
│   │   └── main.pnginstance
│   ├── lineImages
│   ├── mapImages
│   └── panelImages
├── models
│   ├── c07e865860904dc6980ab2e7df1d8686
│   └── ff6fffd7776c40b0882962530e7d12cd
├── particles
│   └── 18100916vuhgsdtljucvrysf9wftwufb
├── preview.png
└── resource.json
  • 一级目录包括frame.js,images,models,particles,preview.png,resource.json,其他images,models,particles根据需要进行增加。

2.2目录文件说明

  1. Images
    • Images文件夹下存放图片类资源,不同的配饰种类需要存放在不同文件夹下,iconimages中存放点类配饰,lineimages存放线类配饰,mapimages存放面类配饰,panelimages存放面板类配饰。
    • 各文件夹下的图片大小建议为:2的n次方2的n次方(n可不一致),例如128256
    • 当一个配饰类(例如点)中的背景图需要颜色可配置时,需要通过程序实现颜色变化,此时需要将背景图命名为main.png,并且需要变色的底图需要设置默认白色,function.png为当有多个图片需要为白色底图时做扩展使用。
    • panelimages可存面板图片,由于面板类配饰需要根据输入的文字内容长度大小自适应,面板设计图图片的上下左右中间设置一段可拉升的线,线使用白色做标识,方便开发识别。
  2. models
    • 存放模型包的文件夹,每个模型是单独一个文件夹,文件夹名称使用模型ID命名,当配饰是组合模型类配饰时,可以在models中存放多个模型包;
    • 存储3D MAX工具生产的gltf包(按照模型贴图标准提供);
  3. particles
    • 存放粒子包文件夹,每个粒子效果是一个单独文件夹,文件夹名称使用粒子ID命名,当配饰是组合粒子类配饰时,可以在particles中存放多个粒子包;
    • 粒子制作基于粒子编辑器标准;
  4. preview.png
    • 为配饰在资源网站呈现的预览图,名称默认为preview,格式可以为gif、png、jpg,分别率默认为960*540,preview.png必须放在配饰包根目录下;
  5. resource.json
    • 样例数据
{
    "date": "2021-06-10 12:22:05",
    "description": "分水器图标配饰_顶部标题",
    "license": "优锘科技版权所有",
    "name": "分水器-顶部标题-太空旅客",
    "theme": "太空旅客",
    "type": "decor",
    "themePath": "配饰/标记点/模型类/通用模型",
    "author": "活力28",
    "tid": "00000001-000000001",
    "rid": "0",
    "version": "3.1.0",
    "thingjsVersion": "0.0.0.0-1.2.0.0",
    "resourceJsonStdVersion": "4.1",
    "plugInStdVersion":"1.2",
    "dpdVersion": "3.0.0",
    "extend": {
        "_title_": "扩展描述"
    }
}
  • 字段说明
字段 描述 是否必填 维护者
name 配饰资源包名称,中英文不限,同一个主题下资源不允许重名,无主题资源名称可以重复(资源网站显示配饰包名称、name的名称,配饰zip包名称三者一致,zip包名称使用者可以自定义修改) 必填 生产者
tid 资源映射ID,资源网站识别某资源应该放入到资源网站哪个坑位时使用,8位(主题ID)-8位(坑位ID),从0开始自增 必填 资源网站
rid 数据库自增主键,资源网站生成,从0开始,最大不超过16位 必填 资源网站
theme 配饰资源的主题名称,表示配饰所属那个场景主题,没有主题不填 选填 资源网站
type 资源类型,配饰资源类型默认为decor,其他资源详见类型字典 必填 资源网站
themePath 资源路径,例如:配饰/标记点/模型类/通用模型 必填 资源网站
date 资源正式发布以或者更新后的时间,时间格式 yyyy-MM-dd HH:mm:ss,版本变化后时间会变化,由资源网站统一写入,资源工厂不填 必填 资源网站
description 配饰资源包的相关描述,可自定义 选填 生产者
license 优锘公司生产的配饰为固定“优锘科技版权所有”,可以为组织或个人名字(授权声明) 必填 生产者
resourceJsonStdVersion 使用的规范版本,当前版本为:4.1 必填 资源网站
plugInStdVersion 插件资源包生产本身的标准的版本号,此文档当前版本为1.2 必填 生产者
version 资源版本号,对同一个资源(rid相同)进行修改试,配饰编辑器中默认版本号自动递增。大版本-小版本-bug修复版本,例如:3.1.0 必填 资源网站
thingjsVersion thingjs版本号,命名规则:x.y.z.n x大修改(原来功能用不了), y为新增功能,z修复bug需调整接口,n纯bug修复,例如: 1.2.7.20,两种格式,0.0.0.0-1.2.7.0(区间),1.2.0.0(1.2.0.0及以上版本可用),不填代表全部兼容 选填 生产者
dpdVersion 依赖的核心组件版本号,[核心组件1名称(两种格式,0.0.0-2.6.0(区间),3.0.0(3.0.0及以上版本可用),不填代表全部兼容),核心组件2名称(两种格式,0.0.0-2.6.0(区间),3.0.0(3.0.0及以上版本可用),不填代表全部兼容)] 选填 生产者
author 资源包生产的作者,登录资源网站会获取作者 必填 资源网站
extend 自定义拓展属性,添加自定义属性时使用 选填 生产者

2.3类型字典

资源工厂 资源类型
图层 layer
图表 chart
业务 business
操作集 action
3D配饰 decor
效果模板(园区) theme_campus
效果模板(地图) theme_map
物体面板 panel
场景控制 control
核心插件 core
皮肤插件 skin
拓展插件 expand