移动端webxr ar交互已具备落地能力，但仅限android chrome（v120+）、samsung internet（v19+）、edge for android等支持immersive-ar的环境；ios safari仍不支持，须显式调用navigator.xr.issessionsupported('immersive-ar')探测，启用hit-test与xrcompatible canvas，并严格遵循session生命周期管理。
移动端 WebXR AR 交互在当前（2026 年）已具备实际落地能力，但**必须依赖支持 immersive-ar 会话的浏览器 + 设备组合**。iOS Safari 仍不支持（截至 iOS 17.5），Android Chrome（v120+）、Samsung Internet（v19+）、Edge for Android 是主力可用环境；单纯靠 polyfill 或降级方案无法真正触发空间锚点与平面检测。
判断设备是否真正支持 immersive-ar
不能只检查 navigator.xr 是否存在——很多旧版 Chrome 虽暴露该对象，但不支持 immersive-ar 会话类型。必须显式探测：
- 调用
navigator.xr.isSessionSupported('immersive-ar')，等待 Promise resolve 才能继续 - 若返回
false，说明系统级 AR 支持缺失（如 iOS、部分低端 Android 机型），此时 fallback 到inline模式或提示“暂不支持”更诚实 - 注意：Safari 会直接抛出
TypeError: navigator.xr is not a function，需先做存在性判断
必须启用 hit-test 才能实现真实世界交互
没有 hit-test 特性，你就只能渲染一个固定位置的 3D 物体，无法点击地面放置、拖拽模型贴合桌面。初始化会话时务必声明：
await navigator.xr.requestSession('immersive-ar', {
requiredFeatures: ['local', 'hit-test']
});
-
local是基础空间追踪，hit-test才提供平面/点位检测能力 - 某些 Android 设备（如 Pixel 系列）还需额外开启开发者选项中的 “ARCore 开发者模式”，否则
hit-test返回空数组 - hit-test 结果不是立刻可用的——需在每一帧中调用
frame.getHitTestResults(hitTestSource)，并过滤出hitTestResult.getPose(anchorSpace)有效的结果
Three.js 渲染器必须启用 XR 支持且 canvas 需 xrCompatible
常见错误是直接 new WebGLRenderer() 后就塞进 DOM，这会导致 renderer.xr.setSession() 失败或黑屏：
- 创建 canvas 时必须传入
{ xrCompatible: true }选项：canvas.getContext('webgl', { xrCompatible: true }) - Three.js 渲染器初始化后，需立即设
renderer.xr.enabled = true，再调用renderer.xr.setSession(session) - 渲染循环中，必须用
session.requestAnimationFrame()替代requestAnimationFrame()，否则姿态更新不同步 - 相机矩阵不能靠
camera.position手动更新——要从frame.getViewerPose(refSpace)中提取view.transform.inverse.matrix并赋给camera.matrix
用户手势与 AR 交互必须解耦处理
移动端触摸事件（tap / longpress）和 WebXR 帧循环天然不同步，直接在 onXRFrame 里监听 touchend 会丢失事件或错位：
- 用
addEventListener('click', ...)监听 UI 层按钮（如“放置模型”），再在回调中触发一次 hit-test 查询，获取最近一次有效 hit 结果 - 避免在
onXRFrame内做 DOM 操作或复杂计算——它运行在高优先级渲染线程，卡顿会直接导致 AR 画面撕裂 - 如果要做拖拽，需结合
XRReferenceSpace的getOffsetReferenceSpace()创建相对坐标系，再将手指移动映射为虚拟空间位移，而非简单修改mesh.position.x
最易被忽略的一点：WebXR session 生命周期完全由用户手势驱动。start/stop 必须包裹在用户可感知的交互内（如按钮点击），且每次 session.end() 后不能再复用旧 session ——重新 requestSession 是唯一合法路径。任何试图缓存 session 或跨页面复用的行为，都会在下次进入时触发权限拒绝或白屏。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
