doc/DESIGN/HowToConfigureDevices.txt

0001 With Phonon the audio/video capture/output devices will be handled completely
0002 transparent for the applications:
0003
0004 Applications can get a listing of available devices, show that to the user and
0005 use the selected device on either AvCapture, VideoOutput or AudioOutput. On the
0006 other hand the applications should use "the right defaults", so a central KCM
0007 defines the defaults:
0008
0009 For every category a list of preference is created for devices. Devices that are
0010 not available anymore (external USB headset that got unplugged) are still
0011 displayed (with the name and description saved from the last time it was
0012 announced by the backend) but marked as "currently not available" with an option
0013 to remove the device permanently.
0014
0015 Use cases:
0016 A)
0017 - plug new audio device (headset)
0018 - dialog asking the user whether he wants to configure KDE to use the new device
0019 yes -> show audio device selection dialog
0020 - user changes the device preference for the Communication category to prefer
0021   the new headset
0022 - Kopete now uses the headset for voice-chat
0023
0024 B)
0025 - headset got broken
0026 - user looks at audio device selection dialog
0027 - headset is shown as not connected
0028 - user selects to remove the device
0029
0030 C)
0031 - plug new webcam
0032 - dialog asking the user whether he wants to configure KDE to use the new device
0033 yes -> show video device selection dialog
0034 - user changes the device preference for the Communication category to prefer
0035   the new webcam
0036 - Kopete now uses the webcam for voice-chat