Skip to content

Experience-Monks/detect-media-element-source

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

detect-media-element-source

experimental

Detects whether the browser correctly supports WebAudio's createMediaElementSource(), by playing a short looping noise segment and seeing whether signal is non-zero.

For example: Desktop Chrome/FF support media element sources, but mobile iOS 9.2 Safari does not. In unsupported browsers, you need to buffer and decode the entire audio file in order to use it with the WebAudio API.

Note ⚠️

Because of the way the WebAudio and browser APIs are constantly in flux, this may not be a robust and long-term solution to detecting this feature. There is no reliable way to detect this feature across all browsers, except for actually watching the result of an AnalyserNode over your own <audio> source, and then falling back to a buffer source in such a case. However, that requires additional UX hurdles on mobile (for touch-to-play audio).

Install

npm install detect-media-element-source --save

Example

var detectMedia = require('detect-media-element-source')

detectMedia(function (supported) {
  if (supported) {
    // ... audioContext.createMediaElementSource()
  } else {
    // ... audioContext.createBufferSource()
  }
})

Usage

NPM

detectMediaElementSource(cb, [audioContext], [timeoutDelay], [ignoreCache])

Detects whether createMediaElementSource works as expected with the WebAudio API, calling cb with true if supported, false otherwise.

audioContext is optional (a new temporary context will be used) but encouraged.

timeoutDelay defaults to 250ms (550ms if userAgent shows Safari), but can be configured to allow the loop to play for a longer/shorter time before deciding the result.

License

MIT, see LICENSE.md for details.

About

detects whether the browser supports WebAudio music streaming

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published