jsOMS/UI/Input/Voice/VoiceManager.js

/**
 * Form manager class.
 *
 * @copyright  Dennis Eichhorn
 * @license    OMS License 1.0
 * @version    1.0.0
 * @since      1.0.0
 */
(function (jsOMS)
{
    "use strict";

    /** @namespace jsOMS.UI */
    jsOMS.Autoloader.defineNamespace('jsOMS.UI.Input.Voice');

    // todo: remove once obsolete
    var SpeechRecognition = SpeechRecognition || webkitSpeechRecognition
    var SpeechGrammarList = SpeechGrammarList || webkitSpeechGrammarList
    var SpeechRecognitionEvent = SpeechRecognitionEvent || webkitSpeechRecognitionEvent

    /**
     * @constructor
     *
     * @since 1.0.0
     */
    jsOMS.UI.Input.Voice.VoiceManager = function (app, commands, lang)
    {
        this.app = app;
        this.recognition = new SpeechRecognition();
        this.speechRecognitionList = new SpeechGrammarList();
        this.commands = typeof commands === 'undefined' ? {} : commands;
        this.lang = typeof lang === 'undefined' ? 'en-US' : lang;      
    };

    /**
     * Setup or re-initialize voice manager.
     *
     * @method
     *
     * @since  1.0.0
     */
    jsOMS.UI.Input.Voice.VoiceManager.prototype.setup = function()
    {
        const self = this;

        this.recognition.lang = this.lang;
        this.recognition.interimResults = false;
        this.recognition.maxAlternatives = 1;
        this.recognition.continuous = true;
        this.recognition.lang = this.lang;

        if(typeof this.commands !== 'undefined') {
            this.speechRecognitionList.addFromString(this.getCommandsString(), 1);
            this.recognition.grammars = this.speechRecognitionList;
        }

        this.recognition.onstart = function() {}

        this.recognition.onresult = function(event) {
            console.log(event.results[event.resultIndex][0].transcript);

            if(self.commands.hasOwnProperty(event.results[event.resultIndex][0].transcript)) {
                self.commands[event.results[event.resultIndex][0].transcript]();
            }
        }

        this.recognition.onspeechend = function() {
        }

        this.recognition.onnomatch = function(event) {
            console.log('Couldn\'t recognize speech');
        }

        this.recognition.onerror = function(event) {
            console.log('Error during speech recognition: ' + event.error);
        }
    };

    /**
     * Create commands/grammar string from commands
     *
     * @return {string}
     *
     * @since  1.0.0
     */
    jsOMS.UI.Input.Voice.VoiceManager.prototype.getCommandsString = function()
    {
        return '#JSGF V1.0; grammar phrase; public <phrase> = ' + Object.keys(this.commands).join(' | ') + ' ;';
    };

    /**
     * Set language
     *
     * @param {string} lang Language code (e.g. en-US)
     * 
     * @return {void}
     *
     * @since  1.0.0
     */
    jsOMS.UI.Input.Voice.VoiceManager.prototype.setLanguage = function(lang)
    {
        // todo: eventually restart
        this.recognition.lang = lang;
    };

    /**
     * Add command/grammar and callback.
     *
     * @param {string} command Command id
     * @param {Callback} callback Callback for command
     * 
     * @return {void}
     *
     * @since  1.0.0
     */
    jsOMS.UI.Input.Voice.VoiceManager.prototype.add = function(command, callback)
    {
        this.commands[command] = callback;
    };

    /**
     * Start voice listener.
     *
     * @return {void}
     *
     * @since  1.0.0
     */
    jsOMS.UI.Input.Voice.VoiceManager.prototype.start = function()
    {
        this.recognition.start();
    };

    /**
     * Stop voice listener.
     *
     * @return {void}
     *
     * @since  1.0.0
     */
    jsOMS.UI.Input.Voice.VoiceManager.prototype.stop = function()
    {
        this.recognition.stop();
    };
}(window.jsOMS = window.jsOMS || {}));