Deploy the SAA
SAA(
app_name,
num_items = list(long_tones = 6L, arrhythmic = 10L, rhythmic = 10L),
num_examples = list(long_tones = 2L, arrhythmic = 2L, rhythmic = 0L),
arrhythmic_item_bank = SAA::Berkowitz_item_bank_subset,
rhythmic_item_bank = SAA::Berkowitz_item_bank_subset,
demographics = TRUE,
demo = FALSE,
feedback = FALSE,
admin_password = "demo",
SNR_test = TRUE,
get_range = TRUE,
absolute_url = character(),
examples = 2L,
final_results = TRUE,
test_username = character(),
gold_msi = TRUE,
with_final_page = FALSE,
melody_length = c(4, 20),
melody_sound = "piano",
adjust_range = TRUE,
test_name = "Singing Ability Assessment",
show_socials = FALSE,
headphones_test = TRUE,
get_user_info = TRUE,
microphone_test = TRUE,
allow_repeat_SNR_tests = TRUE,
append_trial_block_before = psychTestR::module("before"),
append_trial_block_after = psychTestR::module("after"),
stop_recording_after = 30,
max_goes = 3L,
max_goes_forced = FALSE,
long_tone_trials_as_screening = FALSE,
long_tone_trials_as_screening_failure_page = "http://www.google.com",
success_on_completion_page = NULL,
concise_wording = TRUE,
skip_setup = FALSE,
additional_scoring_measures = NULL,
default_range = NULL,
long_tone_paradigm = c("simultaneous_recall", "call_and_response"),
get_p_id = FALSE,
volume_meter_on_melody_trials = FALSE,
volume_meter_on_melody_trials_type = "default",
long_tone_length = 5,
allow_SNR_failure = FALSE,
requirements_page = TRUE,
report_SNR = FALSE,
show_introduction = TRUE,
show_instructions = TRUE,
asynchronous_api_mode = FALSE,
experiment_id = NULL,
user_id = NULL,
get_answer_melodic = musicassessr::get_answer_pyin_melodic_production,
sample_item_bank_via_api = FALSE,
pass_items_through_url_parameter = FALSE,
show_intro_text = TRUE,
show_microphone_type_page = TRUE,
num_items_review = list(long_tones = 0L, arrhythmic = 0L, rhythmic = 0L)
)Name of app.
The number of items as a list.
The number of example items as a list.
The item bank (created with itembankr) to deployed with the test.
The item bank (created with itembankr) to deployed with the test.
Deploy demographic form?
Is demo?
Give feedback after trials?
psychTestR admin password.
Deploy signal-to-noise ratio test?
Deploy a test to get the users range at test time and present stimuli accordingly?
If using online, absolute URL?
No of examples.
Display final results?
Is there a username for the user? This is different from a p_id.
Deploy Gold-MSI form?
Should there be a final page? FALSE if there will be more pages in the timeline.
What melody lengths should the test be constrained to?
Sound of melody? e.g, piano.
Should the range of the user, recorded at test time, be adjusted based on heuristics?
Custom name of the test.
Should social media sharing options be shown at the end?
Should there be a headphone test?
Grab user info via the browser?
Deploy a microphone test?
Logical. TRUE if participant can fail the SNR test threshold and try again.
A list of pages to go before the test.
A list of pages to go after the test.
Stop recording after a certain amount of time.
How many goes can the user have per melody?
Is this forced or optional?
Should long tone trials be used as a screening mechanism?
Where should users be directed to if they fail the long tone screening?
Where should users be directed to when they complete successfully?
TRUE for more detailed (but longer) instructions.
TRUE to skip setup steps.
A function or list of functions with additional measures for scoring pYIN data.
A list of the range that stimuli should be presented in, if not collected at test time.
Can be simultaneous_recall or call_and_response.
if TRUE, get the participant to enter their ID at the beginning of the test.
Should there be a volume meter displayed on melody trial pages?
= If so, what type? Can be 'default' or 'playful'.
How long should the long tone be in seconds? Default: 5
If TRUE, allow a participant/researcher to proceed, even if the SNR test is failed.
Show a requirements page on the setup?
Report SNR after test?
Should introduction be shown (or skipped)?
Should instructions be shown (or skipped)?
Should asynchronous API mode be used when using musicassessrdb?
The experiment ID, if using asynchronous_api_mode and applicable.
The user's ID, if using asynchronous_api_mode and applicable.
The get_answer function for melodic files.
Is the item bank being sampled via an API?
Are items being passed through a URL parameter?
Should intro text be shown?
Should you ask the participant what kind of microphone they are using?
Number of review items.