위챗 미니프로그램 메가 플러그인 알려진 문제와 제한 사항

이 글은 메가 미니프로그램 플러그인 사용 중 알려진 문제와 제한 사항을 소개합니다.

위챗 알려진 문제

현재 위챗 xr-frame 또는 VisionKit에서 확인된 결함. 발생 시 AR 기능이 작동하지 않으므로 개발 시 관련 트리거 시나리오에 유의하세요.

위챗 평면 감지 이상

특정 상황에서(예: 화면에 큰 흰 벽이 나타나거나 카메라가 오랫동안 가려진 경우) 위챗이 제공하는 평면 감지가 상태 이상을 일으킬 수 있습니다. 이 상태에서는 MegaTracker가 정상 작동하지 않습니다.

처리 방법 참조 평면 AR 추적기 이상 처리.

Session 초기화 시간이 길다

AR Session은 위챗 평면 감지 초기화가 완료될 때까지 기다려야 초기화를 완료할 수 있습니다. 일부 경우 위챗 평면 감지 초기화 시간이 깁니다.

AR Session이 xr-frame ARTracker 초기화 완료를 기다리는 이유는 MegaTracker가 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.');
    }
}

노드의 worldPosition이 현재 프레임에서 즉시 업데이트되지 않음

이 예시에서 trs.worldPosition이 제때 업데이트되지 않습니다:

public onTick(delta, data) {
    const trs = this.el.getComponent(xrFrameSystem.Transform);
    // 업데이트 전 노드의 WorldPosition
    console.log(`World Position before update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // 업데이트 전 노드의 LocalPosition
    console.log(`Local Position before update: ${trs.Position.x}, ${trs.Position.y}, ${trs.Position.z}`);
    trs.position.x += 0.1;
    trs.position.y += 0.1;
    trs.position.z += 0.1;
    // 노드의 WorldPosition은 업데이트되지 않음
    console.log(`World Position after update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // 노드의 LocalPosition은 업데이트됨
    console.log(`Local Position after update: ${trs.Position.x}, ${trs.Position.y}, ${trs.Position.z}`);
}

개발 시 항상 LocalTransform(el.getComponent(xrFrameSystem.Transform).position 및 el.getComponent(xrFrameSystem.Transform).rotation) 사용을 권장합니다.

화면 방향 전환 이상

위챗 미니프로그램 전역 설정 app.json의 window에 "auto"를 입력한 경우,

가로 모드로 미니프로그램을 종료한 후 세로 모드로 재진입하면 AR 화면에 이상이 발생할 수 있습니다.

따라서 AR 미니프로그램 애플리케이션에서는 절대 "auto"를 사용하지 마세요.

사용 제한

기능 실행을 위한 하드웨어 요구사항. 충족되지 않으면 기능을 사용할 수 없지만, 설정이나 환경을 조정하여 피할 수 있습니다.

기기 제한

메가 미니프로그램 플러그인을 실행하는 기기는 최소 위챗 VisionKit V1 평면 인터페이스를 지원해야 합니다. 이상적인 효과를 얻으려면 위챗 VisionKit V2 평면 인터페이스를 지원하는 기기를 사용하세요.

지원 기기 목록: V2 평면 AR 인터페이스 지원 목록 참조.
빠른 판단 방법:
1. 위챗 미니프로그램 공식 Sample QR 코드를 스캔하세요.
2. 미니프로그램 진입 후, 인터페이스 > VisionKit 시각 능력 > 수평면 AR-v2로 이동하여 현재 기기 지원 여부를 빠르게 판단할 수 있습니다.

VisionKit을 지원하지 않는 기기에서 Mega 서비스를 사용해야 하는 경우, 거의 모든 기기를 지원하는 시야+ AR 내비게이션 제품을 사용하는 내비게이션 시나리오 모범 사례를 참조하세요.

PlaneMode 강제 설정

일부 위챗 인터페이스 지원 제한으로 인해 planeMode는 반드시 1로 설정해야 합니다.

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

GPS 기능 제한

현재 GPS를 통한 Block 정렬은 지원되지 않습니다.

현재 GPS를 통한 주석 데이터 배치는 지원되지 않습니다.

Table of Contents