核心功能

统一跨平台原生 AR 桥接

通过一个 Tuanjie API 同时支持 iOS 和 Android 原生 AR 查看器。

iOS 支持

通过 AR Quick Look 加载：

• .usdz
• .reality

Android 支持

通过 Scene Viewer 加载：

• .gltf
• .glb

多种资源来源

支持从以下来源加载模型：

• 本地绝对路径（Absolute Path）
• StreamingAssets
• Web URL

异步 StreamingAssets 加载流程

采用 UnityWebRequest + Awaitable 实现异步加载，并支持临时缓存机制，确保运行时资源加载更加稳定可靠。

进度回调

支持实时获取加载状态：

• progress:download:<0..1>（下载进度）
• progress:load:<0..1>（加载进度）

生命周期事件

支持以下事件回调：

• opened（已打开）
• presented（已显示）
• closed（已关闭）

同时提供结构化错误信息：

• error:...

高级 iOS Sheet 控制

支持配置：

• Detents（停靠高度）
• Grabber（拖拽指示器）
• Corner Radius（圆角半径）
• Edge Attach Behavior（边缘附着行为）
• Selected Detent（默认停靠位置）

高级 Android Scene Viewer 配置

支持配置：

• Mode（查看模式）
• Intent Version（Intent 版本）
• Title（标题）
• Fallback URL（备用 URL）
• Fallback Strategy（回退策略）
• Vertical Placement（垂直放置）
• Occlusion Flags（遮挡选项）
• Target Package Strategy（目标应用包策略）

编辑器验证模式

在真机测试前即可验证：

• 文件是否存在
• 文件扩展名是否正确
• URL 格式是否合法

帮助开发者提前发现资源配置问题。

Tuanjie 原生构建辅助工具

内置编辑器工具窗口，可直接在 Tuanjie 中：

• 构建 iOS Framework
• 构建 Android AAR
• 自动复制和更新原生插件文件

最低平台要求

Tuanjie

• Tuanjie 1.6.x

iOS

• 最低部署目标：iOS 15.6（Framework Target 配置）

iOS 兼容性说明

• 自定义 Sheet Detents（fraction: / height:）需要 iOS 16 或更高版本
• medium 和 large Detents 支持 iOS 15 及以上版本

Android

• minSdk 24（Android 7.0）
• targetSdk 34
• compileSdk 34

Android 原生构建环境

• Java 17（用于 AAR 项目编译）

Android 运行要求

设备需要具备 Scene Viewer 运行环境：

• Google App
• ARCore（取决于启动模式）

集成流程

第一步：添加模型资源

根据平台准备对应格式的模型文件：

iOS

• .usdz
• .reality

Android

• .glb
• .gltf

第二步：调用 API

通过以下接口启动查看器：

并根据需求配置启动参数。

第三步：监听事件回调

监听插件事件以驱动：

• 用户界面（UI）
• 加载状态显示
• 数据统计（Analytics）
• 回退与异常处理流程（Fallback UX）

快速构建专业级的原生 AR 模型预览体验。