Speechace Speaking Test
  • Speechace speaking test documentation
    • Use cases
    • Test development
    • Test reliability
    • Test customization
    • Audio/Video recording
    • Usage with children
    • Usage and demographics
  • Getting Started
    • Sign up and create a workspace
    • Invite team members
    • Create an assessment
      • Clone from Library
      • Assessment with custom questions
    • Invite test takers
    • Review Reports
  • Speechace Workspaces: create, manage, and share speaking assessments
    • Create multiple workspaces
    • Switch between workspaces
    • Collaborating in a Workspace
      • Invite team members to a workspace
        • Accept a workspace invitation
      • Role-based access
    • Creating Assessments
      • Clone Assessments
        • Cloning from the Library
        • Clone a single assessment
      • Create new custom assessments
        • Select avatar and language
        • Custom assessment configurations
          • Configuration panel
          • Types of questions
            • Open-ended
            • Read-aloud
            • Task Achievement
            • Record Only
            • Writing
              • Describe image
              • Essay Writing
          • Weights, Max Scores, Timers
      • Rubrics (supported+default)
      • Audio or video assessment
      • Score settings
    • Manage existing assessments
      • Invite test-takers to take an assessment
      • Review scores
      • Edit assessment configurations
      • Edit assessment questions
      • Set up email notifications for completed tests
      • Clone an existing assessment
      • Move an assessment
      • Delete an assessment
      • Add more activities within an existing assessment
    • Customize avatars
      • Edit Avatar
        • Versioning
        • Change avatar and language
        • Edit avatar narration
        • Change Avatar Background
        • Upload Custom Videos
      • Generate avatar
      • Apply avatar
    • Manage tags of assessment results
      • Add new tags
      • Edit or Delete tags
    • Sharing individual activities within an assessment with test-takers
    • Sharing assessments with candidates
    • Inviting candidates to take an assessment
    • Usage tracking
    • Upgrade your plan
    • Embedding assessments in other apps and websites
      • oEmbed integration for Speechace speaking test
        • Receiving test results on specified callback
          • Results callback to 3rd party application backend
            • Export report in json
          • Test completion notification to 3rd party app front-end
      • iframe integration for Speechace speaking test
  • Detailed test report
  • Test taker guide
    • Test-taker's view of Scores
Powered by GitBook
On this page
  1. Speechace Workspaces: create, manage, and share speaking assessments
  2. Customize avatars
  3. Edit Avatar

Edit avatar narration

Learn how to customize the avatar's narration.

PreviousChange avatar and languageNextChange Avatar Background

Last updated 5 months ago

Only users on the Premium or higher plans can customize the avatar's narration.

Each speaking test is divided into multiple scenes such as Introduction, Question 1, Question 2... Question N and Conclusion. For each scene in the test, the avatar speaks a message appropriate for that scene. Using the edit avatar interface, test creators can customize what the avatar speaks during each scene. While most scenes are singular, a few scenes can also have sub-scenes. Test creators have the option to customize the narration for sub-scenes also.

A comprehensive list of scene and sub-scenes is available in the expandable box below for reference:

List of scenes for an avatar instance

Review the purpose of each scene before editing the avatar's narration, and follow the steps outlined in this document to make the changes.

  1. Scene: Start Purpose: Avatar will introduce the session, sets expectations, and gives an overview of what will happen.

  2. Scene: Mic Check

    1. Sub-scene: Mic Check Introduction Purpose: Avatar will start the mic check, prompting the user to test their microphone.

    2. Sub-scene: Mic Fail-1 Purpose: First failure message if the microphone isn’t detected or working properly.

    3. Sub-scene: Mic Fail-2 Purpose: Second failure message if the issue persists, with further instructions to resolve it.

    4. Sub-scene: Mic Fail-3 Purpose: Third failure message, possibly with more troubleshooting tips or alternative solutions.

    5. Sub-scene: Mic Success Purpose: Confirmation that the microphone has been successfully detected and is working.

  3. Scene: Test Introduction Purpose: Avatar will introduce the test, explains its purpose, and outlines the instructions for the user.

  4. Scene: Question Number

    1. Sub-scene: Introduction Purpose: Avatar will present the question or task.

    2. Sub-scene: Prepare Answer Purpose: Avatar will prepare the user to answer the question (e.g., providing a moment of thinking time).

    3. Sub-scene: Record Answer Purpose: User records their response (if applicable, this could involve voice or text input).

    4. Sub-scene: Process Answer Purpose: Avatar will process the answer provided by the user.

    5. Sub-scene: Process Failure Purpose: If there’s an error in processing the answer, the avatar shall inform the user and prompts them to retry.

    6. Sub-scene: Process Success Purpose: Confirmation that the answer was successfully processed.

  5. Scene: Process Results Purpose: Avatar will start processing the overall results of the test.

  6. Scene: Results Failure Purpose: Avatar will notify the user of an issue with processing the results.

  7. Scene: Partial Results Purpose: Avatar will narrate and display partial results or feedback if the process was not complete.

  8. Scene: Results Success Purpose: Avatar will provide the final results or feedback, confirming the successful completion of the task or test.

To edit the avatar narration for a scene, Select the Scene from the left pane and then click on the text box highlighted in Red below:

Once the avatar narration is edited, you will notice that both the Playback button for scene video and the Preview button for the activity are disabled. Furthermore, a message suggesting that a new avatar video needs to be generated for this scene is displayed as below:

Now press the Next button to go to the screen where the avatar changes can be submitted for generating a revised avatar video.