From 10a3ff10a011fbdc5a2f4422c7f6879611767fe5 Mon Sep 17 00:00:00 2001 From: Dustin Popp Date: Fri, 4 Oct 2019 16:06:07 -0500 Subject: [PATCH] feat: update parameter names in recognize/synthesize streams to be lower camel case * this is to match the recent changes in the watson node sdk * `access_token` is renamed to `accessToken` in all modules --- CHANGELOG.md | 6 + examples/server.js | 4 +- examples/static/index.html | 2 +- examples/static/microphone-alternatives.html | 2 +- .../microphone-streaming-text-to-console.html | 2 +- .../static/microphone-word-confidence.html | 2 +- .../static/speaker-labels-file-console.html | 2 +- examples/static/speaker-stream-file-html.html | 2 +- package-lock.json | 413 +++++++++--------- package.json | 2 +- speech-to-text/get-models.js | 12 +- speech-to-text/recognize-file.js | 22 +- speech-to-text/recognize-microphone.js | 20 +- speech-to-text/recognize-stream.js | 153 +++---- test/resources/offline_test_server.js | 2 +- text-to-speech/get-voices.js | 10 +- text-to-speech/synthesize.js | 22 +- util/process-user-parameters.js | 41 ++ 18 files changed, 385 insertions(+), 334 deletions(-) create mode 100644 util/process-user-parameters.js diff --git a/CHANGELOG.md b/CHANGELOG.md index 7fe7bdd1..9501ddc6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,11 @@ # Changelog +### v0.37.0 +* BREAKING CHANGES INTRODUCED: + * All options parameters for all methods are coverted to be lowerCamelCase + * For example: `access_token` is now `accessToken` and `content-type` is now `contentType` + * Response data from the service is not affected by this change + ### v0.34.0 * Add support for guessing .mp3 (via file name & header) & .webm (via filename) content-types * Re-factored content-type guessing to check filename first, and file header second diff --git a/examples/server.js b/examples/server.js index 321b93cb..cc02ad00 100644 --- a/examples/server.js +++ b/examples/server.js @@ -94,7 +94,7 @@ app.use('/api/speech-to-text/token', function(req, res) { } const token = response.token || response; if (process.env.SPEECH_TO_TEXT_IAM_APIKEY) { - res.json({ access_token: token, url: sttCredentials.url }); + res.json({ accessToken: token, url: sttCredentials.url }); } else { res.json({ token: token, url: sttCredentials.url }); } @@ -121,7 +121,7 @@ app.use('/api/text-to-speech/token', function(req, res) { } const token = response.token || response; if (process.env.TEXT_TO_SPEECH_IAM_APIKEY) { - res.json({ access_token: token, url: ttsCredentials.url }); + res.json({ accessToken: token, url: ttsCredentials.url }); } else { res.json({ token: token, url: ttsCredentials.url }); } diff --git a/examples/static/index.html b/examples/static/index.html index a7805437..2c0389af 100644 --- a/examples/static/index.html +++ b/examples/static/index.html @@ -32,7 +32,7 @@

File Input

Transcribe and Play a file via URL, with pre-loaded token (compatible with iOS)
Transcribe and Play a user-provided file
Transcribe from URL with {speaker_labels: true}, output to console
Transcribe from URL with {speakerLabels: true}, output to console
Transcribe from URL with {resultsBySpeaker: true}, output to console
Transcribe from URL with {resultsBySpeaker: true}, output HTML
Compare realtime and TimingStream options

Code for this demo:

} + * @param {String} options.accessToken IAM access token for RC services + * @return {Promise} */ module.exports = function getModels(options) { - if (!options || (!options.token && !options.access_token)) { - throw new Error('Watson SpeechToText: missing required auth parameter: options.token (CF) or options.access_token (RC)'); + if (!options || (!options.token && !options.accessToken)) { + throw new Error('Watson SpeechToText: missing required auth parameter: options.token (CF) or options.accessToken (RC)'); } var reqOpts = { credentials: 'omit', @@ -53,8 +53,8 @@ module.exports = function getModels(options) { } }; var url = options.url || 'https://stream.watsonplatform.net/speech-to-text/api'; - if (options.access_token) { - url = url + '/v1/models?access_token=' + options.access_token; + if (options.accessToken) { + url = url + '/v1/models?access_token=' + options.accessToken; } else { url = url + '/v1/models?access_token=' + options.token; } diff --git a/speech-to-text/recognize-file.js b/speech-to-text/recognize-file.js index 65fd4269..1e6698f0 100644 --- a/speech-to-text/recognize-file.js +++ b/speech-to-text/recognize-file.js @@ -38,7 +38,7 @@ var fetch = require('nodeify-fetch'); // like regular fetch, but with an extra m * @param {Object} options - Also passed to {MediaElementAudioStream} and to {RecognizeStream} * @param {String} [options.url='wss://stream.watsonplatform.net/speech-to-text/api'] - Base URL for a service instance * @param {String} options.token - Auth Token for CF services - see https://github.com/watson-developer-cloud/node-sdk#authorization - * @param {String} options.access_token - IAM Access Token for RC services - see https://github.com/watson-developer-cloud/node-sdk#authorization + * @param {String} options.accessToken - IAM Access Token for RC services - see https://github.com/watson-developer-cloud/node-sdk#authorization * @param {Blob|FileString} options.file - String url or the raw audio data as a Blob or File instance to be transcribed (and optionally played). Playback may not with with Blob or File on mobile Safari. * @param {Boolean} [options.play=false] - If a file is set, play it locally as it's being uploaded * @param {Boolena} [options.format=true] - pipe the text through a {FormatStream} which performs light formatting. Also controls smart_formatting option unless explicitly set. @@ -51,8 +51,8 @@ var fetch = require('nodeify-fetch'); // like regular fetch, but with an extra m */ module.exports = function recognizeFile(options) { // eslint-disable-line complexity - if (!options || (!options.token && !options.access_token)) { - throw new Error('WatsonSpeechToText: missing required parameter: opts.token (CF) or opts.access_token (RC)'); + if (!options || (!options.token && !options.accessToken)) { + throw new Error('WatsonSpeechToText: missing required parameter: opts.token (CF) or opts.accessToken (RC)'); } if (options.data && !options.file) { @@ -75,14 +75,14 @@ module.exports = function recognizeFile(options) { // SpeakerStream requires objectMode and speaker_labels if (options.resultsBySpeaker) { options.objectMode = true; - options.speaker_labels = true; + options.speakerLabels = true; } // default format to true (capitals and periods) - // default smart_formatting to options.format value (dates, currency, etc.) + // default smartFormatting to options.format value (dates, currency, etc.) options.format = options.format !== false; - if (typeof options.smart_formatting === 'undefined') { - options.smart_formatting = options.format; + if (typeof options.smartFormatting === 'undefined') { + options.smartFormatting = options.format; } var realtime = options.realtime || (typeof options.realtime === 'undefined' && options.play); @@ -94,13 +94,13 @@ module.exports = function recognizeFile(options) { // Attempt to guess content-type based on filename // If this fails, recognizeStream will make a second attempt based on the file header - if (!options['content-type']) { - options['content-type'] = contentType.fromFilename(options.file); + if (!options.contentType) { + options.contentType = contentType.fromFilename(options.file); } var rsOpts = assign( { - interim_results: true + interimResults: true }, options ); @@ -152,7 +152,7 @@ module.exports = function recognizeFile(options) { if (options.play) { // when file playback actually begins // (mostly important for downloaded files) - FilePlayer.playFile(options.file, options['content-type']) + FilePlayer.playFile(options.file, options.contentType) .then(function(player) { recognizeStream.on('stop', player.stop.bind(player)); recognizeStream.on('error', player.stop.bind(player)); diff --git a/speech-to-text/recognize-microphone.js b/speech-to-text/recognize-microphone.js index e6ae1354..328cbe6e 100644 --- a/speech-to-text/recognize-microphone.js +++ b/speech-to-text/recognize-microphone.js @@ -45,7 +45,7 @@ var bitBucket = new Writable({ * * @param {Object} options - Also passed to {RecognizeStream}, and {FormatStream} when applicable * @param {String} options.token - Auth Token for CF services - see https://github.com/watson-developer-cloud/node-sdk#authorization - * @param {String} options.access_token - IAM Access Token for RC services - see https://github.com/watson-developer-cloud/node-sdk#authorization + * @param {String} options.accessToken - IAM Access Token for RC services - see https://github.com/watson-developer-cloud/node-sdk#authorization * @param {String} [options.url='wss://stream.watsonplatform.net/speech-to-text/api'] - Base URL for a service instance * @param {Boolean} [options.format=true] - pipe the text through a FormatStream which performs light formatting. Also controls smart_formatting option unless explicitly set. * @param {Boolean} [options.keepMicrophone=false] - keeps an internal reference to the microphone stream to reuse in subsequent calls (prevents multiple permissions dialogs in firefox) @@ -57,8 +57,8 @@ var bitBucket = new Writable({ * @return {RecognizeStream|SpeakerStream|FormatStream|ResultStream} */ module.exports = function recognizeMicrophone(options) { - if (!options || (!options.token && !options.access_token)) { - throw new Error('WatsonSpeechToText: missing required parameter: opts.token (CF) or opts.access_token (RC)'); + if (!options || (!options.token && !options.accessToken)) { + throw new Error('WatsonSpeechToText: missing required parameter: opts.token (CF) or opts.accessToken (RC)'); } // the WritableElementStream works best in objectMode @@ -69,23 +69,23 @@ module.exports = function recognizeMicrophone(options) { if (options.extractResults) { options.objectMode = true; } - // SpeakerStream requires objectMode and speaker_labels + // SpeakerStream requires objectMode and speakerLabels if (options.resultsBySpeaker) { options.objectMode = true; - options.speaker_labels = true; + options.speakerLabels = true; } // default format to true (capitals and periods) - // default smart_formatting to options.format value (dates, currency, etc.) + // default smartFormatting to options.format value (dates, currency, etc.) options.format = options.format !== false; - if (typeof options.smart_formatting === 'undefined') { - options.smart_formatting = options.format; + if (typeof options.smartFormatting === 'undefined') { + options.smartFormatting = options.format; } var rsOpts = assign( { - 'content-type': 'audio/l16;rate=16000', - interim_results: true + contentType: 'audio/l16;rate=16000', + interimResults: true }, options ); diff --git a/speech-to-text/recognize-stream.js b/speech-to-text/recognize-stream.js index e5929497..86f4b619 100644 --- a/speech-to-text/recognize-stream.js +++ b/speech-to-text/recognize-stream.js @@ -18,45 +18,11 @@ var { Duplex } = require('readable-stream'); var util = require('util'); -var pick = require('object.pick'); var W3CWebSocket = require('websocket').w3cwebsocket; var contentType = require('./content-type'); +var processUserParameters = require('../util/process-user-parameters.js'); var qs = require('../util/querystring.js'); -var OPENING_MESSAGE_PARAMS_ALLOWED = [ - 'action', - 'customization_weight', - 'processing_metrics', - 'processing_metrics_interval', - 'audio_metrics', - 'inactivity_timeout', - 'timestamps', - 'word_confidence', - 'content-type', - 'interim_results', - 'keywords', - 'keywords_threshold', - 'max_alternatives', - 'word_alternatives_threshold', - 'profanity_filter', - 'smart_formatting', - 'speaker_labels', - 'grammar_name', - 'redaction' -]; - -var QUERY_PARAMS_ALLOWED = [ - 'model', - 'X-Watson-Learning-Opt-Out', - 'watson-token', - 'language_customization_id', - 'customization_id', - 'acoustic_customization_id', - 'access_token', - 'base_model_version', - 'x-watson-metadata' -]; - /** * pipe()-able Node.js Duplex stream - accepts binary audio and emits text/objects in it's `data` events. * @@ -67,29 +33,36 @@ var QUERY_PARAMS_ALLOWED = [ * * Note that the WebSocket connection is not established until the first chunk of data is recieved. This allows for auto-detection of content type (for wav/flac/opus audio). * - * @param {Object} options - * @param {String} [options.model='en-US_BroadbandModel'] - voice model to use. Microphone streaming only supports broadband models. - * @param {String} [options.url='wss://stream.watsonplatform.net/speech-to-text/api'] base URL for service - * @param {String} [options.token] - Auth token for CF services - * @param {String} options.access_token - IAM Access Token for RC services - * @param {Object} [options.headers] - Only works in Node.js, not in browsers. Allows for custom headers to be set, including an Authorization header (preventing the need for auth tokens) - * @param {String} [options.content-type='audio/wav'] - content type of audio; can be automatically determined from file header in most cases. only wav, flac, ogg/opus, and webm are supported - * @param {Boolean} [options.interim_results=false] - Send back non-final previews of each "sentence" as it is being processed. These results are ignored in text mode. - * @param {Boolean} [options.word_confidence=false] - include confidence scores with results. - * @param {Boolean} [options.timestamps=false] - include timestamps with results. - * @param {Number} [options.max_alternatives=1] - maximum number of alternative transcriptions to include. - * @param {Array} [options.keywords] - a list of keywords to search for in the audio - * @param {Number} [options.keywords_threshold] - Number between 0 and 1 representing the minimum confidence before including a keyword in the results. Required when options.keywords is set - * @param {Number} [options.word_alternatives_threshold] - Number between 0 and 1 representing the minimum confidence before including an alternative word in the results. Must be set to enable word alternatives, - * @param {Boolean} [options.profanity_filter=false] - set to true to filter out profanity and replace the words with *'s - * @param {Number} [options.inactivity_timeout=30] - how many seconds of silence before automatically closing the stream. use -1 for infinity - * @param {Boolean} [options.readableObjectMode=false] - emit `result` objects instead of string Buffers for the `data` events. Does not affect input (which must be binary) - * @param {Boolean} [options.objectMode=false] - alias for options.readableObjectMode - * @param {Number} [options.X-Watson-Learning-Opt-Out=false] - set to true to opt-out of allowing Watson to use this request to improve it's services - * @param {Boolean} [options.smart_formatting=false] - formats numeric values such as dates, times, currency, etc. - * @param {String} [options.customization_id] - Customization ID - * @param {String} [options.acoustic_customization_id] - Acoustic customization ID - * @param {String} [options.grammar_name] - Name of grammar + * @param {Options} options + * @param {string} [options.url] - Base url for service (default='wss://stream.watsonplatform.net/speech-to-text/api') + * @param {OutgoingHttpHeaders} [options.headers] - Only works in Node.js, not in browsers. Allows for custom headers to be set, including an Authorization header (preventing the need for auth tokens) + * @param {boolean} [options.readableObjectMode] - Emit `result` objects instead of string Buffers for the `data` events. Does not affect input (which must be binary) + * @param {boolean} [options.objectMode] - Alias for readableObjectMode + * @param {string} [options.accessToken] - Bearer token to put in query string + * @param {string} [options.model] - The identifier of the model that is to be used for all recognition requests sent over the connection + * @param {string} [options.languageCustomizationId] - The customization ID (GUID) of a custom language model that is to be used for all requests sent over the connection + * @param {string} [options.acousticCustomizationId] - The customization ID (GUID) of a custom acoustic model that is to be used for the request + * @param {string} [options.baseModelVersion] - The version of the specified base model that is to be used for all requests sent over the connection + * @param {boolean} [options.xWatsonLearningOptOut] - Indicates whether IBM can use data that is sent over the connection to improve the service for future users (default=false) + * @param {string} [options.xWatsonMetadata] - Associates a customer ID with all data that is passed over the connection. The parameter accepts the argument customer_id={id}, where {id} is a random or generic string that is to be associated with the data + * @param {string} [options.contentType] - The format (MIME type) of the audio + * @param {number} [options.customizationWeight] - Tell the service how much weight to give to words from the custom language model compared to those from the base model for the current request + * @param {number} [options.inactivityTimeout] - The time in seconds after which, if only silence (no speech) is detected in the audio, the connection is closed (default=30) + * @param {boolean} [options.interimResults] - If true, the service returns interim results as a stream of JSON SpeechRecognitionResults objects (default=false) + * @param {string[]} [options.keywords] - An array of keyword strings to spot in the audio + * @param {number} [options.keywordsThreshold] - A confidence value that is the lower bound for spotting a keyword + * @param {number} [options.maxAlternatives] - The maximum number of alternative transcripts that the service is to return (default=1) + * @param {number} [options.wordAlternativesThreshold] - A confidence value that is the lower bound for identifying a hypothesis as a possible word alternative + * @param {boolean} [options.wordConfidence] - If true, the service returns a confidence measure in the range of 0.0 to 1.0 for each word (default=false) + * @param {boolean} [options.timestamps] - If true, the service returns time alignment for each word (default=false) + * @param {boolean} [options.profanityFilter] - If true, the service filters profanity from all output except for keyword results by replacing inappropriate words with a series of asterisks (default=true) + * @param {boolean} [options.smartFormatting] - If true, the service converts dates, times, series of digits and numbers, phone numbers, currency values, and internet addresses into more readable, conventional representations (default=false) + * @param {boolean} [options.speakerLabels] - If true, the response includes labels that identify which words were spoken by which participants in a multi-person exchange (default=false) + * @param {string} [options.grammarName] - The name of a grammar that is to be used with the recognition request + * @param {boolean} [options.redaction] - If true, the service redacts, or masks, numeric data from final transcripts (default=false) + * @param {boolean} [options.processingMetrics] - If true, requests processing metrics about the service's transcription of the input audio (default=false) + * @param {number} [options.processingMetricsInterval] - Specifies the interval in seconds at which the service is to return processing metrics + * @param {boolean} [options.audioMetrics] - If true, requests detailed information about the signal characteristics of the input audio (detailed=false) * * @constructor */ @@ -152,31 +125,63 @@ RecognizeStream.WEBSOCKET_CONNECTION_ERROR = 'WebSocket connection error'; RecognizeStream.prototype.initialize = function() { var options = this.options; - if (options.token && !options['watson-token']) { - options['watson-token'] = options.token; + if (options.token && !options['watsonToken']) { + options['watsonToken'] = options.token; } - if (options.content_type && !options['content-type']) { - options['content-type'] = options.content_type; + if (options.content_type && !options['contentType']) { + options['contentType'] = options.content_type; } - if (options['X-WDC-PL-OPT-OUT'] && !options['X-Watson-Learning-Opt-Out']) { - options['X-Watson-Learning-Opt-Out'] = options['X-WDC-PL-OPT-OUT']; + if (options['X-WDC-PL-OPT-OUT'] && !options['xWatsonLearningOptOut']) { + options['xWatsonLearningOptOut'] = options['X-WDC-PL-OPT-OUT']; } // compatibility code for the deprecated param, customization_id - if (options.customization_id && !options.language_customization_id) { - options.language_customization_id = options.customization_id; + if (options.customization_id && !options.languageCustomizationId) { + options.languageCustomizationId = options.customization_id; delete options.customization_id; } - var queryParams = util._extend( - 'language_customization_id' in options ? pick(options, QUERY_PARAMS_ALLOWED) : { model: 'en-US_BroadbandModel' }, - pick(options, QUERY_PARAMS_ALLOWED) - ); - + // process query params + var queryParamsAllowed = [ + 'access_token', + 'watson-token', + 'model', + 'language_customization_id', + 'acoustic_customization_id', + 'base_model_version', + 'x-watson-learning-opt-out', + 'x-watson-metadata' + ]; + var queryParams = processUserParameters(options, queryParamsAllowed); + if (!queryParams.language_customization_id && !queryParams.model) { + queryParams.model = 'en-US_BroadbandModel'; + } var queryString = qs.stringify(queryParams); + var url = (options.url || 'wss://stream.watsonplatform.net/speech-to-text/api').replace(/^http/, 'ws') + '/v1/recognize?' + queryString; - var openingMessage = pick(options, OPENING_MESSAGE_PARAMS_ALLOWED); + // process opening payload params + var openingMessageParamsAllowed = [ + 'customization_weight', + 'processing_metrics', + 'processing_metrics_interval', + 'audio_metrics', + 'inactivity_timeout', + 'timestamps', + 'word_confidence', + 'content-type', + 'interim_results', + 'keywords', + 'keywords_threshold', + 'max_alternatives', + 'word_alternatives_threshold', + 'profanity_filter', + 'smart_formatting', + 'speaker_labels', + 'grammar_name', + 'redaction' + ]; + var openingMessage = processUserParameters(options, openingMessageParamsAllowed); openingMessage.action = 'start'; var self = this; @@ -337,10 +342,10 @@ RecognizeStream.prototype._write = function(chunk, encoding, callback) { return; } if (!this.initialized) { - if (!this.options['content-type']) { + if (!this.options.contentType) { var ct = RecognizeStream.getContentType(chunk); if (ct) { - this.options['content-type'] = ct; + this.options.contentType = ct; } else { var err = new Error('Unable to determine content-type from file header, please specify manually.'); err.name = RecognizeStream.ERROR_UNRECOGNIZED_FORMAT; diff --git a/test/resources/offline_test_server.js b/test/resources/offline_test_server.js index 8f7decf9..66880d44 100644 --- a/test/resources/offline_test_server.js +++ b/test/resources/offline_test_server.js @@ -21,7 +21,7 @@ module.exports = function(app, log) { }); app.get('/iam-token', function(req, res) { - res.json({ access_token: token, url: 'http://localhost:' + API_PORT + '/speech-to-text/api' }); + res.json({ accessToken: token, url: 'http://localhost:' + API_PORT + '/speech-to-text/api' }); }); // we don't have access to the actual http server in the karma-express plugin, so just creating a new one on a different port diff --git a/text-to-speech/get-voices.js b/text-to-speech/get-voices.js index efea5323..c1226fcc 100644 --- a/text-to-speech/get-voices.js +++ b/text-to-speech/get-voices.js @@ -40,12 +40,12 @@ * @param {Object} options * @param {String} options.url=https://stream.watsonplatform.net/text-to-speech/api URL for Watson Text to Speech API * @param {String} options.token auth token for CF services - * @param {String} options.access_token IAM access token for RC services + * @param {String} options.accessToken IAM access token for RC services * @return {Promise.} */ module.exports = function getVoices(options) { - if (!options || (!options.token && !options.access_token)) { - throw new Error('Watson TextToSpeech: missing required auth parameter: options.token (CF) or options.access_token (RC)'); + if (!options || (!options.token && !options.accessToken)) { + throw new Error('Watson TextToSpeech: missing required auth parameter: options.token (CF) or options.accessToken (RC)'); } var reqOpts = { credentials: 'omit', @@ -54,8 +54,8 @@ module.exports = function getVoices(options) { } }; var url = options.url || 'https://stream.watsonplatform.net/text-to-speech/api'; - if (options.access_token) { - url = url + '/v1/voices?watson-token=' + options.access_token; + if (options.accessToken) { + url = url + '/v1/voices?watson-token=' + options.accessToken; } else { url = url + '/v1/voices?watson-token=' + options.token; } diff --git a/text-to-speech/synthesize.js b/text-to-speech/synthesize.js index 4ac56d85..a4821a69 100644 --- a/text-to-speech/synthesize.js +++ b/text-to-speech/synthesize.js @@ -14,11 +14,9 @@ * limitations under the License. */ 'use strict'; -var pick = require('object.pick'); +var processUserParameters = require('../util/process-user-parameters.js'); var qs = require('../util/querystring.js'); -var QUERY_PARAMS_ALLOWED = ['voice', 'X-WDC-PL-OPT-OUT', 'X-Watson-Learning-Opt-Out', 'text', 'watson-token', 'access_token', 'accept', 'customization_id']; - /** * @module watson-speech/text-to-speech/synthesize */ @@ -31,29 +29,31 @@ var QUERY_PARAMS_ALLOWED = ['voice', 'X-WDC-PL-OPT-OUT', 'X-Watson-Learning-Opt- * @param {Object} options * @param {String} options.url=https://stream.watsonplatform.net/text-to-speech/api URL for Watson Text to Speech API * @param {String} [options.token] - Auth token for CF services - * @param {String} options.access_token - IAM Access Token for RC services + * @param {String} options.accessToken - IAM Access Token for RC services * @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.customization_id] GUID of a custom voice model. Omit to use the voice with no customization. + * @param {String} [options.customizationId] GUID of a custom voice model. Omit to use the voice with no customization. * @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 {Number} [options.xWatsonLearningOptOut=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]