简体中文
主题
INFO
- 内容编辑器目前支持模型素材，未来还会支持AR视频、透明视频、音频、图片、粒子特效等素材
概述
当前内容编辑器有什么作用？
- 支持将FBX、OBJ转为Kivicube支持的GLB格式
- 支持后处理效果：色调映射
- 支持可视化的调整模型材质
- 支持可视化的调整灯光渲染
- 可视化预览模型动画
- 查看模型属性，方便查看其是否符合规范
- 模型规范检查，确保传到Kivicube平台后能够高性能渲染
- 更多的模型设置，方便可视化展示模型
使用内容编辑器前的准备工作
注册并登录Kivicube账号
打开内容编辑器后，程序汇自动跳转到登录页面
模型文件准备
我们建议从建模软件中导出FBX格式的模型文件，参考如下教程：
常见问题
| A | 导入到内容编辑器的模型效果与建模软件中不一致 |
|---|---|
| Q | 这是非常正常的现象，内容编辑器与建模软件不是一样的渲染器，有着不一样的灯光环境，所以您需要在内容编辑器中为模型设置材质以及设置灯光环境 |
| A | 导入到内容编辑器的模型丢失了贴图 |
| Q | 这是非常正常的现象，模型在转换的过程中存在丢失贴图的情况，你只需要在内容编辑器中进行材质调整赋予贴图即可 |
| A | 模型导入失败 |
| Q |  |
强制性模型规范
INFO
不满足以下规范的模型不能被导入到内容编辑器中
不支持的glTF扩展
目前Kivicube平台暂时仅支持以下扩展
- KHR_materials_unlit：无光照的模型
- KHR_texture_transform：模型贴图重复
- KHR_materials_pbrSpecularGlossiness：镜面高光工作流的模型，目前Kivicube平台支持，但是导入内容编辑器后会被转换为标准工作流，你可以重新设置材质。
遇到不支持glTF扩展如何处理？
- 如果你是导出FBX，然后再导入内容编辑器，那么不存在此问题。
- 出现此问题，主要是你通过建模软件直接导出GLB文件或者是通过其它渠道获得的GLB文件，请注意导出GLB时请勿导出不支持的glTF扩展。
贴图尺寸超限/贴图格式不支持
- Kivicube平台的模型仅支持JPG/JPEG/PNG格式贴图格式，透明贴图请使用PNG格式
- Kivicube平台的模型的贴图尺寸不能超过2048，并且我们强烈建议贴图尺寸为2的幂次方的正方形贴图（包括22、44、88、1616、3216、6464、128128、256256、512512、10241024、2048*2048）请注意当模型的UV设置为重复模式（Repeat）时，在小程序中使用时，贴图尺寸必须为2的幂次方并且为正方形
INFO
你可以使用Photoshop或XnView将常见的gif/tga/dds/psd/tif/bmp/exr/hdr格式导出为jpg/jpeg/png格式
模型数据命名错误
总的根骨骼不能带动画，如果有动画在根骨上，那就必须给已经带了动画的根骨再绑定一个空的骨骼做父级
模型规范
| 类别 | 规范 |
|---|---|
| 网格数 | 严重：≥10 网格数太多 较严重：5~10 网格数过多 合规：≤5 |
| 三角形数 | 严重：≥6W 三角形数太多 较严重：3~6W 三角形数过多 合规：≤3W |
| 顶点数 | 严重：≥6W 顶点数太多 较严重：3~6W 顶点数过多 合规：≤3W |
| 材质数 | 严重：≥10 材质数太多 较严重：5~10 材质数过多 合规：≤5 |
| 纹理数 | 严重：≥10 纹理数太多 较严重：5~10 纹理数过多 合规：≤5 |
| 动画数 | 严重：≥10 动画数太多 较严重：5~10 动画数过多 合规：≤5 |
| 骨骼数 | 严重：≥120 骨骼数太多 较严重：60~120 骨骼数过多 合规：≤60 |
| 变形数 | 严重：≥30 变形数太多 较严重：10~30 变形数过多 合规：≤10 |
详细使用
模型导入
直接导入
- 支持FBX/OBJ/GLB文件直接导入
- GLTF文件需要先将.gltf、.bin、贴图文件压缩为zip文件导入
从sketchfab导入
注册并登录sketchfab
- 点击登录
- 注册并登录sketchfab
- 接受Kivicube的授权请求
注意事项
- 取消勾选“精选”，去探索搜索更多素材
- 注意素材的许可协议
- sketchfab中预览的模型与导入内容编辑器中的模型效果不一样
用户可以通过设置灯光环境、渲染、材质进行调整，直到调整到满意的效果
优化模型
为了简化操作，我们推出了优化模型的功能，用户可以在此处对模型面数、动画、贴图进行压缩，还可以修改模型中心点。
压缩模型
建议大家使用内容编辑器上传模型后，根据模型实际情况适当压缩，推荐选择“标准压缩”类型。
调整模型中心点
在对模型进行压缩时，可同步重置模型中心点，支持将中心点设置为模型顶部、底部、几何中心，也可选择不修改。
注意：该调整基于模型整体包围盒计算，若修改后无变化，建议回到建模软件中进行调整或检查模型导出是否正确。
灯光设置
若上传的模型带有“金属 / 粗糙度”材质，可在灯光设置中勾选将要创建的场景类型，提前预览灯光效果。
注意：该灯光设置仅用于预览，实际灯光调整需在场景编辑器中操作。
动画设置
若模型自带动画，可在内容编辑器中提前预览效果，检查动画是否正常导出。
注意：此处仅为预览，相关动画设置保存后不会生效
模型保存
模型导入内容编辑器后，点击右上角保存，即可存入 “我的素材”，方便在场景编辑器中调用。
平台会自动检测并给出风险预警，可将鼠标悬浮到感叹号上查看详细内容。为保证 AR 制作与体验流畅，建议使用 “压缩模型” 功能对模型面数、贴图或动画进行压缩，或点进模型规范针对性优化。
模型预览
模型属性
- 请务必通过模型属性检查是否满足模型规范
- 文件：方便定位当前模型文件是什么软件导出的
- 尺寸：长边超过200m的模型导入内容编辑器会被缩小为100m
- glTF扩展：Kivicube目前暂只支持KHR_materials_unlit、KHR_texture_transform、KHR_materials_pbrSpecularGlossiness，当“必选glTF扩展”有这些之外扩展，便不能支持（可能存在加载失败或模型效果不正确的情况）
显示设置
点击保存后，显示设置中的设置，均不会保存，您需要到场景编辑器重新设置
- 模型线框：仅做预览不会保存，场景编辑器中暂不能线框预览
- 模型包围盒：仅做预览不会保存，在场景编辑器中当选中一个对象时，会显示此对象的包围盒
- 模型骨骼：仅做预览不会保存，场景编辑器中暂不能线框预览
- 模型方向轴：仅做预览不会保存，您可以使用场景编辑器中的模型方向轴进行模型的位置调整
- 地面网格：仅做预览不会保存，结合地面网格，您可以方便查看模型是否在中心点与模型的位置、大小、方向
- 背景显示：仅做预览不会保存，通过背景显示方便预览模型
- 视场角：仅做预览不会保存，您可以使用场景编辑器进行视场角调整
材质
选择材质
- 一个模型可能有多个材质，请务必设置好每个材质
- 导入进模型编辑器后，经常会遇到材质贴图丢失，只需要选择相应的材质重新赋予贴图即可
材质设置
材质类型
- 金属/粗糙度：受光照影响，是目前PBR材质标准工作流
- 无光照：即不受光照的材质类型，此种材质类型性能高，仅需一张基础颜色贴图
透明度
| 透明度类型 | **** |
|---|---|
不透明 | 如果需要某个材质不透明，透明度请设置为不透明 |
透明/半透明 | 如果某个材质含有半透明，请设置为透明BLEND |
透明MASK | 如果某个材质含有透明，但是没有半透明，如树叶等，请设置为MASK + 当贴图的透明度大于等于Alpha Cutoff，则会显示为不透明，如果小于Alpha Cutoff则会显示完全透明  |
显示
- 开启双面显示显示会带来更多的性能消耗，若非必要，请勿开启；另外在有些情况下开启双面会带来错误渲染，请参考如下文档序号1描述：模型FAQ
材质属性设置
| 材质属性 | 示意图 | 描述 |
|---|---|---|
| 基础颜色 |  | 为模型添加一个颜色贴图或者直接设置颜色 |
| 粗糙度与金属度 |  | 粗糙度，顾名思义，调整模型粗糙与光滑的值 粗糙度越小，越光滑，粗糙度越大，越粗糙 粗糙度贴图主要控制模型中各个位置的不同粗糙度，达到有些地方光滑，有些地方粗糙的感觉 金属度/金属光泽，顾名思义，调整模型的金属质感  金属度越大，越像金属 金属度贴图主要控制模型中各个位置的不同金属度，达到有些地方偏金属，有些地方偏非金属 |
| 环境遮蔽 |  | 环境遮蔽，即AO贴图，为模型增加阴影细节 有时候为了节省贴图，也将阴影质感直接放到了基础颜色上，从PBR渲染层面，理论上不应该这样做，但是实际可以酌情处理 |
| 自发光 |  | 为模型添加一个自发光贴图或者直接设置发光颜色 |
| 法线 |  | 法线贴图用于增加模型细节的贴图 |
材质贴图
贴图格式
INFO
- 仅支持jpg、jpeg、png格式的贴图，如果是其它格式请转换为支持的格式
- 透明贴图请使用png格式
| 格式 | 转换教程 |
|---|---|
| gif | 使用Photoshop或XnView直接导出为png或jpg格式 |
| tga | 使用Photoshop或XnView直接导出为png或jpg格式 |
| dds | 使用Photoshop或XnView直接导出为png或jpg格式 |
| psd | 使用Photoshop或XnView直接导出为png或jpg格式 |
| tif | 使用Photoshop或XnView直接导出为png或jpg格式 |
| bmp | 使用Photoshop或XnView直接导出为png或jpg格式 |
| exr | 使用Photoshop或XnView直接导出为png或jpg格式 |
| hdr | 使用Photoshop或XnView直接导出为png或jpg格式 |
使用方法：点击“文件”-“打开” 直接打开想要转换的图像文件，然后点击“文件”-“导出”或“另存为”，直接将图片保存为png或jpg格式
贴图尺寸与压缩
- Kivicube平台的模型的贴图尺寸不能超过2048，并且我们强烈建议贴图尺寸为2的幂次方的正方形贴图（包括22、44、88、1616、3216、6464、128128、256256、512512、10241024、2048*2048），请注意当模型的UV设置为重复模式（Repeat）时，在小程序中使用时，贴图尺寸必须为2的幂次方并且为正方形
- 设置合适的尺寸大小：在保证模型效果的情况下，贴图的尺寸越小越好；特殊情况为了保证效果，可以将颜色贴图设置大一些，其余贴图尺寸设置小一些
- 所有贴图都是用工具（图压、ImageOptim）进行压缩，建议默认设置90%的质量，如果质量尚可，还可尝试减少质量到80%，不建议低于80%
- 法线贴图一般为png贴图，压缩后可能依然很大，可以尝试转换为jpg格式压缩。注意：jpg格式的法线贴图很容易丢失质量，请设置合适的压缩质量
- 使用内容编辑器的优化模型
贴图包裹模式与采样方式
TODO
设置展示端
- 分为kivicube平台（图像AR插件）效果与旧版SLAM插件效果
- Kivicube SLAM平台（旧版）仅支持环境光、环境光颜色、平行光、平行光颜色、环境贴图与环境贴图强度
场景类型
- 分为3D互动/图像AR/云识别&陀螺仪与平面AR/漫游AR/世界AR
- 在平面AR/漫游AR/世界AR场景下支持平行光朝向
渲染
后处理效果
- 你可以使用色调映射功能预览效果是否符合预期，但该设置仅作预览，保存后不会生效。
- 若效果符合预期，可在场景编辑器中开启色调映射。
FAQ
TODO