🚀 Uniapp解锁沉浸式 AR 体验:Jefsky-ios-ar——iOS 端专属 AR 组件来了!

20 阅读2分钟

🌟 插件介绍

Jefsky-ios-ar 是一款基于 SwiftUI、ARKit 和 RealityKit 开发的增强现实 UTS 插件,专为 iOS 平台打造,可轻松加载和展示 USDZ 格式的 3D 模型。无论是电商展示、教育演示还是创意互动,它都能让你的应用瞬间拥有专业级 AR 功能!

✨ 核心功能亮点

1️⃣ 专属 iOS,极致适配

完美支持 iOS 13 及以上系统

基于 ARKit 和 RealityKit 技术,充分发挥 iPhone 硬件性能

2️⃣ 流畅的模型交互体验

🎉 便捷操作:点击平面放置模型,单指拖拽移动

🔍 自由缩放:双指捏合轻松调整模型大小

🔄 灵活旋转:双指旋转实现多角度查看

3️⃣ 强大的模型加载能力

📱 多源加载:支持本地和网络 USDZ 模型加载

🎨 效果优化:新增阴影效果,提升模型真实感

⚙️ 参数可调:支持模型缩放比例自定义

4️⃣ 丰富的自定义选项

可配置选中环参数(半径系数、粗细)

支持操作说明浮层展示

灵活的 API 接口,便于功能扩展

🚀 快速上手

安装方式

在DCloud插件市场导入IOS侧AR UTS插件uni_modules版本,无需复杂配置即可使用。

基础用法

<template>
  <button @click="startAR">开启AR体验</button>
</template>
<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>

模型交互配置

// 自定义选中环参数示例
const AR = plus.ios.import('ARManager')
AR.ringScale = 0.45        // 调整选中环半径系数
AR.ringThickness = 0.003   // 调整选中环粗细(单位:米)

🛠️ 技术特性

  • 高效渲染:依托 ARKit 技术,实现 3D 模型流畅展示

  • 性能优化:针对 iOS 设备进行专项优化,避免卡顿

  • 轻量化设计:插件包体积仅 30KB,不占用过多空间

  • 类型安全:UTS 层二次封装,调用更可靠

📈 未来规划

  • 支持 Android 平台适配

  • 增加更多 3D 模型格式支持

🤝 如何获取

插件市场地址:ext.dcloud.net.cn/plugin?id=2…

版本:v1.0.0

💡 写在最后

Jefsky-ios-ar 致力于为开发者提供开箱即用的高质量 AR 组件,无论是构建 AR 电商应用、教育类 APP 还是创意工具,它都能满足你的需求。现在就集成 Jefsky-ios-ar,为你的应用增添炫酷的 AR 体验吧!