Changes between Version 105 and Version 106 of FAQ

Timestamp:

Dec 3, 2010 6:55:38 AM (14 years ago)

Author:

bennylp

Comment:

--

FAQ

@@ -531 +531 @@
 === How can I support new audio device that is plugged-in after the application is running?  === #snd-hot-plug
 
-PJSIP currently does not detect new audio devices that are plugged-in after the library has been initialized. The sound device list simply will not update itself.
-
-To support these new audio devices, you'd need to do the following.
+PJSIP currently does not support hot-plugging of audio devices while the application is running. Hot-plugging can be supported in the application though. To support this, the app would need to capture the hot-plug event and reinitialize the audio subsytem once the event is detected.
 
 First you need to detect that new sound device has been inserted into the system. The methods vary, and it is outside the scope of PJSIP (for now). For Windows XP for example, you can follow the generic hardware detection procedure in http://www.codeproject.com/KB/system/HwDetect.aspx, replacing the device interface class ID with audio device interface below (you can use any of it): 
@@ -542 +540 @@
 }}}
 
-The next task is to update the sound device list in pjmedia. As we currently do not have an API to do this, what we can do is to shutdown and reinitialize the audio subsystem (pjmedia_aud_subsys_shutdown() and pjmedia_aud_subsys_init()) to make the backends update their device list. But you should only do this when the sound device is not being used. You can check this by using {{{pjsua_snd_is_active()}}} API. Though having said that, I briefly checked our native WMME implementation to see if opened streams are affected if the audio subsystem is shutdown, and it doesn't appear to be so. But the general behavior is undefined. 
-
-Alternatively, you can manage the sound device yourself, using {{{pjsua_set_no_snd_dev()}}} facility. Using this approach, you can even change the sound device on the fly even when the media is active! Just disconnect the sound device from the bridge's port, reinitialize audio subsystem, open the new sound device, reconnect to the bridge, and voila! The newly inserted sound device is active.
-
-As yet another alternative, and this is probably the best alternative, you can let PJSIP manage the sound device (the default behavior) so that it's automatically opened/closed on demand, and call {{{pjsua_set_no_snd_dev()}}} only when you're about to reinitialize the audio subsystem, to forcefully close the currently opened sound device (if any). Once the reinitialization is complete, you can tell PJSIP to manage the sound device again with {{{pjsua_set_snd_dev()}}}. 
+The next task is to update the sound device list in pjmedia. As we currently do not have an API to do this, what we can do is to shutdown and reinitialize the audio subsystem (pjmedia_aud_subsys_shutdown() and pjmedia_aud_subsys_init()) to make the backends update their device list. But you should only do this when the sound device is not being used. One way to do this is to call {{{pjsua_set_no_snd_dev()}}} to forcefully close the currently opened sound device (if any). Once the reinitialization is complete, you can tell PJSIP to manage the sound device again by calling {{{pjsua_set_snd_dev()}}}. 
 
 ----