====== adv.setAudioDestination() ======
call.adv.setAudioDestination() changes which local audio destination (speaker) this call should use.

By default the audio destination is picked by the browser. While most of the times browsers do succeed in picking the right audio destination sometimes they select another one than the user prefers. On devices with multiple audio destinations you can select which one to use for this call by calling call.adv.setAudioDestination() with the [[ixnx:wrtc:js:api:sources_array|desired destination's unique ID]] as argument.

On Chrome you can get a list of available audio destinations using [[ixnx:wrtc:js:api:wrtc:get|wrtc.get("audioDestinations")]].

The difference between [[ixnx:wrtc:js:api:wrtc:setaudiodestination|wrtc.setAudioDestination()]] and call.adv.setAudioDestination() is that while [[ixnx:wrtc:js:api:wrtc:setaudiodestination|wrtc.setAudioDestination()]] affects //all// current and future calls call.adv.setAudioDestination() affects only this particular call.

Most of the time you should use [[ixnx:wrtc:js:api:wrtc:setaudiodestination|wrtc.setAudioDestination()]] except in very special scenarios there different calls should send their audio output to different speakers.

===== Arguments =====
call.adv.setAudioDestination(destinationID)
  * destinationID - (optional) string containing the unique destination ID of the audio output device (speaker) you want to use for this call, or special values:
    * "default" - system's default audio output device
    * "communications" - system's default audio output device for communications

If no destinationID is supplied [[ixnx:wrtc:js:api:wrtc:audiodestination|wrtc.audioDestination]] will be used.

If no destinationID and [[ixnx:wrtc:js:api:wrtc:audiodestination|wrtc.audioDestination]] is undefined call.adv.setAudioDestination() does nothing (fails silently).

===== Returns =====
Nothing.

===== Example =====
  call.adv.setAudioDestination("communications")

===== See also =====
[[ixnx:wrtc:js:api:wrtc:setaudiodestination|wrtc.setAudioDestination()]]

[[ixnx:wrtc:js:api:wrtc:audiodestination|wrtc.audioDestination]]

[[ixnx:wrtc:js:api:wrtc:get|wrtc.get("audioDestinations")]]

[[ixnx:wrtc:js:api:sources_array|audio destinations]]