Perlbox Voice Desktop Plugin
Creating Desktop Plugins for Perlbox Voice
Desktop plugin support for the Perlbox Voice Application Framework was designed so that the creation and extention of plugins would NOT require a degree in computer science. The format of the plugin is very simple; a single file that stores a list of command:response pairs.
Command: This is what the user will 'say' to invoke the computer's 'response'.
There are only two basic rules for building command phrases:
Response: This is the action that the computer will perform on hearing a valid command.
As before, there are some rules for this section
Examples (from the kde plugin):
desktop one:dcop kwin KWinInterface setCurrentDesktop 1
The command here is desktop one. When the user says desktop one, the computer will execute the command dcop with the arguments kwin KWinInterface setCurrentDesktop 1. Dcop knows what to do with this, and the user will be switched to the first virtual desktop.
Note that the command:response pair are separated by a colon, this is not optional.
1.) All files must be named name.plug, where name is the name of your plugin.
Addon plugins should be installed in $HOME/.perlbox-voice/dtplugins/, where $HOME is the users home directory.
Example (from kde.plug)
#kde desktop plugin for perlbox-voice January 2004 by Shane C. Mason (me at perlbox dot org)
We hope that you have found this document useful. Please, feel free to contact us with any questions at firstname.lastname@example.org . January 2004, Shane C. Mason.