更新记录

0.0.1（2026-08-15）

该插件只支持 iOS（SceneKit）原生格式 .usdz .usd .usdc .scn .dae .obj 不支持 .glb / .gltf（会报 Unsupported iOS native model format，需转成 .usdz）。来源支持三种：远程 HTTPS 链接、本地绝对路径、static/... 路径

平台兼容性

uni-app x(5.24)

tan-3d-viewer

Native iOS 3D product viewer for uni-app x vapor mode.

Usage

<tan-3d-viewer
  class="viewer"
  src="static/product.usdz"
  :auto-rotate="true"
  background-color="#EEF1F4"
  @load="onLoad"
  @error="onError"
/>

.viewer {
  width: 100%;
  height: 900rpx;
}

iOS model formats

The first iOS implementation uses SceneKit and supports native-friendly product formats:

• .usdz
• .usd
• .usdc
• .scn
• .dae
• .obj

For .glb or .gltf, convert the asset to .usdz before using this component.

Props

• src: remote HTTPS URL, absolute file path, or static/... path.
• autoRotate: rotate the loaded model around the Y axis.
• backgroundColor: hex color, supports #RGB, #RRGGBB, and #RRGGBBAA.

Methods

• resetCamera(): restores the initial camera position.