/** * jspsych-audio-keyboard-response * Josh de Leeuw * * plugin for playing an audio file and getting a keyboard response * * documentation: docs.jspsych.org * **/ jsPsych.plugins["audio-keyboard-response"] = (function() { var plugin = {}; jsPsych.pluginAPI.registerPreload('audio-keyboard-response', 'stimulus', 'audio'); plugin.info = { name: 'audio-keyboard-response', description: '', parameters: { stimulus: { type: jsPsych.plugins.parameterType.AUDIO, default: undefined, no_function: false, description: '' }, choices: { type: jsPsych.plugins.parameterType.KEYCODE, array: true, default: jsPsych.ALL_KEYS, no_function: false, description: '' }, prompt: { type: jsPsych.plugins.parameterType.STRING, default: '', no_function: false, description: '' }, trial_duration: { type: jsPsych.plugins.parameterType.INT, default: -1, no_function: false, description: '' }, response_ends_trial: { type: jsPsych.plugins.parameterType.BOOL, default: true, no_function: false, description: '' }, trial_ends_after_audio: { type: jsPsych.plugins.parameterType.BOOL, default: false, no_function: false, description: '' }, } } plugin.trial = function(display_element, trial) { // setup stimulus var context = jsPsych.pluginAPI.audioContext(); if(context !== null){ var source = context.createBufferSource(); source.buffer = jsPsych.pluginAPI.getAudioBuffer(trial.stimulus); source.connect(context.destination); } else { var audio = jsPsych.pluginAPI.getAudioBuffer(trial.stimulus); audio.currentTime = 0; } // set up end event if trial needs it if(trial.trial_ends_after_audio){ if(context !== null){ source.onended = function() { end_trial(); } } else { audio.addEventListener('ended', end_trial); } } // show prompt if there is one if (trial.prompt !== "") { display_element.innerHTML = trial.prompt; } // store response var response = { rt: -1, key: -1 }; // function to end trial when it is time function end_trial() { // kill any remaining setTimeout handlers jsPsych.pluginAPI.clearAllTimeouts(); // stop the audio file if it is playing // remove end event listeners if they exist if(context !== null){ source.stop(); source.onended = function() { } } else { audio.pause(); audio.removeEventListener('ended', end_trial); } // kill keyboard listeners jsPsych.pluginAPI.cancelAllKeyboardResponses(); // gather the data to store for the trial var trial_data = { "rt": context !== null ? response.rt * 1000 : response.rt, "stimulus": trial.stimulus, "key_press": response.key }; // clear the display display_element.innerHTML = ''; // move on to the next trial jsPsych.finishTrial(trial_data); }; // function to handle responses by the subject var after_response = function(info) { // only record the first response if (response.key == -1) { response = info; } if (trial.response_ends_trial) { end_trial(); } }; // start audio if(context !== null){ startTime = context.currentTime + 0.1; source.start(startTime); } else { audio.play(); } // start the response listener if(context !== null) { var keyboardListener = jsPsych.pluginAPI.getKeyboardResponse({ callback_function: after_response, valid_responses: trial.choices, rt_method: 'audio', persist: false, allow_held_key: false, audio_context: context, audio_context_start_time: startTime }); } else { var keyboardListener = jsPsych.pluginAPI.getKeyboardResponse({ callback_function: after_response, valid_responses: trial.choices, rt_method: 'date', persist: false, allow_held_key: false }); } // end trial if time limit is set if (trial.trial_duration > 0) { jsPsych.pluginAPI.setTimeout(function() { end_trial(); }, trial.trial_duration); } }; return plugin; })();