addAdditionalDevice

addAdditionalDevice(options): Promise<void>

Adds an additional media input device to the call, as a second capture alongside the main connection. The call itself is unaffected when acquisition fails.

Parameters

Returns

Promise<void>

Throws

• AuxiliaryLegCancelledError — removeAdditionalDevice removed the device before its leg finished connecting.
• AuxiliaryLegTimeoutError — the leg did not connect within its budget.
• The raw getUserMedia error (e.g. a NotAllowedError DOMException on permission denial) — inspect error.name to decide how to react.

Examples

await selfParticipant.addAdditionalDevice(options);