Creates a page for the participant to calibrate their volume, using example audio, and the volume controls on their computer.

volume_calibration_page(url, type = tools::file_ext(url),
  prompt = NULL, button_text = "Next", on_complete = NULL,
  admin_ui = NULL, btn_play_prompt = "Click here to play")

Arguments

url

URL to the audio. Can be an absolute URL (e.g. "http://mysite.com/audio.mp3") or a URL relative to the /www directory (e.g. "audio.mp3").

type

Audio type (e.g. 'mp3'). Defaults to the provided file extension.

prompt

Prompt to be displayed. If left NULL, a sensible English prompt is provided.

button_text

Button text (character scalar).

on_complete

Optional function to execute on leaving the page (after successful validation). The argument list should include ..., and any of: state, the participant's state object; answer, the participant's most recent answer; input, the current page's Shiny input object; session, the current Shiny session object; opt, the test's option list as created by test_options().

admin_ui

Optional UI component for the admin panel.

btn_play_prompt

Text to display as a prompt for starting the audio. Ordinarily the participant will not see this, but it might appear if the internet connection is poor, or if the participant refreshes the page.