Skip to main content

Device settings

The SDK's default implementation of device settings components consists of audio and video device selectors. These are:

  • DeviceSelectorVideo
  • DeviceSelectorAudioInput
  • DeviceSelectorAudioOutput

There is also a composing component DeviceSettings putting these together.

Default device settings panel
Default device settings panel
Default camera device selector
Default camera device selector
Default audio input device selector
Default audio input device selector
Default audio output device selector
Default audio output device selector

General usage

import { Call, DeviceSettings, StreamCall } from '@stream-io/video-react-sdk';

const MyDevicePanel = () => {
let call: Call;

return (
<StreamCall call={call}>
<DeviceSettings />
</StreamCall>
);
};

Or use the components individually:

import {
Call,
DeviceSelectorAudioInput,
DeviceSelectorVideo,
StreamCall,
} from '@stream-io/video-react-sdk';

const MyDevicePanel = () => {
let call: Call;

return (
<StreamCall call={call}>
<DeviceSelectorVideo />
<DeviceSelectorAudioInput />
</StreamCall>
);
};

Props

DeviceSettings

NameDescriptionTypeDefault
visualTypeVisually display a list or dropdown selectorlist | dropdown | undefinedlist

DeviceSelectorVideo

NameDescriptionTypeDefault
titleTitle is displayed at the top of the selector componentstring | undefinedSelect a Camera
visualTypeVisually display a list or dropdown selectorlist | dropdown | undefinedlist

DeviceSelectorAudioInput

NameDescriptionTypeDefault
titleTitle is displayed at the top of the selector componentstring | undefinedSelect a Mic
visualTypeVisually display a list or dropdown selectorlist | dropdown | undefinedlist

DeviceSelectorAudioOutput

NameDescriptionTypeDefault
titleTitle is displayed at the top of the selector componentstring | undefinedSelect a Speaker
visualTypeVisually display a list or dropdown selectorlist | dropdown | undefinedlist

Customization

If you want to create your own component, you can make use of Devices Management API to list and select devices.

Did you find this page helpful?