This article describes how animations work in WANNA 3D Viewer and how they should be prepared.
Supported Animation Types
WANNA supports 2 kinds of animation:
- so-called ‘ongoing animation’ that is played constantly when the user interacts with a model in the 3D Viewer; for example, Watch Dial Animation (Current Time)
- animation that represents a specific action, that is played once and then the user has an ability to interact with the modified model; for example, bag opening animation of scarf tying animation
In WANNA 3D Viewer these animations differ by name. The table below describes how they are displayed in the 3D Viewer and explain the main usage scenarios:
| Animation name | 3D Viewer UI | Animation usage |
|
|
No UI changes |
Animation plays constantly when the users explores the model in all modes except for Inside/Details. Example: watch dial animation |
|
|
Inside/Details view is available for a model that has such animation:
|
Animation plays once to showcase an action only when the user switches to Inside/Details view. Example: bag opening, scarf tying |
Animation Details
Please refer to the guide Watch Dial Animation (Current Time).
ActionAnimation Details
A specific animation named ActionAnimation can be added to a 3D model. It is used to showcase a model-specific action - for example, splitting a shoe into layers to demonstrate different materials used in production.
The first and last frames of
ActionAnimationmust be identical so that the model returns to its initial pose after playback. Ending the animation in a different pose is not supported.
When a model contains an ActionAnimation and it is enabled by the WANNA team, the Inside/Details view becomes available to users in the 3D Viewer.
ActionAnimation Playback Modes
ActionAnimation can be configured to play in three ways:
- Single play – plays only when entering Inside/Details, no playback when exiting.
- Play and reverse – plays forward on entering Inside/Details, reverses on exit.
- Split play – first half plays on entering Inside/Details, second half on exit.
Technical Recommendations
When preparing ActionAnimations in Blender:
- Frame rate: 24 FPS
- Frame range: 0–250 frames (must be even, last frame must have a keyframe)
- Recommended duration: ≤ 10 seconds
Setup
To enable an ActionAnimation, provide the 3D model to the WANNA team together with the preferred playback mode and starting camera view. The animation behaviour is currently configured internally. WANNA Studio will support direct configuration in future updates.
Example References
- Single play – watch_with_single_animation_and_camera
- Play and reverse – bag_without_stuff
- Split play – shoes_with_split_animation_and_camera_spec