帮助中心

POSTER SHOW 可以为您提供哪些帮助?

从初次查看到模型发布:了解探索 POSTER SHOW、分享方案及管理 3D 内容的步骤。

开始使用增强现实 返回目录

重播 AR 介绍

再次打开增强现实介绍。

POSTER SHOW · 增强现实

走进您的下一个展位。

将展位置于您的空间中。绕着它探索;当设备和安全空间允许时,还可走进展位内部 — 在投入制作之前提前体验。

  • 置于您的空间
  • 近似比例
  • 无需专用应用

打开 3D 视图。在兼容的手机上,选择“在我的空间中查看”。

AR 仅适用于兼容设备。请留意现实环境中的障碍物,并始终核实尺寸。

增强现实指南
展位 3D 渲染图
带有可探索内部空间的公开展位 3D 渲染图。

浏览模型和方案

查找模型

在目录中搜索所需关键词,并用类别筛选器缩小结果范围。打开模型页面,可查看团队提供的完整说明、所含组件和尺寸。

目录仅显示公开模型。不公开列出的模型通过链接分享,不会出现在目录结果中。不公开列出并不等于保密:任何获得链接的人都能在无需登录的情况下打开页面或嵌入模型。请勿用此设置保护机密信息。

旋转、缩放并返回正面

较大的模型可能先显示封面图和打开 3D 模型按钮。需要加载时再选择该按钮;下载较大文件前仍可先阅读详情。如果有优化的移动版,查看器可能使用该版本,同时保留原始文件。

拖动模型可旋转。使用鼠标滚轮、手机上的双指捏合手势或缩放按钮来放大和缩小。要移动取景,请使用鼠标右键或设备支持的双指手势。

重置相机会返回已保存的正面视图和取景。也可开始或暂停旋转,并全屏打开查看器。设备不支持原生全屏时,应用可能在页面内放大查看器。

已保存的正面视图会在暂停旋转的状态下打开,以便检查模型。说明和尺寸由团队提供;查看器不会自动验证这些测量值。

请求报价

公开模型可请求报价。填写联系方式、留言和所需数量,并提供要求的同意。关闭页面前,请等待请求已保存的确认。

请求会关联到所选模型。联系方式会私下存储,供后台跟进。确认请求已保存,并不表示电子邮件已经发送,也不构成报价或商业承诺。

对方案发表评论

对于以不公开列出方式分享的方案,请在评论和变更请求区域说明希望修改的内容。报价请求仅适用于公开目录模型。

评论及其跟进状态在后台中为私密信息。这种私密性只适用于请求及其管理;并不会让方案链接获得身份验证或成为保密链接。

查看图片和视频

模型页面可在 3D 模型之外提供渲染图和辅助视频,用来展示饰面、场景和不同视角。模型发布后,团队可在后台添加这些材料。

返回首页

在你的空间中查看模型

增强现实(AR)可通过手机摄像头或兼容头显中的周围环境视图,让你在计划摆放的位置查看模型,从而了解物体在空间中的位置和存在感。可用性取决于设备、操作系统、浏览器、权限以及加载模型所需的资源。

开始之前

通过 HTTPS 打开模型页面。如果看到封面和打开 3D 模型,请选择该按钮并等待加载完成。随后在查看器中查找在我的空间中查看:只有检测到 AR 能力时才会显示。打开页面或使用全屏仍是在页面中查看 3D;进入 AR 是另一项操作。

请选择地面清晰可见、光线良好且空间充足的区域。允许设备请求的摄像头或空间访问权限。移动时注意真实家具、人员和其他障碍物。

iPhone 和 iPad

  1. 在 Safari 中打开模型页面并加载模型。iOS 上的 Chrome 和 Firefox 也可能通过 Quick Look 打开体验;若链接在其他应用内打开,请尝试 Safari。
  2. 选择在我的空间中查看,等待模型为 Quick Look 准备就绪,并按提示使用摄像头。
  3. 将设备朝向地面并缓慢移动,直到可以放置模型。用可用控件调整显示。
  4. 关闭 Quick Look,返回模型页面继续以 3D 浏览。

此体验使用 Apple Quick Look。iOS 上 Chrome 和 Firefox 的支持得益于 model-viewer 的官方修复,但仍取决于设备和浏览器。此版本尚未在实体 iPhone 或 iPad 上验证 AR。

Android

  1. 在兼容 AR 的 Android 设备上用 Chrome 打开模型页面并加载模型。
  2. 选择在我的空间中查看,并授予浏览器请求的权限。
  3. 朝向地面,缓慢移动手机,并按说明放置模型。
  4. 使用可用控件退出 AR 会话,返回页面中的 3D 查看器。

Android 上的体验使用浏览器 WebXR,并非所有 Android 设备都支持。请参阅 model-viewer 的 AR 要求和模式,了解支持检测、HTTPS 和地面放置。

Meta Quest — 实验性功能

Meta Quest Browser 支持带透视的 WebXR AR 会话,可通过头显看到实际空间。本应用的 AR 体验尚未在实体 Meta Quest 上验证。出现按钮并不保证每个模型或控件都按预期工作。请参阅 Meta Quest Browser 中的混合现实。

初始比例可采用团队校准的参考值,但位置可能需要手动调整。此实验选项不保证在头显中自动检测或对齐地面。

  1. 在 Meta Quest Browser 中打开模型页面。页面先显示在普通浏览器面板中,可阅读信息并以 3D 浏览模型。
  2. 加载模型;若可用,选择在我的空间中查看。允许浏览器请求的空间访问,以尝试带透视的沉浸式 AR 会话。
  3. 按会话说明检测地面和放置模型,并远离实际障碍物。
  4. 用可用退出控件结束 AR 会话,返回浏览器面板中的页面。

若按钮未出现、会话未启动或控件无响应,请继续在页面中以 3D 浏览模型。仅在头显中打开网站不会自动启动沉浸式会话。

放置、比例和大文件

体验按地面放置配置。若模型不能落在地面上,请换到光线更好的区域,让地面保持在视野内,并缓慢移动设备以帮助检测表面。

比例可以调整。团队保存 AR 校准参考后,模型会按该测量值开始显示,同时在三个维度上保持比例。估算参考会标注为近似比例。没有校准时使用文件中的比例;页面文字所示尺寸不会自动改变它。AR 仅用于观察环境中的模型,制造或安装前应另行确认测量值。

几何体密集或纹理较大的模型,即使可在 3D 查看器中运行,也可能加载更久、无法在 AR 中打开或导致浏览器关闭。发生这种情况时返回页面,请团队提供更轻量版本。优化的手机版本不保证在头显上表现良好。

实体放置、表观比例和运动跟踪必须在目标设备上检查。模拟的移动屏幕不能验证真实 AR 体验。

返回首页

在后台发布和管理

后台位于 /admin,需要管理员权限。请向目录负责人申请访问权限。切勿把凭据放入说明、公开消息或上传文件。

准备发布

  1. 输入名称、公开地址、说明、类别、所含组件和可用尺寸。没有可靠依据时不要估算尺寸。
  2. 选择模型显示在目录中,还是仅通过链接访问。
  3. 选择文件并准备模型,查看导入和优化警告。
  4. 在预览中检查材质、纹理和方向;对齐正面并保存封面图。
  5. 发布后打开生成的页面,检查显示效果再分享链接。

支持的源格式:

格式准备方式
GLB单文件 3D 模型,发布前验证。
STL使用所选材质转换为 GLB;STL 不含纹理。
ZIP 中的 OBJZIP 必须恰好包含一个 OBJ,以及其 MTL 和所需纹理,并保留文件间相对路径。

记录的源文件限制为每个文件 1000 MB,并受安装配置约束。ZIP 最多可含 512 个文件。STL/OBJ 在浏览器中转换。发布只保存生成的 GLB,并不备份工作文件;请保留原件。

准备过程可优化纹理并显示前后结果。若优化损害效果,可在提供该选项时保留原始版本。已发布模型不会自动替换成优化版本。

设置正面、坐标轴和封面

设置正面前先取景并让模型直立。90° 控件可修正侧躺模型。检查缩略图,它将用作发布内容的展示图片。

编辑现有模型时,设置正面视图并保存封面会保存正面和封面图。请等待出现正面和封面已保存。名称、说明或可见性的待处理更改需另行保存。

所选正面也定义旋转轴:模型的前、右和上方。保存前确保直立。旧正面视图会在保留现有 GLB 的同时适配显示。预览、公开页面、嵌入、相机重置和 AR 使用同一参考。新截图还保存取景参考,以适配不同屏幕形状的缩放;没有该参考的旧记录可能需重新保存正面视图。

校准 AR 比例

发布或编辑时,启用校准 AR 比例,并输入一个以米为单位的实际测量值:高度、宽度或深度。初始选择高度,但在你输入前其值为空。使用已知测量值;若为估算值,保持启用估算测量值。

参考值覆盖直立于已保存正面视图中的整个模型(包括底座)两端。一个测量值会统一缩放三个维度并保持比例。页面上的技术尺寸彼此独立,不会自动复制到校准。

保存更改或发布模型以应用参考。要删除它,请禁用校准 AR 比例并保存。现有模型在启用校准前保留文件比例。改变正面方向或替换文件后应复核测量值。此参考用于空间可视化,不认证制造或安装尺寸。

替换文件而不改变链接

编辑模型时使用文件替换。确认前准备并检查新模型。替换会保留发布地址及其他信息。可以选择新正面和封面;否则沿用原设置。请检查结果,因为比例不同的文件可能需要不同取景。

添加渲染图和视频

发布后,在模型后台编辑器中上传关联材料。限制如下:

材料格式限制
渲染图或图片JPEG、PNG、WebP每个文件 20 MB
视频MP4、WebM每个文件 1000 MB
模型图库图片和视频合计最多 24 项

这些材料用于补充 3D 模型,不替代其 GLB 或随正面视图保存的封面。最大上传大小不保证每个浏览器都能播放;视频编码和设备资源也有影响。从图库移除项目会解除它与发布内容的关联,但文件仍留在存储中,也不会撤销通过已分享文件 URL 的访问。

跟进请求

报价请求在 /admin/quotes 管理。商业状态与通知状态相互独立:即使没有发送电子邮件,请求也可能已保存。

重新发送通知仍依赖已配置的服务密钥和已验证发件人。在配置和投递验证完成前,请在后台跟进请求。不公开列出方案的评论和变更请求也在后台私下管理。

管理客户访问权限

客户账户只能由授权员工在 /admin/customers 创建和管理;不提供公开注册、SSO 或 Supabase 登录。请通过安全渠道向客户提供临时密码。密码只在创建或重置时显示,有效期为 7 天,首次登录时必须更改。重置密码会撤销现有会话。客户专区目前只提供账户访问;Studio 和项目工作区尚未实现。

翻译模型内容

使用模型翻译编辑器翻译标题、描述、类别、组件列表和媒体说明,而不会更改葡萄牙语源内容、几何体、尺寸或文件。未完成的工作应保存为待审核。只有已审核且源版本仍为最新的翻译才会公开显示;缺失、待审核或已过期的翻译会明确回退到葡萄牙语。源内容更改后,请先比较所有字段,再重新标记为已审核。

返回首页

分享和嵌入

用复制模型链接分享页面。要在网站显示模型,请复制应用提供的嵌入代码,并确认网站编辑器允许 iframe。

要在 iframe 中使用 WebXR,请保留 allow="fullscreen; xr-spatial-tracking" 并使用 HTTPS。若以前复制过旧嵌入代码,请替换为当前代码。宿主网站的权限也可能阻止 AR。打开完整模型页面可帮助区分网站权限与设备限制。参阅 model-viewer 的 AR 和嵌入要求。

分享或嵌入不公开列出的模型,仍会让所有获得链接的人访问。请勿在页面或关联文件中放置机密信息。

返回首页

通过 MCP 使用助手

经授权的 MCP 集成可通过 POSTER SHOW MCP 端点,使用 Streamable HTTP 传输读取和管理发布内容。在 MCP 客户端配置 Authorization: Bearer <integration token>。尖括号内仅为占位符:请向管理员获取令牌并保存到客户端的安全配置中。该令牌与后台访问权限不同,切勿粘贴到公开内容。

以下工具使用 model,以 slug 或 UUID 标识发布内容。调用前查看 tools/list 以获取完整的当前架构。

工具主要参数行为
list_models无参数:{}。列出发布内容(包括不公开列出的模型)及页面和嵌入链接。
get_modelmodel。读取发布数据和链接。
publish_glb_from_url必需:title、slug、glbUrl、posterUrl。可选:description、category、composition、dimensions、arCalibration、visibility、backgroundColor、autoRotate、frontView。从公开 HTTPS URL 导入 GLB 2.0 文件和封面,返回发布内容及准备诊断。可见性默认为 public;仅链接分享请用 unlisted。
replace_model_from_urlmodel、glbUrl;可选 frontView。替换 GLB 并保留发布数据和链接。使用 update_model 更改相应封面。
update_modelmodel 及要更改的字段:title、slug、description、category、composition、dimensions、arCalibration、visibility、backgroundColor、autoRotate、frontView、posterUrl、mobileAsset。仅更改提供的字段。mobileAsset 关联已准备的移动版本。
attach_model_mediamodel、pathname;可选 caption,最多 500 个字符。将已通过认证后台上传到该模型 Blob 媒体文件夹的文件关联到模型。检查所有权、类型、大小和签名;不会上传文件或导入任意 URL。
edit_model_mediamodel、items:包含 UUID id 和最多 500 字符 caption 的完整有序对象列表;最多 24 项。设置图库顺序和说明。遗漏项目会解除关联,其 Blob 文件仍保留。架构公开 revision 时(尤其移除项目时)使用当前图库修订版。
get_model_translationmodel、locale。读取葡萄牙语源内容、独立翻译、当前源哈希、不透明修订版和翻译状态,不更改几何体或资源。
update_model_translationmodel、locale、当前 sourceHash、当前 revision(缺失时为 null)、完整翻译 fields 和 reviewStatus。仅保存显示文本。待审核或已过期的条目不会公开显示;说明中必须包含所有原始媒体 UUID,发生冲突时请先重新读取。
delete_modelmodel、confirm: true。永久删除发布内容及其文件,这不同于从图库解除项目关联。

转换 STL 或 OBJ ZIP 请使用后台准备;按 URL 发布只接受 GLB。

按 URL 发布时,GLB 和封面必须有公开可访问的 HTTPS URL;不接受本地地址和专用网络。记录的限制为 GLB 1000 MB、封面 12 MB。MCP 封面限制与图库渲染图限制相互独立。

让助手更改前先读取模型,并在之后检查保存结果。update_model 中省略字段会保留当前值。edit_model_media 中的 items 是完整的目标图库:按正确顺序包含所有要保留的项目。解除关联不会删除 Blob,也不会撤销通过之前分享的文件 URL 的访问。

技术数据支持最长 20,000 字符的说明、最长 100 字符的类别和最长 10,000 字符的组件列表。dimensions 接受以米为单位的 width、height 和 depth;只提供已知测量值。远程发布和替换会保留收到的纹理;纹理优化可在后台准备时使用。

要校准 AR 比例,arCalibration 接受 axis(width、height 或 depth)、meters(最大 10,000 的正数)和 approximate(必需的布尔值)。提供已保存正面方向中包括底座在内的完整模型测量值。arCalibration: null 删除参考;更新时省略则保留。此参考与 dimensions 相互独立。

frontView 包含相机、目标和方向;取景可含 fieldOfView 和 framingAspect。角度以度为单位,半径和目标坐标以米为单位。省略会保留正面;frontView: null 恢复默认视图。匹配封面使用 update_model.posterUrl。

对于技术操作人员,update_model.mobileAsset 接受已准备的 GLB 版本,其中含 HTTPS url、HTTPS sourceUrl 和以字节计的 size。sourceUrl 必须匹配当前原始 GLB URL:变体会关联到来源而不替换它。mobileAsset: null 删除关联。此字段不会自动生成或上传变体。

这些 MCP 工具不公开报价请求、评论和变更请求;它们只能在已认证后台管理。重新发送通知仍需服务密钥和已验证发件人;请求已保存并不表示电子邮件已发送。

返回首页

常见问题

搜索不到模型,它被删除了吗?

不一定。清除搜索和类别筛选器。不公开列出的模型只能通过链接打开,不会出现在目录中。如果有链接但页面不再打开,请向团队确认地址或发布内容是否更改。

旧说明被截断了,应用能恢复缺失文字吗?

不能。说明现在最多支持 20,000 字符,但旧限制删除的文字无法自动重建。请从原始来源恢复并重新保存。页面应显示实际存储的内容。

为什么没有增强现实按钮?

若出现打开 3D 模型,请先选择并等待加载。只有查看器检测到 AR 支持时才显示在我的空间中查看。检查 HTTPS、权限和浏览器:兼容 iPhone/iPad 上的 Safari、Chrome 或 Firefox;兼容 Android 上的 Chrome;Meta Quest Browser 为实验选项。若处于其他应用内,请直接在浏览器打开链接。AR 不可用时仍可浏览 3D 模型。

我在 Meta Quest 打开了页面,为什么模型在面板里?

这是正常浏览器模式。要尝试把模型放入实际空间,请加载模型并在按钮可用时选择在我的空间中查看。只有该操作会请求带透视的沉浸式 AR 会话。Meta Quest 支持为实验性,尚未在实体头显上验证。

如何退出 AR 并返回 3D 模型?

在 iPhone/iPad 上关闭 Quick Look。在 Android 或 Meta Quest 上,用可用控件结束 AR 会话并返回页面。之后可再次在查看器中旋转、缩放和取景。

模型能以 3D 打开,但 AR 很慢或失败,怎么办?

准备 AR 以及使用摄像头或沉浸式会话可能需要额外资源。等待准备;若失败,返回页面,检查权限并尝试更轻量版本。团队应减少几何体或纹理,并在目标设备上检查结果。移动变体不保证 Meta Quest 性能。

1000 MB 文件能在手机上运行吗?

无法保证。上传限制不是查看内存限制。几何体、纹理、转换和其他打开的应用可能需要超过设备可用资源。请准备更轻量版本,并在具有目标受众代表性的手机上检查。

带 8K 纹理的模型失败或导致页面关闭,怎么办?

8K 纹理解码后可能占用大量内存,即使压缩文件看起来很小。多张纹理和 AR 转换会增加内存压力。降低纹理分辨率和模型复杂度,重新准备并测试发布内容。与 8K 相关的故障可能是内存问题,但不能据此判定每个错误的原因。

AR 比例与页面尺寸一致吗?

页面尺寸不会自动校准 AR。团队可以用已知或估算的高度、宽度或深度保存单独的比例参考;估算值会标为近似比例。没有该参考时使用文件比例。在屏幕上调整模型不能认证实际制造或安装尺寸。

请求已确认,但没有收到电子邮件。

请求仍可能已正确保存。电子邮件投递是独立过程,取决于服务配置和投递情况。团队应检查后台记录;未收到邮件不一定表示请求丢失。

模型可在网站打开,但嵌入后 AR 不工作。

更新 iframe,使其包含 allow="fullscreen; xr-spatial-tracking",并检查 HTTPS 和宿主网站权限。也请尝试打开完整模型页面。参阅官方 AR 要求。

不公开列出的方案是私密的吗?

它不会出现在目录中,但其链接不要求身份验证。后台中对评论的私密处理不会限制模型本身的访问。机密内容需要单独的访问控制机制。

返回首页

虚拟展会

虚拟展会 · 产品目录

展会会根据公开产品自动更新。参观期间每分钟检查一次列表;新的 3D 文件会先经过验证。 展会中的 3D 模型正在准备或暂不可用。请查看产品详情。

走进展会,探索品牌空间的更多可能。

展会仅展示公开产品。目录定期确认,展位优先,按类别分区。在地图中搜索并选择“前往产品”。附近模型加载为 3D,其他模型可能显示为简化标记。VR 需要手动进入,不会自动开启摄像头。使用传送和分步转向;连续移动为可选功能。场景内控件可暂停、返回入口、打开帮助和退出。

拖动场景查看四周。使用摇杆或 WASD/方向键移动。

点击地面沿路线前进。选择展位近距离查看,之后随时返回探索。

选择模型会打开产品卡片,但不会移动视角。使用 近距离查看 查看模型,再用 返回探索 回到之前的位置。

比例为近似值。生产或安装前请核实尺寸。 目的地是展位入口;内部路线尚未验证。

实验性 VR:需要兼容的浏览器和头显。尚未在 Meta Quest 2/3 真机上验证。

无法确认产品目录。展品暂时隐藏。 3D 视图暂不可用。您仍可在旁边搜索并打开产品。

返回首页