(Return to Top)

The Docs

Create an audio object.

When this object is returned by an input cell or passed to the display function, it will result in Audio controls being displayed in the frontend (only works in the notebook).

Parameters
        - data (numpy array, list, unicode, str or bytes) –
        - Can be one of
                - Numpy 1d array containing the desired waveform (mono)
                - Numpy 2d array containing waveforms for each channel. Shape=(NCHAN, NSAMPLES). For the standard channel order, see http://msdn.microsoft.com/en-us/library/windows/hardware/dn653308(v=vs.85).aspx
                - List of float or integer representing the waveform (mono)
                - String containing the filename
                - Bytestring containing raw PCM data or
                - URL pointing to a file on the web.
        - If the array option is used, the waveform will be normalized.
        - If a filename or url is used, the format support will be browser dependent.
        - url (unicode) – A URL to download the data from.
        - filename (unicode) – Path to a local file to load the data from.
        - embed (boolean) – Should the audio data be embedded using a data URI (True) or should the original source be referenced. Set this to True if you want the audio to playable later with no internet connection in the notebook.
        - Default is True, unless the keyword argument url is set, then default value is False.
        - rate (integer) – The sampling rate of the raw data. Only required when data parameter is being used as an array
        - autoplay (bool) – Set to True if the audio should immediately start playing. Default is False.
        - normalize (bool) – Whether audio should be normalized (rescaled) to the maximum possible range. Default is True. When set to False, data must be between -1 and 1 (inclusive), otherwise an error is raised. Applies only when data is a list or array of samples; other types of audio are never normalized.