Table of Contents

Conceito e fluxo da AR Session no plug-in do Mini Program do WeChat

Este documento apresenta o conceito e o fluxo da AR Session no plug-in do Mega para Mini Programs do WeChat.

O que é a AR Session

A AR Session fornecida pelo plug-in do Mega para Mini Programs do WeChat é o ponto de entrada para todas as funcionalidades AR. Ela gerencia o processo de execução e o estado: incluindo a obtenção de dados do VisionKit e das APIs de sensores do WeChat, a fusão do posicionamento em nuvem com os resultados do rastreador AR local, o movimento da câmera e a renderização de outros objetos na cena, entre outros.

flowchart LR
    Pose(Pose da câmera VisionKit) -- Sincroniza a cada frame --> Session[Session]
    Image(Imagem da câmera usada para calcular a pose) -. Enviada apenas no posicionamento Mega .-> Session
    Sensor(Dados do sensor do WeChat) -. Assíncrono .-> Session
    Session -- Transforma --> Camera(Câmera do xr-frame)

Fluxo da AR Session

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

    Init[Inicializando]
    Run[Executando]

    Check{Sucesso?}

    Start -->|Chama start| Init
    Init --> Check

    Check -->|Sim| Run
    Check -->|Não / Tentativas excedidas| End

    Run -->|Chama stop| End

Início: o estado da session muda para Initializing. Inclui verificação do ambiente, carregamento de recursos e espera pelo sistema AR do xr-frame do WeChat ficar pronto.

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

Parada: o estado da session muda para None. Inclui liberação de recursos, redefinição de estado e destruição do MegaTracker.

Aviso

As funcionalidades AR só podem ser usadas após a session ser iniciada com sucesso.

Estados da AR Session:

Estado Descrição
None Estado inicial, session não iniciada ou falha na inicialização
Initializing Em processo de inicialização
Running Em execução, session iniciada e inicialização concluída

[Opcional] AR Session no plug-in do Mini Program do WeChat vs. AR Session no Unity

Nota

Apenas para desenvolvedores migrando projetos do Unity.

A AR Session no plug-in do Mega para Mini Programs do WeChat é uma versão simplificada da AR Session do Unity. Como não suporta o uso simultâneo de outros componentes algorítmicos, ela utiliza componentes de fonte de dados e algorítmicos pré-integrados. O usuário não pode escolher fontes de dados e/ou montar componentes algorítmicos.

Além disso, pode-se considerar que o plug-in do Mega para Mini Programs do WeChat suporta apenas Block como alvo e utiliza o modo central centrado no alvo.

Próximos passos

Tópicos relacionados