lovr.audio.setDevice
EditSwitches either the playback or capture device to a new one.
If a device for the given type is already active, it will be stopped and destroyed. The new device will not be started automatically, use lovr.audio.start to start it.
A device id (previously retrieved using lovr.audio.getDevices) can be given to use a specific audio device, or nil can be used for the id to use the default audio device.
A sink can be also be provided when changing the device. A sink is an audio stream (Sound object with a stream type) that will receive all audio samples played (for playback) or all audio samples captured (for capture). When an audio device with a sink is started, be sure to periodically call Sound:read on the sink to read audio samples from it, otherwise it will overflow and discard old data. The sink can have any format, data will be converted as needed. Using a sink for the playback device will reduce performance, but this isn't the case for capture devices.
Audio devices can be started in shared or exclusive mode. Exclusive devices may have lower latency than shared devices, but there's a higher chance that requesting exclusive access to an audio device will fail (either because it isn't supported or allowed). One strategy is to first try the device in exclusive mode, switching to shared if it doesn't work.
success = lovr.audio.setDevice(type, id, stream, mode)Arguments
| Name | Type | Default | Description |
| type | AudioType | 'playback' | The device to switch. |
| id | userdata | nil |
The id of the device to use, or nil to use the default device.
|
| stream | AudioStream | boolean | nil |
An optional audio stream to use as a "sink" for the device. For playback devices, any audio sent to the speakers is also copied to the sink. For capture devices, audio captured by the device is copied to the sink. Can be a specific AudioStream, or true to create a default audio stream matching the native format of the device. If nil, this will be true for capture devices and false for playback devices. Use lovr.audio.getStream to get the stream after the device is created.
|
| mode | AudioShareMode | shared | The sharing mode for the device. |
Returns
| Name | Type | Description |
| success | boolean | Whether creating the audio device succeeded. |