AddVoiceCommand

Purpose

This function will add the specified voice command to a new private command list.  HomeSeer voice commands are disabled and the computer will only listen for the commands given using this function.  When the script is exited, the computer will go back to listening for regular HomeSeer voice commands.

If the script is triggered by a voice command from HomeSeer Phone, make sure you add a system call to clear all voice commands.  This will tell HomeSeer Phone to restore the main menu voice commands.  The statement is:

system.ClearAllVoiceCommands

Parameters

Parameter: cmd
Type: string
Description: This is the voice command to add.

Parameter: host (optional)
Type: string
Description: Leaving this a null string will apply the command to the first instance HomeSeer finds, otherwise use the hostname of the computer for this command.  If more than one instance of the Speaker application is running on "host" then you may need to specify the instance as well in the format host:instance.

Returns

Return value: voice command
Type: string
Description: This is the specified voice command.

Example

The following script will read your E-mail messages.  This script is available in the scripts directory as "read_messages.txt".