Audio Actions
Windows Voice and Amazon TTS are both supported. To use Amazon TTS, you should compile the WEAVR Settings and have a valid internet connection.
Play Audio Action
| Property | Description |
|---|---|
| Audio Clip | Audio Clip to be played. You can set different audio clips to be played for different languages. |
| Loop | If enabled, the audio is reproduced in a loop (this parameter is invisible if the action is not Async). |
Play Audio on Target
The Play Audio on Target action plays the indicated audio from the referenced target Object of the scene.
| Property | Description |
|---|---|
| Audio Clip | Audio Clip to be played. You can set different audio clips to be played for different languages. |
| Target | Object for which the audio is played. |
| Loop | If enabled, the audio is reproduced in a loop (this parameter is invisible if the action is not Async). |
Play Audio at Position
The Play Audio at Position action plays the indicated audio when you are in the needed position in the scene.
| Property | Description |
|---|---|
| Audio Clip | Audio Clip to be played. You can set different audio clips to be played for different languages. |
| Point | Position in the coordinate system where to play the audio in respect to the center of the scene. If disabled, the audio is heard on the background of the scene. |
| Loop | If enabled, the audio is reproduced in a loop (this parameter is invisible if the action is not Async). |
Text to Speech
The Text to Speech action converts the text into audio that will be reproduced on the background of the scene.
The voice is no longer chosen on the action itself: it is defined by a Role. Roles and their per-language voices are configured in the Text To Speech tab of the Procedure Graph Toolbar, and the audio clip is generated automatically from the text using the role's voice.
| Property | Description |
|---|---|
| Role | The Text-to-Speech role that provides the voice. Selecting a role determines, per language, which voice reads the text. Roles are created and configured in the Text To Speech tab. |
| Text | The text to be synthesized. You can enter different text for different languages. |
| Play Behaviour | How this narration interacts with other narrations. For example Stop Same Role Narrations (default) stops other narrations of the same role before playing; other options let it wait for or pause same-role/all narrations, or continue playing after the node finishes. |
| Listen in | Pick a language and press the play button to preview the synthesized speech directly in the editor. |
| Loop | If enabled, the audio is reproduced in a loop (this parameter is invisible if the action is not Async). |
Text to Speech on Target
The Text to Speech on Target action converts the text into audio that will be reproduced from the referenced Object of the scene.
| Property | Description |
|---|---|
| Role | The Text-to-Speech role that provides the voice (per language). |
| Text | The text to be synthesized. You can enter different text for different languages. |
| Target | Object for which the audio is played. If null, the audio is heard on the background of the scene. |
| Distance | If enabled, the audio becomes 3D and the value is the maximum distance from which it can be heard. |
| Play Behaviour | How this narration interacts with other narrations (stop / wait / pause same-role or all narrations). |
| Listen in | Pick a language and press play to preview the synthesized speech in the editor. |
| Loop | If enabled, the audio is reproduced in a loop (this parameter is invisible if the action is not Async). |
Text to Speech at Position
The Text to Speech at Position action converts the text into audio when you are in the needed position in the scene.
| Property | Description |
|---|---|
| Role | The Text-to-Speech role that provides the voice (per language). |
| Text | The text to be synthesized. You can enter different text for different languages. |
| Point | Position in the coordinate system where to play the audio in respect to the center of the scene. If disabled, the audio is heard on the background of the scene. |
| Distance | If enabled, the audio becomes 3D and the value is the maximum distance from which it can be heard. |
| Play Behaviour | How this narration interacts with other narrations (stop / wait / pause same-role or all narrations). |
| Listen in | Pick a language and press play to preview the synthesized speech in the editor. |
| Loop | If enabled, the audio is reproduced in a loop (this parameter is invisible if the action is not Async). |
Advanced
The advanced section contains some of the previous actions with more settings to customize.
Play Audio Expert
The Play Audio Clip Expert action plays the indicated audio. You can customize the reproduction of the clip in different ways.
| Property | Description |
|---|---|
| Audio Clip | Audio Clip to be played. You can set different audio clips to be played for different languages. |
| Volume | Volume of the audio clip. |
| Target | Object for which the audio is played. If null, the audio is heard on the background of the scene. |
| Point | Position in the coordinate system where to play the audio in respect to the center of the scene. If disabled, the audio is heard on the background of the scene. |
| Pitch | If enabled, the pitch of the audio can be customized. You can animate it. |
| Distance | If enabled, the audio becomes 3D, and the distance is the maximum distance from which you can hear the audio. You can animate it. |
| Loop | If enabled, the audio is reproduced in a loop (this parameter is invisible if the action is not Async). |
Text to Speech Expert
The Text to Speech Expert action plays the indicated TTS. You can customize the reproduction of the TTS in different ways.
| Property | Description |
|---|---|
| Role | The Text-to-Speech role that provides the voice (per language). |
| Text | The text to be synthesized. You can enter different text for different languages. |
| Play Behaviour | How this narration interacts with other narrations (stop / wait / pause same-role or all narrations). |
| Volume | Volume of the audio clip. |
| Target | Object for which the audio is played. If null, the audio is heard on the background of the scene. |
| Point | Position in the coordinate system where to play the audio in respect to the center of the scene. If disabled, the audio is heard on the background of the scene. |
| Pitch | If enabled, the pitch of the audio can be customized. You can animate it. |
| Distance | If enabled, the audio becomes 3D, and the distance is the maximum distance from which you can hear the audio. You can animate it. |
| Loop | If enabled, the audio is reproduced in a loop (this parameter is invisible if the action is not Async). |