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
Next revision
Previous revision
developer_reference:audio [2019/05/15 15:07]
admin [Supported Audio Formats]
developer_reference:audio [2019/05/15 15:20]
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 (32kps)| 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 (32kps)| 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 ====