Use device ringtone for incoming call sound

[liviu-timar]

🎯 Goal

Refactor sound configuration. Add possibility to use device ringtone for incoming call sound.

🛠 Implementation details

• Added SoundConfig interface to be used in Sounds constructor.
• Deprecated current Sounds constructor.
• Added several static factory methods in SoundConfig: createDeviceRingtoneSoundConfig, createStreamResourcesSoundConfig, createEmptySoundConfig.
• Added a factory method for custom configs, createCustomSoundConfig.
  • Allows user to specify custom sounds for incoming and outgoing calls. The sounds can be either resource IDs or URIs.
• Using the device ringtone as default.
• Moved Sounds section from UI Cookbook/Incoming & Outgoing to Advanced/Ringing and updated it. Kept link in the original page. See here.

🧪 Testing

Cases:

• Default Sounds in Builder: outgoing - default tone provided by SDK, incoming - device ringtone.
• Use deprecated Sounds constructor: marked as deprecated & using passed sounds.
• Pass custom sound res to Sounds property: the custom sound will be used.
• Pass null to Sounds property: that sound will be disabled (muted).
• Device ringtone evaluates to null: fallback to default SDK incoming sound.
• Device uses external storage ringtone and app doesn't have READ_EXTERNAL_STORAGE permission: RingtoneManager.getActualDefaultRingtoneUri() will evaluate to null, fallback as above.

🎉 GIF