已知问题与限制

已知问题

说明:以下问题均已向微信官方反馈,在等待微信修复。如微信官方已修复而该文档未及时更新,请联系我们进行修改。

特殊情况下微信平面检测可能出现异常

插件中提供了出现异常时的回调

出现的情况尚不明确,画面中出现大片白墙,相机长时间被遮挡都有可能导致微信平面检测状态异常

这种状态下MegaTracker无法正常工作

Session初始化时间有时较长

EasyAR Session需要等待微信平面检测初始化完成后才能完成初始化,

一些情况下微信平面检测初始化较长,具体状态参考 微信小程序 AR追踪器状态

也可以在小程序中自行监听XR-Frame AR追踪器状态:

<xr-ar-tracker id="xrARTracker" mode="Plane" bind:ar-tracker-state="handleARTrackerState"></xr-ar-tracker>
handleARTrackerState({detail}) {
    if (detail.value.state == xrFrameSystem.EARTrackerState.Detected) {
        console.log('Plane is now detected by XR-Frame ARTracker.');
    }
}

多次进入AR界面,微信闪退或提示内存不足

XR-Frame存在一定程度的内存泄露。该泄漏出现在小程序内切换页面的时候,关闭小程序会释放。

视频内容随机显示不出来

微信的视频纹理功能尚处于beta阶段,会随机出现播放失败的情况,Android及iOS手机上均有问题,微信暂未提供接口获取视频播放信息。

使用限制

MegaTracker在不支持VK的机型上不可用

插件中提供了判断方法 若不可用请参考微信 VK 适配机型列表: VK平面接口支持设备列表

微信小程序基础库

微信小程序基础库在3.8.8之前使用VK接口会有异常的热功耗问题,因此EasyAR Mega插件不支持低于3.8.8的基础库版本。

PlaneMode不能使用1以外的值

由于部分微信接口的支持问题,PlaneMode不能使用1以外的值。

<xr-scene ar-system="modes:Plane; planeMode: 1" bind:ready="handleReady">

其中planeMode只能设置为1。

暂不支持GPS对齐Block

微信小程序插件上暂不支持通过GPS对齐Block,也不支持通过GPS摆放标注数据。

以横屏模式离开小程序后以竖屏模式重新进入,画面异常

在以横屏模式离开小程序后,如果以竖屏模式重新进入,会出现AR画面异常的情况。