Merge pull request #503 from andrewvmail/cutting-other-app-music

pull out initAudioDevices from the constructor into its own api

docs/iosrtc.md

@@ -257,6 +257,20 @@ cordova.plugins.iosrtc.requestPermission(needMic, needCamera, function (permissi
 })
 ```
 
+### `iosrtc.initAudioDevices`
+
+Initialize the audio session, specifically setting the session's category and activating the session.
+This is to avoid cutting the audio of other applications on app boot.
+
+To use this install plugin using 
+```bash
+cordova plugin add cordova-plugin-iosrtc --variable MANUAL_INIT_AUDIO_DEVICE=TRUE
+```
+
+```javascript
+cordova.plugins.iosrtc.initAudioDevices();
+```
+
 ## Others
 
 

extra/renderer-and-libwebrtc-tests.js

@@ -8,6 +8,7 @@ if (cordova && cordova.plugins && cordova.plugins.iosrtc) {
   cordova.plugins.iosrtc.registerGlobals();
   //cordova.plugins.iosrtc.debug.disable('*', true);
   //cordova.plugins.iosrtc.debug.enable('*', true);
+  cordova.plugins.iosrtc.initAudioDevices();
   cordova.plugins.iosrtc.turnOnSpeaker(true);
   cordova.plugins.iosrtc.requestPermission(true, true, function (result) {
     console.log('requestPermission.result', result);

js/iosrtc.js

@@ -60,6 +60,9 @@ module.exports = {
 	// Checking permision (audio and camera)
 	requestPermission: requestPermission,
 
+	// Expose a function to initAudioDevices if needed, sets the audio session active
+	initAudioDevices: initAudioDevices,
+
 	// Expose a function to pollute window and naigator namespaces.
 	registerGlobals:       registerGlobals,
 
@@ -121,6 +124,12 @@ function requestPermission(needMic, needCamera, callback) {
 	exec(ok, error, 'iosrtcPlugin', "RTCRequestPermission", [needMic, needCamera]);
 }
 
+function initAudioDevices() {
+	debug('initAudioDevices()');
+
+	exec(null, null, 'iosrtcPlugin', "initAudioDevices", []);
+}
+
 function callbackifyMethod(originalMethod) {
 	return function (arg) { // jshint ignore:line
 		var success, failure,

plugin.xml

@@ -29,6 +29,12 @@
 			</feature>
 		</config-file>
 
+		<preference name="MANUAL_INIT_AUDIO_DEVICE" default="FALSE"/>
+
+		<config-file target="*-Info.plist" parent="ManualInitAudioDevice">
+			<string>$MANUAL_INIT_AUDIO_DEVICE</string>
+		</config-file>
+
 		<!-- Permission notes -->
 		<config-file parent="NSCameraUsageDescription" target="*-Info.plist">
 			<string>This Application uses your camera to make video calls.</string>

src/PluginRTCAudioController.swift

@@ -152,8 +152,11 @@ class PluginRTCAudioController {
 	static private var speakerEnabled: Bool = false
 
 	init() {
-
-		PluginRTCAudioController.initAudioDevices()
+        let shouldManualInit = Bundle.main.object(forInfoDictionaryKey: "ManualInitAudioDevice") as? String
+
+        if(shouldManualInit == "FALSE") {
+            PluginRTCAudioController.initAudioDevices()
+        }
 
 		NotificationCenter.default.addObserver(
 			self,

src/iosrtcPlugin.swift

@@ -1058,6 +1058,12 @@ class iosrtcPlugin : CDVPlugin {
 		}
 	}
 
+	@objc(initAudioDevices:) func initAudioDevices(_ command: CDVInvokedUrlCommand) {
+		NSLog("iosrtcPlugin#initAudioDevices()")
+
+		PluginRTCAudioController.initAudioDevices()
+	}
+
 	@objc(RTCTurnOnSpeaker:) func RTCTurnOnSpeaker(_ command: CDVInvokedUrlCommand) {
 		DispatchQueue.main.async {
 			let isTurnOn: Bool = CBool(command.arguments[0] as! Bool)