Português

Documentação xr/studio

Ações

Construa comportamentos com tipos de evento, tipos de ação, condições, ações de entidade e ações de cena.

Ações

As ações definem o que acontece na sua experiência. Ligam:

  • Event type: quando corre, como clique, scene ready, fim da timeline ou entrada em VR.
  • Action type: o que faz, como navegar, abrir um URL, mostrar uma entidade, reproduzir media ou alterar uma propriedade.
  • Conditions: regras opcionais que têm de ser satisfeitas antes da ação correr, como idioma, dispositivo, modo XR, intervalo de datas ou geolocalização.

Pode adicionar ações a uma entidade ou à própria cena. As ações de entidade respondem a eventos nessa entidade. As ações de cena respondem a eventos ao nível da cena, como On Scene Ready ou On Scene Exit.

Trabalhar no inspetor

Abra o separador Actions numa entidade, ou selecione a cena para editar ações de cena. A UI agrupa ações por event types. Escolha um event type (por exemplo On Click) e depois adicione uma ou mais ações por baixo.

Inspector Actions section: On Click with Go To Scene, other triggers, and Add Action

Event types

Os event types dependem de estar a editar entity actions ou scene actions. Os nomes abaixo correspondem ao inspetor.

Entity actions — selecione uma entidade, abra o separador Actions e escolha um event type ao adicionar uma ação.

  • Pointer and input: On Click, On Double Click, On Context Menu, On Pointer Enter, On Pointer Over, On Pointer Down, On Pointer Up, On Pointer Move, On Pointer Leave, On Container Scroll, On Wheel
  • Entities: On Entity Added, On Entity Ready, On Entity Removed
  • Language: On Language Changed
  • Image tracking: On Target Found, On Target Lost. Só num Image Target, que mostra apenas os eventos que pode executar. Veja Image Tracking.

Scene actions — selecione a cena (não uma entidade) para editar ações ao nível da cena.

  • Scene lifecycle: On Scene Enter, On Scene Ready, On Scene Exit, On Scene Timeline Start, On Scene Timeline End
  • XR: On Enter Vr, On Enter Ar, On Exit Xr, On Scene Positioned (AR placement)

Action types

Estes são os efeitos que pode associar (nomes correspondem ao inspetor):

  • Navigation: Go To Scene, Next Scene, Previous Scene
  • Links and language: Open Url, Change Active Language
  • Modals: Open Modal, Close Modal
  • Entities: Change Entity Property, Reset Entity Properties, Show Entity, Hide Entity, Trigger Entity, Instantiate Prefab
  • Media on an entity: Play Entity Media, Pause Entity Media, Stop Entity Media, Mute Entity Media, Unmute Entity Media
  • Scene timeline: Play Timeline, Pause Timeline, Stop Timeline, Mute Timeline, Unmute Timeline
  • Camera and map: Camera Look At, Center GPS
  • XR: Enter Vr, Enter Ar, Enter Xr, Exit Xr
  • Commerce: Open Ecommerce Product (XR Stores)
  • Utilities: Delay, Custom Code

Conditions

Os filtros opcionais numa ação incluem idioma ativo, tipo de dispositivo, modo XR, intervalos de datas ou geolocalização. A ação só corre quando todas as condições que definir estão satisfeitas.