cordova-plugin-audioroute's Introduction

cordova-plugin-audioroute

This plugin works on iOS only.

This plugin allows applications to get notified audio about route changes (for example when a headset is connected), and also to query and override the audio device in use.

Installation

The plugin can be installed using the Cordova CLI tool:

cordova plugin add cordova-plugin-audioroute --save

API

All these functions are available in the cordova.plugins.audioroute namespace.

currentOutputs(successCallback, errorCallback)

Get an Array of the currently connected audio ports. The possible elements are:

line-out
headphones
bluetooth-a2dp
builtin-receiver
builtin-speaker
hdmi
airplay
bluetooth-le
unknown

overrideOutput(output, successCallback, errorCallback)

Overrides the audio output device. output must be one of default or speaker.

"audioroute-changed" event

When the audio route has changed a 'audioroute-changed' event will be fired in document. It contains the reason as associated data, which can be one of:

unknown
new-device-available
old-device-unavailable
category-change
override
wake-from-sleep
no-suitable-route-for-category
route-config-change

Example:

document.addEventListener('audioroute-changed',
                          function(event) {
                              console.log('Audio route changed: ' + event.reason);
                          });

License

MIT

Author

Saúl Ibarra Corretgé [email protected]

This work has been sponsored by AG Projects.

cordova-plugin-audioroute's People

Contributors

Stargazers

Watchers

cordova-plugin-audioroute's Issues

Example for output to speakers in Cordova ios rtc app...

Hello!
I am trying to get my cordova app ios rtc to play the sound through the speakers... I installed the plugin but dont know how to use it... Can someone help me out?

Can't use

I can't seem to get access the audioroute object

cordova.plugins.audioroute.overrideOutput('speaker') doesn't work.

cordova.plugins and window.cordova.plugins are undefined.

Can you please provide examples of use?

Can i have and example of how to override audio route in iOS 10

Hi i'm trying to route audio to front top speaker where i hear voice during a call.

I'm creating an app to call using webrtc and i need to hear sound in outgoing call from the front top speaker.

I tried:
cordova.plugins.audioroute.overrideOutput('speaker');
but doesn't work.

I'm using cordova-plugin-iosrtc i cant find a plugin for ios 10 that toggle audio from a speaker to another.

Not routing to speakers

Maybe I am doing something wrong or calling this at the wrong point in my code but it doesnt work. RTC sounds still come from the phones earpiece and not the speakers when I call

cordova.plugins.audioroute.overrideOutput("speaker", r => console.log(r), err => console.error(err));

I am calling this at the point where theres a rtc offer. Thanks.

Using iOS 5.

Recommend Projects

saghul / cordova-plugin-audioroute Goto Github PK