更新记录

1.0.1（2025-07-22）

修改模型选中效果：新增阴影效果，去除选中环效果 修复本地路径无法访问问题 修复选中时，模型被拆分

1.0.0（2025-07-18）

| 0.3.0 | 新增本地路径加载；脉冲虚线环；操作说明浮层 | | 0.2.0 | 环参数可配置；平面检测反馈优化 | | 0.1.0 | 基础功能：模型加载/放置/交互与选中环 |

平台兼容性

云端兼容性

uni-app(4.74)

uni-app x(4.74)

Jefsky-ios-ar UTS 组件（iOS）使用说明

仅适用于 iOS 端；Android 正在开发中。

1. 系统要求

真机需具备 A9 及以上芯片以支持 ARKit。

2. 安装与工程配置

1. 将 uni_modules/Jefsky-ios-ar 目录拷贝/拉取到项目根目录。
2. 在 Xcode → Signing & Capabilities 中添加相机权限：

   Privacy - Camera Usage Description : 用于 AR 场景摄像头捕捉

3. 确保 iOS Deployment Target ≥ 13.0。

3. API 速览

所有方法均通过 plus.ios.import('ARManager') 暴露，已在 UTS 层做二次封装，可直接按示例调用。

4. 使用示例（Vue / UTS）

<script setup lang="uts">
import { openAR, loadModel } from '@/uni_modules/Jefsky-ios-ar/index.uts'

function startAR () {
  openAR({
    success () {
      loadModel({
        url: 'https://example.com/model.usdz',
        // scale: 0.5, // 若需手动缩放
        success () {
          uni.showToast({ title: '模型加载成功' })
        },
        fail () {
          uni.showToast({ title: '模型加载失败', icon: 'none' })
        }
      })
    },
    fail () {
      uni.showToast({ title: 'AR 启动失败', icon: 'none' })
    }
  })
}
</script>

5. 运行时交互

当模型被选中时，会出现脉冲虚线环指示，可通过以下代码微调：

const AR = plus.ios.import('ARManager')
AR.ringScale = 0.45        // 环半径系数
AR.ringThickness = 0.003   // 环条粗细 3 mm

6. 支持的模型路径

1. 远程 URL (http / https)：SDK 自动下载后解析。
2. 本地文件：先通过 plus.io.convertLocalFileSystemURL() 转换为绝对路径，再传入 loadModel。

7. 常见问题

8. 版本日志