Plum DEV Documentation
developer_reference:audio

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Last revision Both sides next revision
developer_reference:audio [2019/05/15 15:07]
admin [Supported Audio Formats]
developer_reference:audio [2019/05/15 15:16]
admin [Supported Audio Formats]
Line 10: Line 10:
 ==== Supported Audio Formats ==== ==== Supported Audio Formats ====
 //When choosing your format keep in mind that our engine automatically runs the files through a compression µ-law algorithm. This means that all files will be down sampled to an 8-bit 8kHz. If you were to encode the files in a lower quality you would find the audio files you use would end up sounding better than your initial compression.// ​ //When choosing your format keep in mind that our engine automatically runs the files through a compression µ-law algorithm. This means that all files will be down sampled to an 8-bit 8kHz. If you were to encode the files in a lower quality you would find the audio files you use would end up sounding better than your initial compression.// ​
-    
-There are three audio formats for development that are always recommended:​ 
-  * 8 kHz 16-bit linear PCM WAV 
-  * 8 kHz 8-bit µ-law WAV 
-  * 32 kbps 16khz MP3 (anything larger is overkill) 
-  * **(all audio files must be mono not stereo)** 
  
 +== There are three audio formats for development that are always recommended (all audio files must be mono not stereo): ==
  
 ^ Sample Rate ^ Encoding ^ File Extension ^ ^ Sample Rate ^ Encoding ^ File Extension ^
 | 8000 (8kHz) |  16-bit linear PCM | .wav | | 8000 (8kHz) |  16-bit linear PCM | .wav |
 | 8000 (8kHz) |  8-bit µ-law WAV | .ul | | 8000 (8kHz) |  8-bit µ-law WAV | .ul |
-| 32000 (kps) | 16khz | .mp3 | +| 32000 (kps)| 16khz | .mp3 | 
- +Anything more would be overkill
- +
-The following audio formats are also supported for the <​audio>​ tag: +
- +
-  ​8 kHz 16-bit linear PCM headerless (*.l16) +
-  * 8 kHz 8-bit µ-law encoded headerless (*.ul) +
-  * 8 kHz 8-bit a-law encoded headerless (*.al) +
-  * 8 kHz 8-bit a-law WAV (*.wav) +
-  * MP3 (*.mp3) - Note: If the audio file is poorly encoded, the mp3 will not work. +
  
  
 +== The following audio formats are also supported for the <​audio>​ tag: ==
  
 ^ Sample Rate ^ Encoding ^ File Extension ^ ^ Sample Rate ^ Encoding ^ File Extension ^
Line 39: Line 27:
 | 8000 (8kHz) |  8-bit a-law encoded headerless | .al | | 8000 (8kHz) |  8-bit a-law encoded headerless | .al |
 | 8000 (8kHz) |  8-bit a-law WAV | .wav | | 8000 (8kHz) |  8-bit a-law WAV | .wav |
-| 32000 (kps) | 16khz | .mp3 |+| 32000 (kps)| 16khz | .mp3 | 
 +* If the audio file is poorly encoded, the mp3 will not work
 ==== Prompt Queuing and Barge-in Behavior ==== ==== Prompt Queuing and Barge-in Behavior ====