O que são Everywhere Actions?

As Everywhere Actions da Needle são um conjunto de componentes cuidadosamente selecionados que permitem criar experiências interativas em Unity sem escrever uma única linha de código. São desenhadas para servir como blocos de construção para experiências na web, mobile e XR, incluindo Realidade Aumentada em iOS.

A partir de triggers e actions de baixo nível, podem ser construídos comportamentos interativos complexos de nível superior.

Plataformas Suportadas

• Desktop
• Mobile (Android / iOS)
• Óculos VR
• Dispositivos AR
• iOS AR – QuickLook (sim, é verdade!)

Como usar Everywhere Actions?

Para suporte iOS, adicione o componente USDZExporter à sua cena. É uma boa prática adicioná-lo ao mesmo objeto que o componente WebXR (mas não é obrigatório).

Para adicionar uma action a qualquer objeto na sua cena selecione-o e depois clique em Add Component > Needle > Everywhere Actions > [Action].

Lista de Everywhere Actions

Exemplos

Instrumento Musical

Demonstra áudio espacial, animação e interações.

Controladores de Personagem Simples

Demonstra a combinação de animações, "olhar para" e movimento.

Rastreamento de Imagem

Demonstra como anexar conteúdo 3D a um marcador de imagem personalizado. Inicie a cena abaixo em AR e aponte a câmara do seu telemóvel para o marcador de imagem num ecrã, ou imprima-o.

Descarregar Marcador de Imagem de Exemplo

Em Android: por favor, ative "WebXR Incubations" nos Chrome Flags. Pode encontrá-los colando chrome://flags/#webxr-incubations na barra de endereço do navegador Chrome do seu telemóvel Android.

Visão Geral de Blocos de Construção Interativos

Criar as suas próprias Everywhere Actions

Criar novas Everywhere Actions envolve escrever código para a sua action em TypeScript, que será usado no navegador e para WebXR, e usar a nossa API TriggerBuilder e ActionBuilder para criar uma configuração correspondente para Realidade Aumentada em iOS via QuickLook. Ao criar actions personalizadas, tenha em mente que o QuickLook tem um conjunto limitado de funcionalidades disponíveis. Ainda pode usar qualquer código que queira para o navegador e WebXR, mas o comportamento para QuickLook pode precisar ser uma aproximação construída a partir dos triggers e actions disponíveis.

Triggers e Actions para QuickLook são baseados nos Apple's Preliminary Interactive USD Schemas

Exemplo de Código

Aqui está a implementação para HideOnStart como exemplo de como criar uma Everywhere Action com implementações para o navegador e para QuickLook:

import { Behaviour, UsdzBehaviour, BehaviorModel, TriggerBuilder, ActionBuilder, BehaviorExtension, USDObject, USDZExporterContext } from "@needle-tools/engine";

export class HideOnStart extends Behaviour implements UsdzBehaviour {

    start() {
        this.gameObject.visible = false;
    }

    createBehaviours(ext: BehaviorExtension, model: USDObject, _context: USDZExporterContext) {
        if (model.uuid === this.gameObject.uuid)
            ext.addBehavior(new BehaviorModel("HideOnStart_" + this.gameObject.name,
                TriggerBuilder.sceneStartTrigger(),
                ActionBuilder.fadeAction(model, 0, false)
            ));
    }

    beforeCreateDocument() {
        this.gameObject.visible = true;
    }

    afterCreateDocument() {
        this.gameObject.visible = false;
    }
}

Métodos de baixo nível para criar as suas próprias actions

Para ver a implementação das nossas Everywhere Actions integradas, por favor, consulte src/engine-components/export/usdz/extensions/behavior/BehaviourComponents.ts.

Leitura adicional

As seguintes páginas fornecem mais exemplos que pode testar e explorar agora mesmo:

• Visite o nosso Website AR Showcase que tem muitos exemplos de AR interativos com foco em iOS AR & Quicklook
• Needle Engine Everywhere Action Samples

Página traduzida automaticamente usando IA