Thread: RRVoiceControl-Beta Complete: Check Released Plugins Section

This Version Requires RideRunner 11/1/09

RRVoiceControl Version 1.1.0.83 BETA Copyright 2009 The Garage
RRVCConfig Version 1.0.0.44 BETA Copyright 2009 The Garage

Developed for Driving Safety while using RideRunner Frontend.

RRVoiceControl was developed using DFX 4.0 skin

It should work with any skin.
RRVoiceControl is a Voice Control Application based on SAPI 5.1 VR
You must have SAPI 5.1 VR installed and setup for it to work.
Unknown if newer versions of SAPI are compatible.
Developed and Tested on Windows 2000
Unknown if newer versions of Windows are compatible.
Developed using Visual Basic 6.
If you have RideRunner installed you should have all VB6 runtime files needed.
RRVoiceControl was developed for my personal use.
I am offering it free of charge for personal use.
No Refunds. Use at your own risk.

## SETUP ##
Turn off RideRunners built in VR in rr.ini if you have it on.
Make sure that SAPI and your Microphone is set up correctly.
To hear system beeps, Make sure your "PC Speaker" volume is set correctly.
Unzip and Drop the files into any folder of your choice, preferably "C:\Program Files\RideRunner\RRVoiceControl"
Open RideRunner to expose RR's API then
Open RRVoiceControl to set ini vars from RR and
RRVoiceControl will minimize to system tray, right click on it and pop it up, then
Open RRVConfig and Click the "Create" Button and let it find your MP3 and WMA files.
Note: Currently only finds MP3 and WMA Files.
You will note that you have full ini editing capabilities in RRVConfig.
Debug is on by default in both apps, Leave it on for now.
You can close RRVConfig now if you wish.

## Testing ##
Take a look at and scroll through the default commands listed in the Commands Listbox in RRVoiceControl.
I have it currently setup with a few default commands as you can see in the Commands Listbox.
Now click on the word "VR OFF" on the RRVoiceControl form or
Use the skin commands as noted below or
Use serialswitch and a momentary button as noted below
To enable VR.
You will hear a beep and "VR OFF" will change to "VR ON".
Say "Audio" and you will hear a different beep and see the application and RR recognize your command.
There is a lower frequency beep for an unrecognized command. If so repeat your command.
If everything is correct you will see the RideRunner command in bold at the bottom of RRVoiceControl and RR will change to Audio skin.
If not. Go back and Setup or Train SAPI or Setup your microphone correctly.
If you don't hear the system beeps, Make sure your "PC Speaker" volume is set correctly.
I will not provide support for your SAPI VR or Microphone issues.
/-----------------------------------------------------------------

## RideRunner Exectbl.ini and Skin Commands ##

This is what I have at the top of my DFX4 Exectbl.ini. Look towards the end of the "ExtraPrograms" line.

"ExtraPrograms","2DLogo||UserSwitch||CDLaunch||Cou nter||3DLogo||SetTempBackground||PresetLoader||IGS ettingLoader||SETVAR;RRLoaded;Loaded||ReLock||Load List||RELAYS||RRVC"

"RELAYS","RUN;$RRPATH$SerialSwitch\SerialSwitch.exe"
"RRVC","RUN;$RRPATH$RRVoiceControl\RRVoiceControl. exe"

This is what I have at the bottom of my DFX4 Exectbl.ini
You must have these commands for RRVoiceControl to work properly
/-----------------------------------------------------------------

/ RR Voice Control

"ONRRVC_ON","SETIND;!RRVC_Ind;ON"
"ONRRVC_OFF","SETIND;!RRVC_Ind;OFF"
"RRVCON","SENDMSG;RRVoiceControl;RRVC_ON"
"RRVCOFF","SENDMSG;RRVoiceControl;RRVC_OFF"
"VOL+","VOL+||SENDMSG;RRVoiceControl;RRVC_VOLU ME"
"VOL-","VOL-||SENDMSG;RRVoiceControl;RRVC_VOLUME"
"QUIT","CLOSEWINDOW;RRVoiceControl||ENDVC"
"ENDVC","QUIT"
/-----------------------------------------------------------------

## Explanation of Commands ##

Executed "ON VR ON" or "ON VR OFF" from RRVoiceControl.

ONRRVC_ON
ONRRVC_OFF

Example Indicator Code in Exectbl.ini:

"ONRRVC_ON","SETIND;!RRVC_Ind;ON"
"ONRRVC_OFF","SETIND;!RRVC_Ind;OFF"

Turns VR ON or OFF, must be sent with sendmessage as shown below.

RRVC_ON
RRVC_OFF

Example Button or Label Code in Exectbl.ini:
"RRVCON","SENDMSG;RRVoiceControl;RRVC_ON"

VR shuts off after each command recognized.
"RRVCOFF","SENDMSG;RRVoiceControl;RRVC_OFF"

You must have this in Exectbl.ini to have Volume drop when issuing commands.

"VOL+","VOL+||SENDMSG;RRVoiceControl;RRVC_VOLU ME"
"VOL-","VOL-||SENDMSG;RRVoiceControl;RRVC_VOLUME"

## Skin Commands ##
Example Menu Skin Hidden Label Command to Enable/Disable VR.

This puts a large hidden executable label in the center of the Menu Skin to switch VR on.

L,301,235,204,124,,,,,,"EXEC;RRVCON||=",

This puts a smaller hidden executable label in the center of the Menu Skin to switch VR off.

L1,443,371,91,85,,,,,,"EXEC;RRVCOFF||=",

Example Skin Indicator Code
I have a couple of pngs embedded in my menu_on and menu_off pngs

I,252,150,21,20,"!RRVC_Ind"
/-----------------------------------------------------------------

I use SerialSwitch to enable VR with an External Button
Here is the Exectbl.ini code I use for SerialSwitch.
You can see above I load SerialSwitch with Exectbl.ini also.

/-------------SerialSwitch-----------------
"DTRON","SENDMSG;SerialSwitch;DTR_ON"
"DTROFF","SENDMSG;SerialSwitch;DTR_OFF"
"RTSON","SENDMSG;SerialSwitch;RTS_ON"
"RTSOFF","SENDMSG;SerialSwitch;RTS_OFF"
/"ONDTR_ON",""
/"ONDTR_OFF",""
/"ONRTS_ON",""
/"ONRTS_OFF",""
/"ONCD_ON",""
/"ONCD_OFF",""
/"ONCTS_ON",""
/"ONCTS_OFF",""
Turns on VR
"ONDSR_ON","SENDMSG;RRVoiceControl;RRVC_ON"
Turns off VR
/"ONDSR_OFF","SENDMSG;RRVoiceControl;RRVC_OFF"
"QUIT","CLOSEWINDOW;SerialSwitch||ENDIT"
"ENDIT","QUIT"
/-----------------------------------------------------------------

## Momentary Switch Setup ##

Turn RTS on, with skin command or manually in SerialSwith, to provide PC power to Pin 7
DSR input is Pin 6
I am using pins 6 and 7 to connect a momentary pushbutton switch
Push switch and VR is on.

/-----------------------------------------------------------------

## Editing Ini Files ##
RRVoiceControl is fully configurable.
Any Voice Command in RRVoiceControl.ini can be associated with any or multiple RR Commands.
This should be self explanatory by studying the ini files.
Note: No command will show up twice in the Command list

## Music ##

RRVoiceControl utilizes a new command in RideRunner to eliminate the need for hidden playlists in every skin.
This new command is PLAYITEM;xxx Where xxx is playlist position of current playlist.
This is one area I have put a lot of effort into getting right. I have 1150 songs. Some of you have over 10,000 songs.
When you clicked on the "Create" button in RRVConfig you will have found out if this works.
Thats why there is a stop button. Might have issues there. The command list should handle the last folder names.
The songs for each folder are only listed when a folder command is given. Example: Load Eagles, lists the songs for that folder.
This brings us to your music structure. I use the last folder name as you will see. Future effort will be to expand on this.
This also brings us to song names. There are some album/song names that just don't lend themselves to voice recognition.
Take for example Korn, 4U or Korn, K@#0%! How in the hell is VR gonna recognize those commands? How are you gonna say them?
In VR all numbers must be spelled out for the command match. Ha! spell this, K@#0%!. You can't.
So to get VR to recognize these, they must be edited in your Music.ini or Songs.ini. Change them to something VR can recognize.
If you don't, you can't VR these songs. Just change the K@#0%! to something you can say.
Use RRVConfig to do this. There is a Find Function, a Set Value Function, and a Delete Key Function.
If you change the structure of your Music Paths, you must Delete and Create your ini files in RRVConfig.
RRVConfig will make backups of your RRVoiceControl.ini, Music.ini, and Songs.ini files.
Remember you might have changed K@#0%! to something VR can understand
Now Start RideRunner, Start RRSkinTool, and start setting up your VR Menu Commands for your favorite skin.
Please post the bugs...
I'm sure I missed something in the app and or in this readme. Remember, This is BETA. Questions? Ask...
...JJG