Update README for 1.1.0

* add ringtone/ringback/busytone support
* fix and refine forceSpeakerphoneOn
* some audio routing bug fixes

Author: zxcpoiu

README.md

@@ -5,7 +5,10 @@ Handling media-routes/sensors/events during a audio/video chat on React Native
 The purpose of this module is to handle actions/events during a phone call (audio/video) on `react-native`, ex:
 * manage devices events like wired-headset plugged, proximity sensors and expose to javascript.
 * automatically route audio to proper device based on events and platform API.
-* ( not implemented yet ) toggle flash light on/off, force microphone mute
+* toggle speaker or microphone on/off, toggle flash light on/off (not implemented yes)
+* play ringtone/ringback/dtmftone
+
+basically, it is a telecommunication module which handle most of requirements when making/receiving/talking to a call.
 
 This module is desinged to work with [react-native-webrtc](https://github.com/oney/react-native-webrtc)
 you can find demo here: https://github.com/oney/RCTWebRTCDemo
@@ -21,6 +24,21 @@ you can find demo here: https://github.com/oney/RCTWebRTCDemo
 After install, you can use `rnpm` (`npm install rnpm -g`) to link android.  
 use `rnpm link react-native-incall-manager` to link or manually if you like.
 
+**optional sound files on android**
+if you want to use bundled ringtone/ringback/busytone sound instead of system sound 
+
+put files in `android/app/src/main/res/raw`
+and rename file correspond to sound type:
+
+```
+incallmanager_busytone.mp3  
+incallmanager_ringback.mp3  
+incallmanager_ringback.mp3  
+```
+
+on android, as long as your file extension supported by android, this module will load it.
+
+
 ===================================================
 
 ####ios:
@@ -41,6 +59,21 @@ before that, you should add this project manually:
   1. click your `project's xcodeproject root`, go to `build setting` and search `Objective-C Bridging Header`
   2. set you header location, the default path is: `ReactNativeProjectRoot/ios/`, in this case, you should set `../node_modules/react-native-incall-manager/ios/RNInCallManager/RNInCallManager-Bridging-Header.h`
 
+**optional sound files on android**
+if you want to use bundled ringtone/ringback/busytone sound instead of system sound 
+
+1. add files into your_project directory under your project's xcodeproject root. ( or drag into it as described above. )
+2. check `copy file if needed`
+3. make sure filename correspond to sound type:
+
+```
+incallmanager_busytone.mp3
+incallmanager_ringback.mp3  
+incallmanager_ringback.mp3  
+```
+
+on ios, we only support mp3 files currently.
+
 ## Usage:
 
 This module implement a basic handle logic automatically, just:
@@ -59,8 +92,44 @@ InCallManager.stop();
 // ... it will also remote event listeners ...
 ```
 
+if you want to use ringback:
+
+```javascript
+// ringback is basically for OUTGOING call. and is part of start().
+
+InCallManager.start({media: 'audio', ringback: '_BUNDLE_'}); // or _DEFAULT_ or _DTMF_
+//when callee answered, you MUST stop ringback explicitly:
+InCallManager.stopRingback();
+```
+
+if you want to use busytone:
+
+```javascript
+// busytone is basically for OUTGOING call. and is part of stop()
+// If the call failed or callee are busing,
+// you may want to stop the call and play busytone
+InCallManager.stop({busytone: '_DTMF_'}); // or _BUNDLE_ or _DEFAULT_
+```
+
+if you want to use ringtone:
+
+```javascript
+// ringtone is basically for INCOMING call. it's independent to start() and stop()
+// if you receiving an incoming call, before user pick up,
+// you may want to play ringtone to notify user.
+InCallManager.startRingtone('_BUNDLE_'); // or _DEFAULT_ or system filename with extension
+
+// when user pickup
+InCallManager.stopRingtone();
+InCallManager.start();
+
+// or user hangup
+InCallManager.stopRingtone();
+InCallManager.stop();
+
+```
 
-and interact with events if you want:
+also can interact with events if you want:
 see API section.
 
 ```javascript
@@ -80,10 +149,12 @@ DeviceEventEmitter.addListener('Proximity', function (data) {
 * audio will enable proximity sensor which is disabled by default if media=video
 * when proximity detect user closed to screen, turn off screen to avoid accident touch and route voice to earpiece.
 * when newly external device plugged, such as wired-headset, route audio to external device.
+* optional play ringback
 
 **on stop:**  
 
 * set KeepScreenOn flag = false, remote event listeners, restore original user settings.
+* optional play busytone
 
 ## Custom Behavior:  
 
@@ -97,13 +168,13 @@ note: ios only supports `auto` currently.
 
 |  Method      |  android |   ios   |  description |
 |  :---  |   :---:  |  :---:  |     :---    |
-| start(`{media: ?string, auto: ?boolean}`)   | :smile: | :smile: | start incall manager.</br>default: `{media:'audio', auto: true}`  |
-| stop()   | :smile: | :smile: | stop incall manager |
+| start(`{media: ?string, auto: ?boolean, ringback: ?string}`)   | :smile: | :smile: | start incall manager.</br> ringback accept non-empty string or it won't play</br>default: `{media:'audio', auto: true, ringback: ''}`  |
+| stop(`{busytone: ?string}`)   | :smile: | :smile: | stop incall manager</br> busytone accept non-empty string or it won't play</br> default: `{busytone: ''}` |
 | turnScreenOn()   | :smile: | :rage: | force turn screen on |
 | turnScreenOff()   | :smile: | :rage: | force turn screen off |
 | setKeepScreenOn(`enable: ?boolean`)   | :smile: | :smile: | set KeepScreenOn flag = true or false</br>default: false |
 | setSpeakerphoneOn(`enable: ?boolean`)   | :smile: | :rage: | toggle speaker ON/OFF once. but not force</br>default: false |
-| setForceSpeakerphoneOn(`enable: ?boolean`)   | :smile: | :smile: | if set to true, will ignore all logic and force audio route to speaker</br>default: false  |
+| setForceSpeakerphoneOn(`flag: ?boolean`)   | :smile: | :smile: | true -> force speaker on</br> false -> force speaker off</br> null -> use default behavior according to media type</br>default: null |
 | setMicrophoneMute(`enable: ?boolean`)   | :smile: | :rage: | mute/unmute micophone</br>default: false |
 
 **Events**