Share via

Respond to microphone buttons (Browser)

Nuance-hosted systems only: Dragon Medical SpeechKit supports Nuance PowerMic button controls.

Prerequisites

  • Your app must be running in Google Chrome on a Windows operating system.

  • The Nuance PowerMic Web Extension must be installed in Google Chrome and the Nuance PowerMic Web Adapter must be running on the operating system.

For more information, see the PowerMic Web Extension Deployment and Troubleshooting Guide available from the Browser SDK download site: https://github.com/microsoftconnect/DMSK-Browser.

Foot pedals

For correctionists in deferred correction workflows, some foot pedals are supported. Google Chrome is required. Open the personalization & help window > Options page to configure the action for the play, rewind and fast forward pedals and enable/disable the press-and-hold behavior. For more information on supported models, see the release notes delivered with your version of Dragon Medical SpeechKit.

Customizable buttons

You can customize some microphone buttons via your integration. When these buttons are pressed, Dragon Medical SpeechKit sends notifications to your app via the NUSA_onControlDeviceEventReceived() event and the NUSA_ControlDeviceEvent object. Use these notifications to trigger custom functionality in your app, such as opening and closing a report. For more information, see: Session events.

The eventButtonId parameter is the internal ID of the microphone button pressed; your integration can compare this to the properties of the NUSA_ControlDeviceEvent object. For example:

<script>
    function NUSA_onControlDeviceEventReceived(eventButtonId) {
        switch (eventButtonId) {
            case NUSA_ControlDeviceEvent.Button1Pressed:
                // Custom functionality; for example, open a report
            break;
            case NUSA_ControlDeviceEvent.Button5Pressed:
                // Custom functionality; for example, close a report
            break;
        }
    }
</script>

Button mapping

The Nuance PowerMic buttons are as follows:

PowerMic button names

The properties of the NUSA_ControlDeviceEvent object are mapped to the following Nuance PowerMic and Philips SpeechMike button presses. For reference, the default Dragon Medical One and Dragon Medical Direct functionality is also listed here.

NUSA_ControlDeviceEvent property Nuance PowerMic button name Philips SpeechMike button name Default Dragon Medical One/DM Direct functionality
Button1Pressed Transcribe End of line Transfer text
Button2Pressed Enter/Select Command Accept defaults
Button3Pressed Customizable right Insert/Overwrite Show/hide dictation box
Button4Pressed Tab backward F1 Previous field
Button5Pressed Tab forward F2 Next field
Button6Pressed Customizable left F4 No default
Button7Pressed Doesn't map to a button - reserved for future use Doesn't map to a button - reserved for future use No default
Button8Pressed Doesn't map to a button F3 No default

Non-customizable buttons

You can't customize the following microphone buttons: Play, Stop, Record, Fast Forward and Fast Rewind. No properties of the NUSA_ControlDeviceEvent object map to these buttons; your app doesn't receive notifications when these buttons are pressed.

These buttons provide the following standard functionality out of the box:

  • Record: Start recording audio.

  • Stop: Stop recording.

  • Fast forward: Move the cursor to the next field.

  • Fast rewind: Move the cursor to the previous field.

For more information on using these buttons, see the 'Microphones' topic in the Help section of the personalization & help window.

  • Last updated on