02 · PRODUCT GUIDES
五种能力，
各有清晰的配置重点。
按准备、配置和检查三个环节阅读。下方提供产品范围与准备要点，具体编辑操作会随功能开放补充。
3D 标准配置器
切换同一商品的 SKU，查看对应材质与部件外观。
- 准备：整理同一商品的颜色、材质、部件与有效变体。
- 配置：关联模型变化与商品选项，明确默认值、互斥和依赖关系。
- 检查：每种有效组合显示正确外观，并匹配当前商品的真实变体。
3D 模组选配
跨商品添加配件与组合，保留各商品的变体和数量。
- 准备：列出主商品和配件各自的变体、数量与搭配条件。
- 配置：设置可添加配件、数量限制、摆放和商家定义的连接点。
- 检查：场景中的每件商品与清单对应；Shopify 分别承接各变体及数量。
3D 产品手册
讲解拆解、卖点、尺寸与效果，可另选目录模板作为入口。
- 准备：整理单品卖点、尺寸、结构说明与预制演示动画。
- 配置：组织热点、尺寸和分解视图；需要多产品入口时另选目录。
- 检查：讲解内容与实物一致，单品手册和可选目录能准确互相关联。
3D 电子色卡
在固定场景或物体中，按所选产品替换指定材质。
- 准备：确定固定主场景、材质商品、色号与对应贴图。
- 配置：将不同产品映射到指定材质区域，检查纹理比例和表面参数。
- 检查：选择产品只替换目标材质，其他区域保留；同时提供实物色号。
3D 装配指南
用预制动画与步骤说明讲解装拆、使用和补充信息。
- 准备：整理安装、拆卸、使用或维护步骤及对应预制动画。
- 配置：按顺序关联动画、相机视角、部件显示和操作说明。
- 检查：每一步目标清楚，播放和切换结果符合实际操作顺序。
03 · PUBLISHING & MAINTENANCE
同一份内容，
发布到客户使用的地方。
Shopify、独立链接和授权域名嵌入共用配置与发布版本。三种入口均纳入首期开发，开放范围以实际验收为准。
- 01
准备内容
维护产品资料与素材，配置选项、材质或讲解内容。
- 02
保存与预览
草稿用于编辑；检查默认状态、组合及各步骤的表现。
- 03
确认发布版本
发布版本固定配置与资源。后续草稿修改需重新确认发布。
- 04
选择入口
按渠道交付同一版本，再根据反馈更新、撤回或回滚。
Shopify 应用
- 首期应用：II3D Configuration 3D&AR。
- 标准配置器、模组选配用于商品主图区；手册和装配指南可放在主图下方。
- 商品价格、库存与购买以 Shopify 为准。首个主题验证基线为 Dawn。
独立链接与目录
- 无需 Shopify 店铺，在 II3D 后台维护产品资料并规划独立展示。
- 五种能力复用同一配置；产品手册可以另选目录入口。
- 适合客户分享与销售讲解，不包含下单购买功能。
授权域名网站嵌入
- 在授权的品牌网站中复用已发布内容，保留原有页面结构。
- 开发者处理初始化、状态事件和组件销毁，核对页面生命周期。
- 购买、询价和复杂业务动作按项目对接，不默认包含通用商城连接器。
04 · ASSET PREPARATION
先准备好素材，
再把细节配置准确。
先区分源素材、网页展示资产和 AR 输出，再确认尺寸、结构、材质与动画。文件后缀相同，也需要检查内容是否符合要求。
用于制作的源素材
CAD、STEP、IGES、FBX、OBJ 等可以作为制作评估资料；需要根据实际结构转换和优化，不等同于后台直接支持上传。
- 确认单位、实物尺寸和装配关系。
- 保留产品、零部件和材质的对应资料。
网页展示资产
首期围绕 GLB 网页模型开发。几何、贴图、材质槽、节点和动画都需检查；文件格式正确不代表内容已通过发布检查。
- 节点、材质和动画命名稳定，便于配置关联。
- 压缩、扩展与加载预算按已验证范围使用。
当前配置的 AR 输出
AR 规划输出 GLB / USDZ，反映当前材质、可见部件与组合位置。实际支持需完成输出检查和真机验证。
- 检查输出比例、材质和模组位置是否一致。
- 明确设备限制，并保留普通 3D 查看方式。
配置前的五项检查
- 商品映射：同一商品的变体与跨商品配件分别整理，不用模型名称代替商品 ID。
- 模型结构：检查实物比例、轴心、命名和部件拆分，确保配置后没有错误显示或位置偏差。
- 材质与色彩：提供 PBR 贴图、真实色号和纹理比例；屏幕预览不能保证与实物完全一致。
- 动画与讲解：手册和指南使用预制动画，核对步骤、热点文字、尺寸及相机视角。
- 性能与设备：同时评估模型、贴图、实例数量和规则复杂度，在实际桌面与手机环境中检查。
05 · AR & AI SCENES
从当前配置出发，
理解真实空间中的效果。
AR 用于查看当前产品或组合的空间效果，AI 用于场景搭配参考。它们与五种产品共享配置上下文，实际开放随设备及服务验证推进。
AR 查看当前产品
- 以当前选择的材质、可见部件或模组组合查看空间效果。
- 进入 AR 前核对尺寸与组合；不同设备与浏览器的能力可能不同。
- 选项配置、拆解讲解与步骤教学在网页中完成。
- AR 不可用或启动失败时，继续使用普通 3D 视图。
AI 场景效果参考
- 使用当前配置的多角度参考与场景图片，规划自动放置或位置引导。
- 场景可来自内置素材、拍摄或上传；使用前确认图片可用于该用途。
- 生成图片用于搭配沟通，尺寸、商品数量和制造信息仍以产品资料为准。
- 点数、使用限额与失败处理按实际开放规则说明，不将参考图作为履约依据。
平台点数与自有密钥
规划中，使用平台凭据消耗团队点数；自有密钥（BYOK）不扣 II3D 点数，供应商费用及限流仍适用。公开价格以实际开放说明为准。
访客限额与失败处理
匿名访客使用由团队账户承担，并设置访客及入口限额。失败或结果不明时先查询任务状态，避免重复提交；扣点与输入保留规则会随服务开放公开。
06 · DEVELOPERS & CUSTOM SERVICES
先确认标准范围，
再衔接您的业务。
网站嵌入从已发布内容开始。SDK 示例、接口字段与错误码会按开放版本提供；额外定价、制造清单和企业系统对接按项目评估。
SDK 与接入参考
接入资料围绕已发布内容、授权域名和共享展示程序组织，具体方法、参数与事件以开放版本为准。
- 最小接入、初始化与销毁。
- 配置状态读写、事件监听与结果承接。
- 截图、AR、AI 调用及错误处理。
- 兼容范围、版本升级与示例。
定制服务与系统对接
制造 BOM、特殊定价和企业流程需要具体的数据与交付范围。模组选配的商品清单不能直接替代生产物料清单。
- 明确商品资料、配置摘要和订单上下文。
- 核对 CRM、ERP、PIM 等系统的字段与接口。
- 单独确认制造物料、定价与部署要求。
- 对外接口以实际开放及联调结果为准。
07 · FAQ & SUPPORT
开始之前，
把关键问题说清楚。
了解渠道差异、素材要求和当前开放范围，避免把展示能力、交易功能与定制服务混在一起。
现在可以直接安装应用或下载完整接口文档吗？
首期产品仍在开发中。本页已公开入门说明、素材准备与产品边界；安装入口、实际操作教程、SDK 示例和主题兼容范围会随验收开放。当前没有公开安装或下载地址，可发送邮件咨询试点与资料准备。
没有 Shopify 店铺，也能使用五种能力吗？
独立 URL 同样纳入首期规划，产品资料可以在 II3D 后台维护。五种能力共用配置与展示程序；独立链接用于展示、交互和分享，不包含下单购买。实际使用入口随发布链路验收开放。
标准配置器和模组选配有什么区别？
标准配置器选择同一商品自身的选项和变体。例如一把椅子切换面料与底座，仍属于这把椅子。模组选配把其他商品作为配件加入同一场景，例如椅子加脚凳，需要保留两个商品各自的变体与数量。
Shopify 和独立链接的展示功能会一致吗？
目标是同一配置、同一发布版本在相同设备环境下复用五种核心展示与交互。Shopify 的页面容器和购买流程另行适配；独立链接不提供购买。AR 还需按设备和平台限制单独验证。
只有 CAD 或其他制作文件，需要先做什么？
先提供源文件、实物尺寸和结构资料，评估模型转换、材质重建与网页优化。制作源文件不等于后台直接可用资产。网页模型、贴图、节点和动画需要通过相应检查后，才能用于配置与发布。
屏幕颜色与 AI 场景图能作为实物依据吗？
终端屏幕未经统一校色，预览不能保证与实物完全一致。关键颜色应同时标注真实色号并提供实物样本。AI 场景图用于视觉沟通；尺寸、商品数量、材料与制造信息以产品资料和正式确认结果为准。
组合很多，会影响加载与操作性能吗？
需要同时评估模型体量、贴图、场景实例数量、规则复杂度和目标设备。不能仅凭组合数量判断，也不能保证它完全没有影响。上线前应在实际桌面与手机环境中检查加载、切换和多实例操作。
生产 BOM、ERP 对接和其他电商平台是否都包含？
模组选配提供商品与变体清单，制造 BOM、特殊定价、ERP/MES 等对接按项目评估。首期电商重点是 Shopify；其他平台属于后续开发计划，不能据此认为已经具备可安装插件或已验证兼容。
DOCUMENTATION SUPPORT
还需要具体说明，
把问题交给我们。
请附上产品类型、使用渠道与当前问题。我们会根据开发与开放进度，说明资料准备、试点范围或定制评估方式。