Quicklaunch Voice Command is a speech recognition system that allows conference room users to control the basic functions of Quicklaunch.  Voice command allows users to minimize touching of equipment.


You need the Ultimate Edition of Quicklauinch to use Voice COmmand



Content

  1. Setup
  2. Using Voice Commands
  3. Errors
  4. Advanced Setup
  5. Running Action Tiles with Voice Commands


See Also

  1. Quicklaunch Remote Control

Setup


Follow these steps to setup Quicklauinch Voice Command

  1. Download and install the latest release of Quicklaunch from http://qlinstall.ucworkspace.com
  2. Go to Quicklaunch Settings
    1. in Settings->Account, edit the feature key, and enter your feature key.  It should show "Voice Command"
    2. in Settings->System->General, enable the Quicklaunch API, and enter "QuicklaunchApiAuthToken" for the auth token and "5555" for the Port Number
    3. in Settings->Plug-ins->Voice Command, enable Quicklaunch Voice Command. 
    4. Choose "Speech Service" which is either Azure Cognitive Services or Windows System Speech


Azure Cognitive Services


Using Azure Cognitive Services provides the most update to date in Microsoft speech recognition.  You need to add "Cognitive Services" in the Azure Marketplace.  Then display the "Manage Keys" page.

  1. Location - This is the location field from your Azure Cognitive services setup
  2. Key - This the either Key 1 or Key 2 copied from your Azure cognitive services setup
  3. Timeout Period - How long after saying the keyphrase until Voice Command turns off, in milliseconds
  4. Trigger Confidence - How accurate your keyphrase has to be spoken, from 0-1, we recommend 0.8 for a starting point
  5. Trigger Phrase - Which words need to be spoken to trigger listening Voice Commands - "Hey Quicklaunch"
  6. Command Confidence - How accurate your commands need to be spoken, from 0-1, we recommend 0.8 for a starting point
  7. Grammar File - Location of the grammar file for Voice Commands
  8. Use Sound - Whether or not the Voice Command beeps go off after saying the keyphrase
  9. Screen ID - Which screen Voice Commands appear on


Windows System Speech 

  1. Timeout Period - How long after saying the keyphrase until Voice Command turns off, in milliseconds
  1. Trigger Confidence - How accurate your keyphrase has to be spoken, from 0-1, we recommend 0.8 for a starting point 
  2. Trigger Phrase - Which words need to be spoken to trigger Voice Commands - "Hey Quicklaunch"
  3. Command Confidence - How accurate your commands need to be spoken, from 0-1, we recommend 0.8 for a starting point 
  4. Grammar File - Location of the grammar file for Voice Commands
  5. Use Sound - Whether or not the Voice Command beeps go off after saying the keyphrase
  6. Screen ID - Which screen Voice Commands appear on
  7. Setup your default Windows Microphone:
    1. Go to the Windows Control Panel. Search for Manage Audio Devices
    2. Click on "Recording" tab
    3. Enable the microphone you want to use and disable the others

Using Voice Command


Quicklaunch Voice Command needs to be "woken up" with a trigger phrase.  The default trigger phrase is "Hey Quicklaunch".  Once woken up, a chime will sound, and a window will appear on the monitor indicating Voice Command is ready for a command.  


NOTE: on the first wakeup, it takes approx 15-25 seconds for Voice Command to be display.  Subsequent wakeups, it will respond immediately.


Then you can say one of the following commands.  If a command is successfully recognized, then an upbeat chime will sound and the command will be performed.


"Start meeting" - will start the current meeting.  If there is no meeting, nothing will happen.


"Go to dock" - will tell Quicklaunch to go from fullscreen to dock mode


"Go to fullscreen" - will tell Quicklaunch to go from dock mode to fullscreen


"Cancel" - cancels Quicklaunch Voice command


If there are no words spoke for 4 seconds, Voice Command will play a closing chime and go back to sleep, waiting for another "Hey Quicklaunch"



Errors

If a negative chime sounds or Voice command does not display.  All errors will be written to the application event log.



Advanced Setup


There is one file that can be adjusted to fine-tune the Quicklaunch Voice Command.  NOTE:  you *must* fully understand proper JSON to modify these files.


Grammar file

The Grammar file contains the command phrases that will be recognized and the commands that will be performed.  You can edit this file to create your own phrases.  You can use multiple phrases for a command.  The commands cannot change.


The file is located in the following location.  The file *must* be valid JSON.


c:\program files(x86)\UC Workspace\Quicklaunch\Quicklaunch.VoiceCommand\Grammer.json


Running Action Tiles with Voice Commands



  1. Launch Quicklaunch Settings > Actions > Actions > Add Action
  2. Select your Action Group and add an Action Tile
  3. Add any action tile you want to run
  4. Ensure that the Action Tile "Name" is properly setup
  5. Open the Grammar.json file (C:\program files(x86)\UC Workspace\Quicklaunch\Quicklaunch.VoiceCommand\Grammer.json) in your choice of editor (Notepad, DreamWeaver, VisualStudio etc)


  1. This is in Grammar.json by default
  2. Ensure to add the comma (,) after the bracket to show that you are continuing the code
  3. Add "CommandGrammer"  followed by your chosen phrase 
  4. Add "ApiCommandMethod" which will always be "RunAction" for Action Tiles
  5. Add "ApiCommandParamaters" which will always go Action Group first, followed by the name of the action tile


*Note* Always ensure to Restart Voice Command after making changes - Right-hand Options menu.