Table of Contents

Conceitos e fluxo de AR Session no plugin Mega WeChat Mini Program

Este documento apresenta os conceitos e o fluxo de AR Session no plugin Mega WeChat Mini Program.

O que é AR Session

A AR Session fornecida pelo plugin Mega WeChat Mini Program é o ponto de entrada para todas as funções AR. Ela gerencia o processo e o estado de execução, incluindo a obtenção de dados do VisionKit e das APIs de sensores fornecidas pelo WeChat, a fusão dos resultados de localização em nuvem e do tracker AR local, e o controle do movimento e da renderização da câmera e de outros objetos na cena.

flowchart LR
    Pose(Pose da câmera VisionKit) -- Sincronizar a cada frame --> Session[Session]
    Image(Imagem da câmera usada para calcular a pose da câmera deste frame) -. Enviada apenas durante a localização Mega .-> Session
    Sensor(Dados de sensores do WeChat) -. Assíncrono .-> Session
    Session -- Transform --> Camera(câmera xr-frame)

Fluxo de AR Session

flowchart LR
    Start((" "))
    End((" "))

    Init[Initializing]
    Run[Running]

    Check{Sucesso?}

    Start -->|Chamar start| Init
    Init --> Check

    Check -->|Sim| Run
    Check -->|Não / número de retry excede o limite| End

    Run -->|Chamar stop| End

Início: o estado de session muda para Initializing. Isso inclui verificações de ambiente, carregamento de recursos e espera até que o sistema AR do WeChat xr-frame esteja pronto.

Execução: o estado de session muda para Running. Nesta fase, session gera resultados de tracking a cada frame e atualiza o Transform da câmera xr-frame.

Parada: o estado de session muda para None. Isso inclui liberar recursos, redefinir o estado e destruir MegaTracker.

Aviso

As funções AR só podem ser usadas depois que session for iniciada com sucesso.

Estados de AR Session:

Estado Descrição
None Estado inicial; session não foi iniciada ou a inicialização falhou
Initializing Em processo de inicialização
Running Estado em execução; session foi iniciada e a inicialização foi concluída

[Opcional] AR Session no plugin WeChat Mini Program e AR Session no Unity

Nota

Somente para desenvolvedores que migram projetos Unity.

A AR Session no plugin Mega WeChat Mini Program é uma versão simplificada da AR Session no Unity. Como o uso simultâneo de outros componentes de algoritmo não é suportado, a AR Session no WeChat Mini Program usa componentes de fonte de dados e componentes de algoritmo pré-integrados. O usuário não pode escolher fontes de dados e/ou montar componentes de algoritmo.

Além disso, pode-se considerar que o plugin Mega WeChat Mini Program suporta apenas target do tipo Block e center mode centrado no target.

Próximas etapas

Tópicos relacionados