text: /**
   * Copyright 2015 IBM Corp. All Rights Reserved.
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  'use strict';
  var pick = require('object.pick');
  var qs = require('../util/querystring.js');
  
  var QUERY_PARAMS_ALLOWED = ['voice', 'X-WDC-PL-OPT-OUT', 'X-Watson-Learning-Opt-Out', 'text', 'watson-token', 'accept'];
  
  /**
   * @module watson-speech/text-to-speech/synthesize
   */
  
  /**
   * Synthesize and play the supplied text over the computers speakers.
   *
   * Creates and returns a HTML5 `<audio>` element
   *
   * @param {Object} options
   * @param {String} options.token auth token
   * @param {String} options.text text to speak
   * @param {String} [options.voice=en-US_MichaelVoice] what voice to use - call getVoices() for a complete list.
   * @param {String} [options.accept] - specify desired audio format. Leave unset to allow (most) browsers to automatically negotiate an ideal format.
   * @param {Number} [options.X-Watson-Learning-Opt-Out=0] set to 1 to opt-out of allowing Watson to use this request to improve it's services
   * @param {Boolean} [options.autoPlay=true] automatically play the audio
   * @param {DOMAudioElement} [options.element] <audio> element - will be used instead of creating a new one if provided
   * @returns {Audio}
   * @see module:watson-speech/text-to-speech/get-voices
   */
  module.exports = function synthesize(options) {
    if (!options || !options.token) {
      throw new Error('Watson TextToSpeech: missing required parameter: options.token');
    }
    options['watson-token'] = options.token;
    delete options.token;
    var audio = options.element || new Audio();
    audio.crossOrigin = 'anonymous';
    audio.src = 'https://stream.watsonplatform.net/text-to-speech/api/v1/synthesize?' + qs.stringify(pick(options, QUERY_PARAMS_ALLOWED));
    if (options.autoPlay !== false) {
      audio.play();
    }
    return audio;
  };
  
  