Warning, /libraries/phonon/doc/DESIGN/HowToConfigureDevices.txt is written in an unsupported language. File is not indexed.
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