Combining Voice Help for Related Speech Commands

If you have closely related speech commands, you can combine voice Help for these words into a single string. How you combine them depends on whether the words are mutually-exclusive or inclusive.

For related, but mutually-exclusive speech commands only one speech command is active at a time. For these, add the combined Help text to all of the speech commands. You may want to combine both long and short Help for large groups of related, inclusive speech commands, such as the alphabet.

    To combine long voice Help for mutually-exclusive speech commands

  1. Write one long voice Help string that explains the related speech commands.
  2. Repeat this long voice Help string for each speech command referred to.

The following code example shows how to combine long voice Help only and use the default WAV file names, AM.wav and FM.wav, for short voice Help for the speech commands AM and FM.

IDS_SPEECH_AM  "AM \tTo change radio bands, say AM or FM"
IDS_SPEECH_FM  "FM \tTo change radio bands, say AM or FM"

Because only one speech command is available at a time, a user hears this string only once in long voice Help. Because no string is specified for short voice Help, the user hears only the available command.

For speech commands that are related but inclusive, all of the speech commands are available at the same time. For these, add the combined Help text to one command, then disable Help for the rest of the speech commands.

    To combine long voice Help for inclusive speech commands

  1. Write one long voice Help string that explains the related speech commands.
  2. Include this long voice Help string for the first speech command referred to only.
  3. Disable long voice Help for all but the first speech command referred to.

The following code example shows how to combine long voice Help only and keep short Help as the default for the speech commands Next and Previous.

IDS_SPEECH_NEXT "Next \tTo go to a different track, say Next or Previous"
IDS_SPEECH_PREVIOUS "Previous \t"    //Disable long voice Help.

Because both Next and Previous are available at the same time, the user hears the string for Next, but not for Previous. Short voice Help lists both Next and Previous because only long voice Help is disabled for Previous.

    To combine both long and short voice Help for inclusive speech commands

  1. Write two strings that explain the related speech commands, one for long voice Help and one for short voice Help.
  2. Include both the long and short voice Help strings for the first speech command referred to only.
  3. Disable both long and short voice Help for all but the first speech command referred to.

The following code example shows how to combine both long and short voice Help for the speech commands from A through Z. The second parameter specifies that the WAV file named AtoZ.wav is played for short voice Help for A.

IDS_SPEECH_A  "A     \tYou can say A through Z\tAtoZ"  //Play AtoZ.wav for short Help 
IDS_SPEECH_B  "B     \t\t"  // Disable long and short voice Help
IDS_SPEECH_C  "C     \t\t"  // for the rest of the alphabet.
:
IDS_SPEECH_Z  "Z     \t\t"