@stream-io/video-react-sdk 0.0.1-alpha.100

package/dist/src/core/contexts/MediaDevicesContext.d.ts

@@ -0,0 +1,180 @@
+import { PropsWithChildren } from 'react';
+import { getAudioStream, getVideoStream } from '@stream-io/video-client';
+type EnabledStateType = 'starting' | 'playing';
+type DisabledStateType = 'uninitialized' | 'stopped';
+type EnabledDeviceState<T extends EnabledStateType> = {
+    type: T;
+    enabled: true;
+};
+type DisabledDeviceState<T extends DisabledStateType> = {
+    type: T;
+    enabled: false;
+};
+type ErrorDeviceState = {
+    type: 'error';
+    message: string;
+    enabled: false;
+};
+type DeviceState = EnabledDeviceState<EnabledStateType> | DisabledDeviceState<DisabledStateType> | ErrorDeviceState;
+/**
+ * Exclude types from documentation site, but we should still add doc comments
+ * @internal
+ */
+export declare const DEVICE_STATE: {
+    starting: EnabledDeviceState<'starting'>;
+    playing: EnabledDeviceState<'playing'>;
+    stopped: DisabledDeviceState<'stopped'>;
+    uninitialized: DisabledDeviceState<'uninitialized'>;
+    error: ErrorDeviceState;
+};
+/**
+ * API to control device enablement, device selection and media stream access for a call.
+ * @category Device Management
+ */
+export type MediaDevicesContextAPI = {
+    /**
+     * Deactivates MediaStream (stops and removes tracks) to be later garbage collected
+     *
+     * @param stream MediaStream
+     * @returns void
+     */
+    disposeOfMediaStream: (stream: MediaStream) => void;
+    /**
+     * Returns an 'audioinput' media stream with the given `deviceId`, if no `deviceId` is provided, it uses the first available device.
+     *
+     * @param deviceId
+     * @returns
+     */
+    getAudioStream: typeof getAudioStream;
+    /**
+     * Returns a 'videoinput' media stream with the given `deviceId`, if no `deviceId` is provided, it uses the first available device.
+     *
+     * @param deviceId
+     * @returns
+     */
+    getVideoStream: typeof getVideoStream;
+    /**
+     * [Tells if the browser supports audio output change on 'audio' elements](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/setSinkId).
+     */
+    isAudioOutputChangeSupported: boolean;
+    /**
+     * Signals whether audio stream will be published when the call is joined.
+     */
+    initialAudioEnabled: boolean;
+    /**
+     * Signals whether audio stream will be published when the call is joined.
+     */
+    initialVideoState: DeviceState;
+    /**
+     * Publishes audio stream for currently selected audio input (microphone) device to other call participants.
+     */
+    publishAudioStream: () => Promise<void>;
+    /**
+     * Publishes video stream for currently selected video input (camera) device to other call participants.
+     */
+    publishVideoStream: () => Promise<void>;
+    /**
+     * Stops publishing audio stream for currently selected audio input (microphone) device to other call participants.
+     */
+    stopPublishingAudio: () => void;
+    /**
+     * Stops publishing video stream for currently selected video input (camera) device to other call participants.
+     */
+    stopPublishingVideo: () => void;
+    /**
+     * Sets the initialAudioEnabled flag to a given boolean value.
+     * The latest value set will be used to decide, whether audio stream will be published when joining a call.
+     * @param enabled
+     */
+    setInitialAudioEnabled: (enabled: boolean) => void;
+    /**
+     * Sets the initialVideoState to a given DeviceState value.
+     * The latest value set will be used to decide, whether video stream will be published when joining a call.
+     * @param enabled
+     */
+    setInitialVideoState: (state: DeviceState) => void;
+    /**
+     * Stores audio input device (microphone) id which is used to publish user's sound to other call participants.
+     */
+    selectedAudioInputDeviceId?: string;
+    /**
+     * Stores audio output device (speaker) id used to reproduce incoming audio from other call participants.
+     */
+    selectedAudioOutputDeviceId?: string;
+    /**
+     * Stores video input device (camera) id which is used to publish user's video to other call participants.
+     */
+    selectedVideoDeviceId?: string;
+    /**
+     * Function should be used to change selected device id.
+     * The change is later reflected in selectedAudioInputDeviceId, selectedAudioOutputDeviceId or selectedVideoDeviceId depending on kind parameter.
+     * @param kind
+     * @param deviceId
+     */
+    switchDevice: (kind: MediaDeviceKind, deviceId?: string) => void;
+    /**
+     * Sets the initialAudioEnabled flag by negating the current state value.
+     * The latest value set will be used to decide, whether audio stream will be published when joining a call.
+     * @param enabled
+     */
+    toggleInitialAudioMuteState: () => void;
+    /**
+     * Sets the initialVideoState by toggling  the current state DeviceState value.
+     * The latest value set will be used to decide, whether video stream will be published when joining a call.
+     * @param enabled
+     */
+    toggleInitialVideoMuteState: () => void;
+};
+/**
+ * Configuration parameters for MediaDevicesProvider.
+ * @category Device Management
+ */
+export type MediaDevicesProviderProps = {
+    /**
+     * Provides external control over the initial audio input (microphone) enablement. Overrides the default false.
+     */
+    initialAudioEnabled?: boolean;
+    /**
+     * Provides external control over the initial video input (camera) enablement. Overrides the default false.
+     */
+    initialVideoEnabled?: boolean;
+    /**
+     * Allows to override the default audio input (microphone) stream to be published. Overrides the default string 'default'.
+     */
+    initialAudioInputDeviceId?: string;
+    /**
+     * Allows to override the default audio output (speaker) device to reproduce incoming audio from the SFU. Overrides the default string 'default'.
+     */
+    initialAudioOutputDeviceId?: string;
+    /**
+     * Allows to override the default video input (camera) stream to be published. Overrides the default string 'default'.
+     */
+    initialVideoInputDeviceId?: string;
+};
+/**
+ * Context provider that internally puts in place mechanisms that:
+ * 1. fall back to selecting a default device when trying to switch to a non-existent device
+ * 2. fall back to a default device when an active device is disconnected
+ * 3. stop publishing a media stream when a non-default device is disconnected
+ * 4. republish a media stream from the newly connected default device
+ * 5. republish a media stream when a new device is selected
+ *
+ * Provides `MediaDevicesContextAPI` that allow the integrators to handle:
+ * 1. the initial device state enablement (for example apt for lobby scenario)
+ * 2. media stream retrieval and disposal
+ * 3. media stream publishing
+ * 4. specific device selection
+ * @param params
+ * @returns
+ *
+ * @category Device Management
+ */
+export declare const MediaDevicesProvider: ({ children, initialAudioEnabled, initialVideoEnabled, initialVideoInputDeviceId, initialAudioOutputDeviceId, initialAudioInputDeviceId, }: PropsWithChildren<MediaDevicesProviderProps>) => JSX.Element;
+/**
+ * Context consumer retrieving MediaDevicesContextAPI.
+ * @returns
+ *
+ * @category Device Management
+ */
+export declare const useMediaDevices: () => MediaDevicesContextAPI;
+export {};

package/dist/src/core/contexts/MediaDevicesContext.js

@@ -0,0 +1,177 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useState, } from 'react';
+import { map } from 'rxjs';
+import { CallingState, checkIfAudioOutputChangeSupported, disposeOfMediaStream, getAudioStream, getVideoStream, SfuModels, watchForDisconnectedAudioOutputDevice, } from '@stream-io/video-client';
+import { useCall, useCallCallingState, useCallMetadata, useCallState, } from '@stream-io/video-react-bindings';
+import { useAudioInputDeviceFallback, useAudioOutputDeviceFallback, useAudioPublisher, useVideoDeviceFallback, useVideoPublisher, } from '../hooks';
+const DEVICE_STATE_TOGGLE = {
+    starting: 'stopped',
+    playing: 'stopped',
+    stopped: 'starting',
+    uninitialized: 'starting',
+    error: 'starting',
+};
+/**
+ * Exclude types from documentation site, but we should still add doc comments
+ * @internal
+ */
+export const DEVICE_STATE = {
+    starting: { type: 'starting', enabled: true },
+    playing: { type: 'playing', enabled: true },
+    stopped: { type: 'stopped', enabled: false },
+    uninitialized: { type: 'uninitialized', enabled: false },
+    error: { type: 'error', message: '', enabled: false },
+};
+const DEFAULT_DEVICE_ID = 'default';
+const MediaDevicesContext = createContext(null);
+/**
+ * Context provider that internally puts in place mechanisms that:
+ * 1. fall back to selecting a default device when trying to switch to a non-existent device
+ * 2. fall back to a default device when an active device is disconnected
+ * 3. stop publishing a media stream when a non-default device is disconnected
+ * 4. republish a media stream from the newly connected default device
+ * 5. republish a media stream when a new device is selected
+ *
+ * Provides `MediaDevicesContextAPI` that allow the integrators to handle:
+ * 1. the initial device state enablement (for example apt for lobby scenario)
+ * 2. media stream retrieval and disposal
+ * 3. media stream publishing
+ * 4. specific device selection
+ * @param params
+ * @returns
+ *
+ * @category Device Management
+ */
+export const MediaDevicesProvider = ({ children, initialAudioEnabled, initialVideoEnabled, initialVideoInputDeviceId = DEFAULT_DEVICE_ID, initialAudioOutputDeviceId = DEFAULT_DEVICE_ID, initialAudioInputDeviceId = DEFAULT_DEVICE_ID, }) => {
+    const call = useCall();
+    const callingState = useCallCallingState();
+    const callState = useCallState();
+    const metadata = useCallMetadata();
+    const { localParticipant$ } = callState;
+    const [selectedAudioInputDeviceId, selectAudioInputDeviceId] = useState(initialAudioInputDeviceId);
+    const [selectedAudioOutputDeviceId, selectAudioOutputDeviceId] = useState(initialAudioOutputDeviceId);
+    const [selectedVideoDeviceId, selectVideoDeviceId] = useState(initialVideoInputDeviceId);
+    const [isAudioOutputChangeSupported] = useState(() => checkIfAudioOutputChangeSupported());
+    const [initAudioEnabled, setInitialAudioEnabled] = useState(!!initialAudioEnabled);
+    const [initialVideoState, setInitialVideoState] = useState(() => initialVideoEnabled ? DEVICE_STATE.starting : DEVICE_STATE.uninitialized);
+    const settings = metadata === null || metadata === void 0 ? void 0 : metadata.settings;
+    useEffect(() => {
+        if (!settings ||
+            ![CallingState.IDLE, CallingState.RINGING].includes(callingState)) {
+            return;
+        }
+        const { audio, video } = settings;
+        if (typeof initialAudioEnabled === 'undefined' && audio.mic_default_on) {
+            setInitialAudioEnabled(audio.mic_default_on);
+        }
+        if (typeof initialVideoEnabled === 'undefined' && video.camera_default_on) {
+            setInitialVideoState(DEVICE_STATE.starting);
+        }
+    }, [callingState, initialAudioEnabled, initialVideoEnabled, settings]);
+    const publishVideoStream = useVideoPublisher({
+        initialVideoMuted: !initialVideoState.enabled,
+        videoDeviceId: selectedVideoDeviceId,
+    });
+    const publishAudioStream = useAudioPublisher({
+        initialAudioMuted: !initAudioEnabled,
+        audioDeviceId: selectedAudioInputDeviceId,
+    });
+    const stopPublishingAudio = useCallback(() => {
+        if (callingState === CallingState.IDLE ||
+            callingState === CallingState.RINGING) {
+            setInitialAudioEnabled(false);
+        }
+        else {
+            call === null || call === void 0 ? void 0 : call.stopPublish(SfuModels.TrackType.AUDIO);
+        }
+    }, [call, callingState]);
+    const stopPublishingVideo = useCallback(() => {
+        if (callingState === CallingState.IDLE ||
+            callingState === CallingState.RINGING) {
+            setInitialVideoState(DEVICE_STATE.stopped);
+        }
+        else {
+            call === null || call === void 0 ? void 0 : call.stopPublish(SfuModels.TrackType.VIDEO);
+        }
+    }, [call, callingState]);
+    const toggleInitialAudioMuteState = useCallback(() => setInitialAudioEnabled((prev) => {
+        return !prev;
+    }), []);
+    const toggleInitialVideoMuteState = useCallback(() => setInitialVideoState((prev) => {
+        const newType = DEVICE_STATE_TOGGLE[prev.type];
+        return DEVICE_STATE[newType];
+    }), []);
+    const switchDevice = useCallback((kind, deviceId) => {
+        if (kind === 'videoinput') {
+            selectVideoDeviceId(deviceId);
+        }
+        if (kind === 'audioinput') {
+            selectAudioInputDeviceId(deviceId);
+        }
+        if (kind === 'audiooutput') {
+            selectAudioOutputDeviceId(deviceId);
+        }
+    }, []);
+    useAudioInputDeviceFallback(() => switchDevice('audioinput', DEFAULT_DEVICE_ID), selectedAudioInputDeviceId);
+    useAudioOutputDeviceFallback(() => switchDevice('audiooutput', DEFAULT_DEVICE_ID), selectedAudioOutputDeviceId);
+    useVideoDeviceFallback(() => switchDevice('videoinput', DEFAULT_DEVICE_ID), selectedVideoDeviceId);
+    useEffect(() => {
+        if (!call || callingState !== CallingState.JOINED)
+            return;
+        call.setAudioOutputDevice(selectedAudioOutputDeviceId);
+    }, [call, callingState, selectedAudioOutputDeviceId]);
+    useEffect(() => {
+        if (!localParticipant$)
+            return;
+        const subscription = watchForDisconnectedAudioOutputDevice(localParticipant$.pipe(map((p) => p === null || p === void 0 ? void 0 : p.audioOutputDeviceId))).subscribe(() => __awaiter(void 0, void 0, void 0, function* () {
+            selectAudioOutputDeviceId(DEFAULT_DEVICE_ID);
+        }));
+        return () => {
+            subscription.unsubscribe();
+        };
+    }, [localParticipant$]);
+    const contextValue = {
+        disposeOfMediaStream,
+        getAudioStream,
+        getVideoStream,
+        isAudioOutputChangeSupported,
+        selectedAudioInputDeviceId,
+        selectedAudioOutputDeviceId,
+        selectedVideoDeviceId,
+        switchDevice,
+        initialAudioEnabled: initAudioEnabled,
+        initialVideoState,
+        setInitialAudioEnabled,
+        setInitialVideoState,
+        toggleInitialAudioMuteState,
+        toggleInitialVideoMuteState,
+        publishAudioStream,
+        publishVideoStream,
+        stopPublishingAudio,
+        stopPublishingVideo,
+    };
+    return (_jsx(MediaDevicesContext.Provider, Object.assign({ value: contextValue }, { children: children })));
+};
+/**
+ * Context consumer retrieving MediaDevicesContextAPI.
+ * @returns
+ *
+ * @category Device Management
+ */
+export const useMediaDevices = () => {
+    const value = useContext(MediaDevicesContext);
+    if (!value) {
+        console.warn(`Null MediaDevicesContext`);
+    }
+    return value;
+};
+//# sourceMappingURL=MediaDevicesContext.js.map

package/dist/src/core/contexts/MediaDevicesContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaDevicesContext.js","sourceRoot":"","sources":["../../../../src/core/contexts/MediaDevicesContext.tsx"],"names":[],"mappings":"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"}

package/dist/src/core/contexts/index.d.ts

@@ -0,0 +1 @@
+export * from './MediaDevicesContext';

package/dist/src/core/contexts/index.js

@@ -0,0 +1,2 @@
+export * from './MediaDevicesContext';
+//# sourceMappingURL=index.js.map

package/dist/src/core/contexts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/contexts/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/src/core/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export * from './useAudioPublisher';
+export * from './useDevices';
+export * from './useVideoPublisher';
+export * from './useTrackElementVisibility';

package/dist/src/core/hooks/index.js

@@ -0,0 +1,5 @@
+export * from './useAudioPublisher';
+export * from './useDevices';
+export * from './useVideoPublisher';
+export * from './useTrackElementVisibility';
+//# sourceMappingURL=index.js.map

package/dist/src/core/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC"}

package/dist/src/core/hooks/useAudioPublisher.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @internal
+ */
+export type AudioPublisherInit = {
+    initialAudioMuted?: boolean;
+    audioDeviceId?: string;
+};
+/**
+ * @internal
+ * @category Device Management
+ */
+export declare const useAudioPublisher: ({ initialAudioMuted, audioDeviceId, }: AudioPublisherInit) => () => Promise<void>;

package/dist/src/core/hooks/useAudioPublisher.js

@@ -0,0 +1,95 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { useCallback, useEffect } from 'react';
+import { map } from 'rxjs';
+import { CallingState, getAudioStream, OwnCapability, SfuModels, watchForAddedDefaultAudioDevice, watchForDisconnectedAudioDevice, } from '@stream-io/video-client';
+import { useCall, useCallCallingState, useCallState, useLocalParticipant, } from '@stream-io/video-react-bindings';
+/**
+ * @internal
+ * @category Device Management
+ */
+export const useAudioPublisher = ({ initialAudioMuted, audioDeviceId, }) => {
+    const call = useCall();
+    const callState = useCallState();
+    const callingState = useCallCallingState();
+    const participant = useLocalParticipant();
+    const { localParticipant$ } = callState;
+    const isPublishingAudio = participant === null || participant === void 0 ? void 0 : participant.publishedTracks.includes(SfuModels.TrackType.AUDIO);
+    const publishAudioStream = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
+        if (!call)
+            return;
+        if (!call.permissionsContext.hasPermission(OwnCapability.SEND_AUDIO)) {
+            throw new Error(`No permission to publish audio`);
+        }
+        try {
+            const audioStream = yield getAudioStream({
+                deviceId: audioDeviceId,
+            });
+            yield call.publishAudioStream(audioStream);
+        }
+        catch (e) {
+            console.log('Failed to publish audio stream', e);
+        }
+    }), [audioDeviceId, call]);
+    useEffect(() => {
+        if (callingState === CallingState.JOINED && !initialAudioMuted) {
+            publishAudioStream().catch((e) => {
+                console.error('Failed to publish audio stream', e);
+            });
+        }
+    }, [callingState, initialAudioMuted, publishAudioStream]);
+    useEffect(() => {
+        if (!localParticipant$)
+            return;
+        const subscription = watchForDisconnectedAudioDevice(localParticipant$.pipe(map((p) => p === null || p === void 0 ? void 0 : p.audioDeviceId))).subscribe(() => __awaiter(void 0, void 0, void 0, function* () {
+            if (!call)
+                return;
+            call.setAudioDevice(undefined);
+            yield call.stopPublish(SfuModels.TrackType.AUDIO);
+        }));
+        return () => {
+            subscription.unsubscribe();
+        };
+    }, [localParticipant$, call]);
+    useEffect(() => {
+        if (!(participant === null || participant === void 0 ? void 0 : participant.audioStream) || !call || !isPublishingAudio)
+            return;
+        const [track] = participant.audioStream.getAudioTracks();
+        const selectedAudioDeviceId = track.getSettings().deviceId;
+        const republishDefaultDevice = watchForAddedDefaultAudioDevice().subscribe(() => __awaiter(void 0, void 0, void 0, function* () {
+            if (!(call &&
+                participant.audioStream &&
+                selectedAudioDeviceId === 'default'))
+                return;
+            // We need to stop the original track first in order
+            // we can retrieve the new default device stream
+            track.stop();
+            const audioStream = yield getAudioStream({
+                deviceId: 'default',
+            });
+            yield call.publishAudioStream(audioStream);
+        }));
+        const handleTrackEnded = () => __awaiter(void 0, void 0, void 0, function* () {
+            if (selectedAudioDeviceId === audioDeviceId) {
+                const audioStream = yield getAudioStream({
+                    deviceId: audioDeviceId,
+                });
+                yield call.publishAudioStream(audioStream);
+            }
+        });
+        track.addEventListener('ended', handleTrackEnded);
+        return () => {
+            track.removeEventListener('ended', handleTrackEnded);
+            republishDefaultDevice.unsubscribe();
+        };
+    }, [audioDeviceId, call, participant === null || participant === void 0 ? void 0 : participant.audioStream, isPublishingAudio]);
+    return publishAudioStream;
+};
+//# sourceMappingURL=useAudioPublisher.js.map

package/dist/src/core/hooks/useAudioPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAudioPublisher.js","sourceRoot":"","sources":["../../../../src/core/hooks/useAudioPublisher.ts"],"names":[],"mappings":"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"}

package/dist/src/core/hooks/useDevices.d.ts

@@ -0,0 +1,80 @@
+import { Observable } from 'rxjs';
+/**
+ * Observes changes in connected devices and maintains an up-to-date array of connected MediaDeviceInfo objects.
+ * @param observeDevices
+ * @category Device Management
+ */
+export declare const useDevices: (observeDevices: () => Observable<MediaDeviceInfo[]>) => MediaDeviceInfo[];
+/**
+ * Observes changes and maintains an array of connected video input devices
+ * @category Device Management
+ */
+export declare const useVideoDevices: () => MediaDeviceInfo[];
+/**
+ * Observes changes and maintains an array of connected audio input devices
+ * @category Device Management
+ */
+export declare const useAudioInputDevices: () => MediaDeviceInfo[];
+/**
+ * Observes changes and maintains an array of connected audio output devices
+ * @category Device Management
+ */
+export declare const useAudioOutputDevices: () => MediaDeviceInfo[];
+/**
+ * Verifies that newly selected device id exists among the registered devices.
+ * If the selected device id is not found among existing devices, switches to the default device.
+ * @param devices$
+ * @param switchToDefaultDevice
+ * @param selectedDeviceId
+ * @category Device Management
+ */
+export declare const useDeviceFallback: (devices$: Observable<MediaDeviceInfo[]>, switchToDefaultDevice: () => void, selectedDeviceId?: string) => void;
+/**
+ * Verifies that newly selected video device id exists among the registered devices.
+ * If the selected device id is not found among existing devices, switches to the default video device.
+ * @param switchToDefaultDevice
+ * @param selectedDeviceId
+ * @category Device Management
+ */
+export declare const useVideoDeviceFallback: (switchToDefaultDevice: () => void, selectedDeviceId?: string) => void;
+/**
+ * Verifies that newly selected audio input device id exists among the registered devices.
+ * If the selected device id is not found among existing devices, switches to the default audio input device.
+ * @param switchToDefaultDevice
+ * @param selectedDeviceId
+ * @category Device Management
+ */
+export declare const useAudioInputDeviceFallback: (switchToDefaultDevice: () => void, selectedDeviceId?: string) => void;
+/**
+ * Verifies that newly selected audio output device id exists among the registered devices.
+ * If the selected device id is not found among existing devices, switches to the default audio output device.
+ * @param switchToDefaultDevice
+ * @param selectedDeviceId
+ * @category Device Management
+ */
+export declare const useAudioOutputDeviceFallback: (switchToDefaultDevice: () => void, selectedDeviceId?: string) => void;
+/**
+ * Observes devices of certain kind are made unavailable and executes onDisconnect callback
+ * @param observeDevices
+ * @param onDisconnect
+ * @category Device Management
+ */
+export declare const useOnUnavailableDevices: (observeDevices: Observable<MediaDeviceInfo[]>, onDisconnect: () => void) => void;
+/**
+ * Observes disconnect of all video devices and executes onDisconnect callback
+ * @param onDisconnect
+ * @category Device Management
+ */
+export declare const useOnUnavailableVideoDevices: (onDisconnect: () => void) => void;
+/**
+ * Observes disconnect of all audio input devices and executes onDisconnect callback
+ * @param onDisconnect
+ * @category Device Management
+ */
+export declare const useOnUnavailableAudioInputDevices: (onDisconnect: () => void) => void;
+/**
+ * Observes disconnect of all audio output devices and executes onDisconnect callback
+ * @param onDisconnect
+ * @category Device Management
+ */
+export declare const useOnUnavailableAudioOutputDevices: (onDisconnect: () => void) => void;