@azure/communication-react 1.7.0-beta.1 → 1.7.1-alpha-202308170011

package/dist/dist-esm/react-composites/src/composites/CallComposite/adapter/AzureCommunicationCallAdapter.d.ts

@@ -4,16 +4,16 @@ import { StartCaptionsOptions } from '@azure/communication-calling';
 import { TeamsCallAgent } from '@azure/communication-calling';
 import { RoomCallLocator } from '@azure/communication-calling';
 import { AddPhoneNumberOptions, DtmfTone } from '@azure/communication-calling';
-import { CommonCallAdapter, CallEndedListener, CallIdChangedListener, CallAdapterState, DisplayNameChangedListener, IsMutedChangedListener, IsLocalScreenSharingActiveChangedListener, IsSpeakingChangedListener, ParticipantsJoinedListener, ParticipantsLeftListener, DiagnosticChangedEventListner, CallAdapter } from './CallAdapter';
+import { CommonCallAdapter, CallEndedListener, CallIdChangedListener, CallAdapterState, DisplayNameChangedListener, IsMutedChangedListener, IsLocalScreenSharingActiveChangedListener, IsSpeakingChangedListener, ParticipantsJoinedListener, ParticipantsLeftListener, DiagnosticChangedEventListner, CallAdapter, JoinCallOptions } from './CallAdapter';
 import { TransferRequestedListener } from './CallAdapter';
 import { CaptionsReceivedListener, IsCaptionsActiveChangedListener } from './CallAdapter';
 import { VideoBackgroundImage, VideoBackgroundEffect } from './CallAdapter';
 import { TeamsCallAdapter } from './CallAdapter';
 import { CreateVideoStreamViewResult, VideoStreamOptions } from "../../../../../react-components/src";
-import { Role } from "../../../../../react-components/src";
 import { CommunicationTokenCredential, CommunicationUserIdentifier, PhoneNumberIdentifier, CommunicationIdentifier, MicrosoftTeamsUserIdentifier } from '@azure/communication-common';
 import { AdapterError } from '../../common/adapters';
 import { OnFetchProfileCallback } from './OnFetchProfileCallback';
+import { VideoBackgroundEffectsDependency } from "../../../../../calling-component-bindings/src";
 declare type CallTypeOf<AgentType extends CallAgent | BetaTeamsCallAgent> = AgentType extends CallAgent ? Call : TeamsCall;
 /**
  * @private
@@ -35,9 +35,10 @@ export declare class AzureCommunicationCallAdapter<AgentType extends CallAgent |
     private participantSubscribers;
     private emitter;
     private onClientStateChange;
+    private onResolveVideoBackgroundEffectsDependency?;
     private get call();
     private set call(value);
-    constructor(callClient: StatefulCallClient, locator: CallAdapterLocator, callAgent: AgentType, deviceManager: StatefulDeviceManager, options?: AzureCommunicationCallAdapterOptions & TeamsAdapterOptions);
+    constructor(callClient: StatefulCallClient, locator: CallAdapterLocator, callAgent: AgentType, deviceManager: StatefulDeviceManager, options?: AzureCommunicationCallAdapterOptions | TeamsAdapterOptions);
     private subscribeDeviceManagerEvents;
     private bindPublicMethods;
     dispose(): void;
@@ -45,7 +46,7 @@ export declare class AzureCommunicationCallAdapter<AgentType extends CallAgent |
     queryMicrophones(): Promise<AudioDeviceInfo[]>;
     querySpeakers(): Promise<AudioDeviceInfo[]>;
     askDevicePermission(constrain: PermissionConstraints): Promise<void>;
-    joinCall(microphoneOn?: boolean): CallTypeOf<AgentType> | undefined;
+    joinCall(options?: boolean | JoinCallOptions): CallTypeOf<AgentType> | undefined;
     private _joinCall;
     createStreamView(remoteUserId?: string, options?: VideoStreamOptions): Promise<void | CreateVideoStreamViewResult>;
     disposeStreamView(remoteUserId?: string): Promise<void>;
@@ -160,7 +161,10 @@ export declare type CommonCallAdapterOptions = {
     /**
      * Default set of background images for background image picker.
      */
-    videoBackgroundImages?: VideoBackgroundImage[];
+    videoBackgroundOptions?: {
+        videoBackgroundImages?: VideoBackgroundImage[];
+        onResolveDependency?: () => Promise<VideoBackgroundEffectsDependency>;
+    };
     /**
      * Use this to fetch profile information which will override data in {@link CallAdapterState} like display name
      * The onFetchProfile is fetch-and-forget one time action for each user, once a user profile is updated, the value will be cached
@@ -173,14 +177,7 @@ export declare type CommonCallAdapterOptions = {
  *
  * @beta
  */
-export declare type AzureCommunicationCallAdapterOptions = {
-    /**
-     * Use this to hint the role of the user when the role is not available before a Rooms call is started. This value
-     * should be obtained using the Rooms API. This role will determine permissions in the configuration page of the
-     * {@link CallComposite}. The true role of the user will be synced with ACS services when a Rooms call starts.
-     */
-    roleHint?: Role;
-} & CommonCallAdapterOptions;
+export declare type AzureCommunicationCallAdapterOptions = CommonCallAdapterOptions;
 /**
  * Arguments for creating the Azure Communication Services implementation of {@link CallAdapter}.
  *
@@ -275,7 +272,7 @@ export declare const useTeamsCallAdapter: (args: Partial<TeamsCallAdapterArgs>,
  *
  * @public
  */
-export declare const createAzureCommunicationCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: CallAgent, locator: CallAdapterLocator, /* @conditional-compile-remove(rooms) */ /* @conditional-compile-remove(video-background-effects) */ options?: AzureCommunicationCallAdapterOptions) => Promise<CallAdapter>;
+export declare const createAzureCommunicationCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: CallAgent, locator: CallAdapterLocator, options?: AzureCommunicationCallAdapterOptions) => Promise<CallAdapter>;
 /**
  * Create a {@link TeamsCallAdapter} using the provided {@link StatefulCallClient}.
  *

package/dist/dist-esm/react-composites/src/composites/CallComposite/adapter/AzureCommunicationCallAdapter.js

@@ -31,11 +31,14 @@ import { useEffect, useRef, useState } from 'react';
 import { createHandlers } from './createHandlers';
 import { createProfileStateModifier } from './OnFetchProfileCallback';
 /* @conditional-compile-remove(video-background-effects) */
-import { getBackgroundEffectFromSelectedEffect, getSelectedCameraFromAdapterState } from '../utils';
+import { getBackgroundEffectFromSelectedEffect } from '../utils';
+import { getSelectedCameraFromAdapterState } from '../utils';
 /** Context of call, which is a centralized context for all state updates */
 class CallContext {
-    constructor(clientState, isTeamsCall, options) {
-        var _a, _b;
+    constructor(clientState, isTeamsCall, 
+    /* @conditional-compile-remove(rooms) */
+    isRoomsCall, options) {
+        var _a, _b, _c, _d;
         this.emitter = new EventEmitter();
         this.state = {
             isLocalPreviewMicrophoneEnabled: false,
@@ -46,19 +49,23 @@ class CallContext {
             page: 'configuration',
             latestErrors: clientState.latestErrors,
             isTeamsCall,
+            /* @conditional-compile-remove(rooms) */ isRoomsCall,
             /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId: clientState.alternateCallerId,
             /* @conditional-compile-remove(unsupported-browser) */ environmentInfo: clientState.environmentInfo,
             /* @conditional-compile-remove(unsupported-browser) */ unsupportedBrowserVersionsAllowed: false,
-            /* @conditional-compile-remove(rooms) */ roleHint: options === null || options === void 0 ? void 0 : options.roleHint,
-            /* @conditional-compile-remove(video-background-effects) */ videoBackgroundImages: options === null || options === void 0 ? void 0 : options.videoBackgroundImages,
+            /* @conditional-compile-remove(video-background-effects) */ videoBackgroundImages: (_b = options === null || options === void 0 ? void 0 : options.videoBackgroundOptions) === null || _b === void 0 ? void 0 : _b.videoBackgroundImages,
+            /* @conditional-compile-remove(video-background-effects) */
+            onResolveVideoEffectDependency: (_c = options === null || options === void 0 ? void 0 : options.videoBackgroundOptions) === null || _c === void 0 ? void 0 : _c.onResolveDependency,
             /* @conditional-compile-remove(video-background-effects) */ selectedVideoBackgroundEffect: undefined,
             cameraStatus: undefined
         };
-        this.emitter.setMaxListeners((_b = options === null || options === void 0 ? void 0 : options.maxListeners) !== null && _b !== void 0 ? _b : 50);
+        this.emitter.setMaxListeners((_d = options === null || options === void 0 ? void 0 : options.maxListeners) !== null && _d !== void 0 ? _d : 50);
         this.bindPublicMethods();
-        this.displayNameModifier = (options === null || options === void 0 ? void 0 : options.onFetchProfile) ? createProfileStateModifier(options.onFetchProfile, () => {
-            this.setState(this.getState());
-        }) : undefined;
+        this.displayNameModifier = (options === null || options === void 0 ? void 0 : options.onFetchProfile)
+            ? createProfileStateModifier(options.onFetchProfile, () => {
+                this.setState(this.getState());
+            })
+            : undefined;
     }
     bindPublicMethods() {
         /* @conditional-compile-remove(unsupported-browser) */
@@ -102,21 +109,26 @@ class CallContext {
             unsupportedBrowserVersionOptedIn: this.state.unsupportedBrowserVersionsAllowed
         };
         /* @conditional-compile-remove(call-transfer) */
-        const latestAcceptedTransfer = (call === null || call === void 0 ? void 0 : call.transfer.acceptedTransfers) ? findLatestAcceptedTransfer(call.transfer.acceptedTransfers) : undefined;
+        const latestAcceptedTransfer = (call === null || call === void 0 ? void 0 : call.transfer.acceptedTransfers)
+            ? findLatestAcceptedTransfer(call.transfer.acceptedTransfers)
+            : undefined;
         /* @conditional-compile-remove(call-transfer) */
         const transferCall = latestAcceptedTransfer ? clientState.calls[latestAcceptedTransfer.callId] : undefined;
-        const newPage = getCallCompositePage(call, latestEndedCall, /* @conditional-compile-remove(unsupported-browser) */ environmentInfo, /* @conditional-compile-remove(call-transfer) */ transferCall);
+        const newPage = getCallCompositePage(call, latestEndedCall, 
+        /* @conditional-compile-remove(unsupported-browser) */ environmentInfo, 
+        /* @conditional-compile-remove(call-transfer) */ transferCall);
         if (!IsCallEndedPage(oldPage) && IsCallEndedPage(newPage)) {
-            this.emitter.emit('callEnded', {
-                callId: this.callId
-            });
+            this.emitter.emit('callEnded', { callId: this.callId });
             // Reset the callId to undefined as the call has ended.
             this.setCurrentCallId(undefined);
             // Make sure that the call is set to undefined in the state.
             call = undefined;
         }
         if (this.state.page) {
-            this.setState(Object.assign(Object.assign({}, this.state), { userId: clientState.userId, displayName: (_a = clientState.callAgent) === null || _a === void 0 ? void 0 : _a.displayName, call, page: newPage, endedCall: latestEndedCall, devices: clientState.deviceManager, latestErrors: clientState.latestErrors, cameraStatus: (call === null || call === void 0 ? void 0 : call.localVideoStreams.find(s => s.mediaStreamType === 'Video')) || clientState.deviceManager.unparentedViews.find(s => s.mediaStreamType === 'Video') ? 'On' : 'Off', 
+            this.setState(Object.assign(Object.assign({}, this.state), { userId: clientState.userId, displayName: (_a = clientState.callAgent) === null || _a === void 0 ? void 0 : _a.displayName, call, page: newPage, endedCall: latestEndedCall, devices: clientState.deviceManager, latestErrors: clientState.latestErrors, cameraStatus: (call === null || call === void 0 ? void 0 : call.localVideoStreams.find((s) => s.mediaStreamType === 'Video')) ||
+                    clientState.deviceManager.unparentedViews.find((s) => s.mediaStreamType === 'Video')
+                    ? 'On'
+                    : 'Off', 
                 /* @conditional-compile-remove(call-transfer) */ acceptedTransferCallState: transferCall }));
         }
     }
@@ -171,6 +183,7 @@ const findLatestAcceptedTransfer = (acceptedTransfers) => {
  */
 export class AzureCommunicationCallAdapter {
     constructor(callClient, locator, callAgent, deviceManager, options) {
+        var _a;
         this.participantSubscribers = new Map();
         this.emitter = new EventEmitter();
         this.isMyMutedChanged = () => {
@@ -185,17 +198,15 @@ export class AzureCommunicationCallAdapter {
         this.callAgent = callAgent;
         this.locator = locator;
         this.deviceManager = deviceManager;
-        const isTeamsMeeting = ('meetingLink' in this.locator);
-        /* @conditional-compile-remove(rooms) */
-        const isRoomsCall = ('roomId' in this.locator);
+        const isTeamsMeeting = 'meetingLink' in this.locator;
         /* @conditional-compile-remove(rooms) */
-        // to prevent showing components that depend on role such as local video tile, camera button, etc. in a rooms call
-        // we set the default roleHint as 'Consumer' when roleHint is undefined since it has the lowest level of permissions
-        if (isRoomsCall && (options === null || options === void 0 ? void 0 : options.roleHint) === undefined) {
-            options = Object.assign(Object.assign({}, options), { roleHint: 'Consumer' });
-        }
-        this.context = new CallContext(callClient.getState(), isTeamsMeeting, options);
-        this.context.onCallEnded(endCallData => this.emitter.emit('callEnded', endCallData));
+        const isRoomsCall = 'roomId' in this.locator;
+        /* @conditional-compile-remove(video-background-effects) */
+        this.onResolveVideoBackgroundEffectsDependency = (_a = options === null || options === void 0 ? void 0 : options.videoBackgroundOptions) === null || _a === void 0 ? void 0 : _a.onResolveDependency;
+        this.context = new CallContext(callClient.getState(), isTeamsMeeting, 
+        /* @conditional-compile-remove(rooms) */ isRoomsCall, 
+        /* @conditional-compile-remove(video-background-effects) */ options);
+        this.context.onCallEnded((endCallData) => this.emitter.emit('callEnded', endCallData));
         const onStateChange = (clientState) => {
             var _a, _b;
             // unsubscribe when the instance gets disposed
@@ -218,9 +229,12 @@ export class AzureCommunicationCallAdapter {
             // TODO: Remove this if statement when Calling SDK prevents accepting transfer requests that have timed out
             // This is to handle the case when there has been an accepted transfer call that is now in the connected state
             // AND is not the current call. Ensure we leave the current call.
-            if (acceptedTransferCallState && acceptedTransferCallState.state === 'Connected' && ((_b = this.call) === null || _b === void 0 ? void 0 : _b.id) && acceptedTransferCallState.id !== this.call.id) {
+            if (acceptedTransferCallState &&
+                acceptedTransferCallState.state === 'Connected' &&
+                ((_b = this.call) === null || _b === void 0 ? void 0 : _b.id) &&
+                acceptedTransferCallState.id !== this.call.id) {
                 const cAgent = callAgent;
-                const transferCall = cAgent.calls.find(call => call.id === acceptedTransferCallState.id);
+                const transferCall = cAgent.calls.find((call) => call.id === acceptedTransferCallState.id);
                 if (transferCall) {
                     const oldCall = this.call;
                     this.processNewCall(transferCall);
@@ -235,7 +249,10 @@ export class AzureCommunicationCallAdapter {
                 }
             }
         };
-        this.handlers = createHandlers(callClient, callAgent, deviceManager, undefined);
+        this.handlers = createHandlers(callClient, callAgent, deviceManager, undefined, 
+        /* @conditional-compile-remove(video-background-effects) */ {
+            onResolveVideoBackgroundEffectsDependency: this.onResolveVideoBackgroundEffectsDependency
+        });
         this.onClientStateChange = onStateChange;
         this.subscribeDeviceManagerEvents();
         this.callClient.onStateChange(onStateChange);
@@ -244,7 +261,7 @@ export class AzureCommunicationCallAdapter {
             const onCallsUpdated = (args) => {
                 var _a;
                 if ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id) {
-                    const removedCall = args.removed.find(call => { var _a; return call.id === ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id); });
+                    const removedCall = args.removed.find((call) => { var _a; return call.id === ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id); });
                     if (removedCall) {
                         const removedCallState = this.callClient.getState().callsEnded[removedCall.id];
                         const latestAcceptedTransfer = findLatestAcceptedTransfer(removedCallState.transfer.acceptedTransfers);
@@ -262,7 +279,7 @@ export class AzureCommunicationCallAdapter {
             const onTeamsCallsUpdated = (args) => {
                 var _a;
                 if ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id) {
-                    const removedCall = args.removed.find(call => { var _a; return call.id === ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id); });
+                    const removedCall = args.removed.find((call) => { var _a; return call.id === ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id); });
                     if (removedCall) {
                         const removedCallState = this.callClient.getState().callsEnded[removedCall.id];
                         const latestAcceptedTransfer = findLatestAcceptedTransfer(removedCallState.transfer.acceptedTransfers);
@@ -395,27 +412,48 @@ export class AzureCommunicationCallAdapter {
             }));
         });
     }
-    joinCall(microphoneOn) {
+    joinCall(options) {
         var _a, _b;
         if (_isInCall((_b = (_a = this.getState().call) === null || _a === void 0 ? void 0 : _a.state) !== null && _b !== void 0 ? _b : 'None')) {
             throw new Error('You are already in the call!');
         }
         return this.teeErrorToEventEmitter(() => {
-            const audioOptions = {
-                muted: !(microphoneOn !== null && microphoneOn !== void 0 ? microphoneOn : this.getState().isLocalPreviewMicrophoneEnabled)
-            };
-            // TODO: find a way to expose stream to here
-            const videoOptions = {
-                localVideoStreams: this.localStream ? [this.localStream] : undefined
-            };
+            var _a, _b;
+            let audioOptions;
+            let videoOptions;
+            // if using the deprecated joinCall API
+            if (typeof options !== 'object') {
+                const microphoneOn = options;
+                audioOptions = { muted: !(microphoneOn !== null && microphoneOn !== void 0 ? microphoneOn : this.getState().isLocalPreviewMicrophoneEnabled) };
+                // TODO: find a way to expose stream to here
+                videoOptions = { localVideoStreams: this.localStream ? [this.localStream] : undefined };
+            }
+            else {
+                // if using the options bag
+                // undefined = keep = use precall state
+                // true = turn on
+                // false = turn off
+                const microphoneState = (_a = options.microphoneOn) !== null && _a !== void 0 ? _a : 'keep';
+                const cameraState = (_b = options.cameraOn) !== null && _b !== void 0 ? _b : 'keep';
+                audioOptions = {
+                    muted: !(microphoneState === 'keep' ? this.getState().isLocalPreviewMicrophoneEnabled : microphoneState)
+                };
+                const selectedCamera = getSelectedCameraFromAdapterState(this.getState());
+                const localStream = selectedCamera ? new SDKLocalVideoStream(selectedCamera) : undefined;
+                const precallVideoOptions = { localVideoStreams: this.localStream ? [this.localStream] : undefined };
+                videoOptions =
+                    cameraState === 'keep'
+                        ? precallVideoOptions
+                        : localStream && (options === null || options === void 0 ? void 0 : options.cameraOn)
+                            ? { localVideoStreams: [localStream] }
+                            : {};
+            }
             /* @conditional-compile-remove(teams-adhoc-call) */
             /* @conditional-compile-remove(PSTN-calls) */
             if (isOutboundCall(this.locator)) {
                 const phoneNumber = this.getState().alternateCallerId;
                 return this.startCall(this.locator.participantIds, {
-                    alternateCallerId: phoneNumber ? {
-                        phoneNumber: phoneNumber
-                    } : undefined,
+                    alternateCallerId: phoneNumber ? { phoneNumber: phoneNumber } : undefined,
                     audioOptions,
                     videoOptions
                 });
@@ -426,9 +464,9 @@ export class AzureCommunicationCallAdapter {
         });
     }
     _joinCall(audioOptions, videoOptions) {
-        const isTeamsMeeting = ('meetingLink' in this.locator);
+        const isTeamsMeeting = 'meetingLink' in this.locator;
         /* @conditional-compile-remove(rooms) */
-        const isRoomsCall = ('roomId' in this.locator);
+        const isRoomsCall = 'roomId' in this.locator;
         /* @conditional-compile-remove(teams-identity-support) */
         if (_isTeamsCallAgent(this.callAgent)) {
             if (!isTeamsMeeting) {
@@ -496,7 +534,10 @@ export class AzureCommunicationCallAdapter {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.handlers.onHangUp(forEveryone);
             this.unsubscribeCallEvents();
-            this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, undefined);
+            this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, undefined, 
+            /* @conditional-compile-remove(video-background-effects) */ {
+                onResolveVideoBackgroundEffectsDependency: this.onResolveVideoBackgroundEffectsDependency
+            });
             // We set the adapter.call object to undefined immediately when a call is ended.
             // We do not set the context.callId to undefined because it is a part of the immutable data flow loop.
             this.call = undefined;
@@ -535,9 +576,9 @@ export class AzureCommunicationCallAdapter {
                     {
                         const selectedEffect = this.getState().selectedVideoBackgroundEffect;
                         const selectedCamera = getSelectedCameraFromAdapterState(this.getState());
-                        if (selectedEffect && selectedCamera) {
+                        if (selectedEffect && selectedCamera && this.onResolveVideoBackgroundEffectsDependency) {
                             const stream = new SDKLocalVideoStream(selectedCamera);
-                            const effect = getBackgroundEffectFromSelectedEffect(selectedEffect);
+                            const effect = getBackgroundEffectFromSelectedEffect(selectedEffect, yield this.onResolveVideoBackgroundEffectsDependency());
                             if (effect) {
                                 yield stream.feature(Features.VideoEffects).startEffects(effect);
                             }
@@ -639,7 +680,7 @@ export class AzureCommunicationCallAdapter {
         if (_isInCall((_b = (_a = this.getState().call) === null || _a === void 0 ? void 0 : _a.state) !== null && _b !== void 0 ? _b : 'None')) {
             throw new Error('You are already in the call.');
         }
-        const idsToAdd = participants.map(participant => {
+        const idsToAdd = participants.map((participant) => {
             // FIXME: `onStartCall` does not allow a Teams user.
             // Need some way to return an error if a Teams user is provided.
             const backendId = _toCommunicationIdentifier(participant);
@@ -666,7 +707,10 @@ export class AzureCommunicationCallAdapter {
         this.context.setCurrentCallId(call.id);
         // Resync state after callId is set
         this.context.updateClientState(this.callClient.getState());
-        this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, this.call);
+        this.handlers = createHandlers(this.callClient, this.callAgent, this.deviceManager, this.call, 
+        /* @conditional-compile-remove(video-background-effects) */ {
+            onResolveVideoBackgroundEffectsDependency: this.onResolveVideoBackgroundEffectsDependency
+        });
         this.subscribeCallEvents();
     }
     /* @conditional-compile-remove(video-background-effects) */
@@ -801,19 +845,15 @@ export class AzureCommunicationCallAdapter {
     }
     onRemoteParticipantsUpdated({ added, removed }) {
         if (added && added.length > 0) {
-            this.emitter.emit('participantsJoined', {
-                joined: added
-            });
+            this.emitter.emit('participantsJoined', { joined: added });
         }
         if (removed && removed.length > 0) {
-            this.emitter.emit('participantsLeft', {
-                removed: removed
-            });
+            this.emitter.emit('participantsLeft', { removed: removed });
         }
-        added.forEach(participant => {
+        added.forEach((participant) => {
             this.participantSubscribers.set(toFlatCommunicationIdentifier(participant.identifier), new ParticipantSubscriber(participant, this.emitter));
         });
-        removed.forEach(participant => {
+        removed.forEach((participant) => {
             const subscriber = this.participantSubscribers.get(toFlatCommunicationIdentifier(participant.identifier));
             subscriber && subscriber.unsubscribeAll();
             this.participantSubscribers.delete(toFlatCommunicationIdentifier(participant.identifier));
@@ -821,15 +861,11 @@ export class AzureCommunicationCallAdapter {
     }
     isScreenSharingOnChanged() {
         var _a;
-        this.emitter.emit('isLocalScreenSharingActiveChanged', {
-            isScreenSharingOn: (_a = this.call) === null || _a === void 0 ? void 0 : _a.isScreenSharingOn
-        });
+        this.emitter.emit('isLocalScreenSharingActiveChanged', { isScreenSharingOn: (_a = this.call) === null || _a === void 0 ? void 0 : _a.isScreenSharingOn });
     }
     /* @conditional-compile-remove(close-captions) */
     captionsReceived(captionsInfo) {
-        this.emitter.emit('captionsReceived', {
-            captionsInfo
-        });
+        this.emitter.emit('captionsReceived', { captionsInfo });
     }
     /* @conditional-compile-remove(close-captions) */
     isCaptionsActiveChanged() {
@@ -847,18 +883,16 @@ export class AzureCommunicationCallAdapter {
                     audioOptions: (_d = options === null || options === void 0 ? void 0 : options.audioOptions) !== null && _d !== void 0 ? _d : {
                         muted: !!((_e = this.context.getState().call) === null || _e === void 0 ? void 0 : _e.isMuted)
                     },
-                    videoOptions: (_f = options === null || options === void 0 ? void 0 : options.videoOptions) !== null && _f !== void 0 ? _f : ( /* maintain video state if options.videoOptions is not defined */videoSource ? {
-                        localVideoStreams: [new LocalVideoStream(videoSource)]
-                    } : undefined)
+                    videoOptions: (_f = options === null || options === void 0 ? void 0 : options.videoOptions) !== null && _f !== void 0 ? _f : 
+                    /* maintain video state if options.videoOptions is not defined */
+                    (videoSource ? { localVideoStreams: [new LocalVideoStream(videoSource)] } : undefined)
                 });
             } });
         this.emitter.emit('transferRequested', newArgs);
     }
     callIdChanged() {
         var _a;
-        ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id) && this.emitter.emit('callIdChanged', {
-            callId: this.call.id
-        });
+        ((_a = this.call) === null || _a === void 0 ? void 0 : _a.id) && this.emitter.emit('callIdChanged', { callId: this.call.id });
     }
     resetDiagnosticsForwarder(newCall) {
         if (this.diagnosticsForwarder) {
@@ -919,7 +953,8 @@ export const createAzureCommunicationCallAdapter = ({ userId, displayName, crede
     const callAgent = yield callClient.createCallAgent(credential, {
         displayName
     });
-    const adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locator, /* @conditional-compile-remove(video-background-effects) */ options);
+    const adapter = createAzureCommunicationCallAdapterFromClient(callClient, callAgent, locator, 
+    /* @conditional-compile-remove(video-background-effects) */ options);
     return adapter;
 });
 /* @conditional-compile-remove(teams-identity-support) */
@@ -944,7 +979,7 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
     const displayName = 'displayName' in args ? args.displayName : undefined;
     /* @conditional-compile-remove(PSTN-calls) */
     const alternateCallerId = 'alternateCallerId' in args ? args.alternateCallerId : undefined;
-    /* @conditional-compile-remove(rooms) */
+    /* @conditional-compile-remove(video-background-effects) */
     const options = 'options' in args ? args.options : undefined;
     // State update needed to rerender the parent component when a new adapter is created.
     const [adapter, setAdapter] = useState(undefined);
@@ -985,11 +1020,6 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
                 if (!displayName) {
                     throw new Error('Unreachable code, displayName already checked above.');
                 }
-                // This is just the type check to ensure that roleHint is defined.
-                /* @conditional-compile-remove(rooms) */
-                if (options && !('roleHint' in options)) {
-                    throw new Error('Unreachable code, provided a options without roleHint.');
-                }
                 if (creatingAdapterRef.current) {
                     console.warn('Adapter is already being created, please see storybook for more information: https://azure.github.io/communication-ui-library/?path=/story/troubleshooting--page');
                     return;
@@ -1001,7 +1031,7 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
                     locator,
                     userId: userId,
                     /* @conditional-compile-remove(PSTN-calls) */ alternateCallerId,
-                    /* @conditional-compile-remove(rooms) */ options
+                    /* @conditional-compile-remove(video-background-effects) */ options
                 }));
             }
             else if (adapterKind === 'Teams') {
@@ -1033,10 +1063,20 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
         }))();
     }, 
     // Explicitly list all arguments so that caller doesn't have to memoize the `args` object.
-    [adapterRef, afterCreateRef, beforeDisposeRef, adapterKind, credential, locator, userId, displayName,
+    [
+        adapterRef,
+        afterCreateRef,
+        beforeDisposeRef,
+        adapterKind,
+        credential,
+        locator,
+        userId,
+        displayName,
+        /* @conditional-compile-remove(PSTN-calls) */
         alternateCallerId,
         /* @conditional-compile-remove(teams-identity-support) */
-        options]);
+        options
+    ]);
     // Dispose any existing adapter when the component unmounts.
     useEffect(() => {
         return () => {
@@ -1067,7 +1107,26 @@ const useAzureCommunicationCallAdapterGeneric = (args, afterCreate, beforeDispos
  *
  * @public
  */
-export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispose) => {
+export const useAzureCommunicationCallAdapter = (
+/**
+ * Arguments to be passed to {@link createAzureCommunicationCallAdapter}.
+ *
+ * Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments
+ * as they are created. The adapter is only created when all arguments are defined.
+ */
+args, 
+/**
+ * Optional callback to modify the adapter once it is created.
+ *
+ * If set, must return the modified adapter.
+ */
+afterCreate, 
+/**
+ * Optional callback called before the adapter is disposed.
+ *
+ * This is useful for clean up tasks, e.g., leaving any ongoing calls.
+ */
+beforeDispose) => {
     return useAzureCommunicationCallAdapterGeneric(args, afterCreate, beforeDispose, 'AzureCommunication');
 };
 /* @conditional-compile-remove(teams-identity-support) */
@@ -1085,7 +1144,26 @@ export const useAzureCommunicationCallAdapter = (args, afterCreate, beforeDispos
  *
  * @beta
  */
-export const useTeamsCallAdapter = (args, afterCreate, beforeDispose) => {
+export const useTeamsCallAdapter = (
+/**
+ * Arguments to be passed to {@link createAzureCommunicationCallAdapter}.
+ *
+ * Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments
+ * as they are created. The adapter is only created when all arguments are defined.
+ */
+args, 
+/**
+ * Optional callback to modify the adapter once it is created.
+ *
+ * If set, must return the modified adapter.
+ */
+afterCreate, 
+/**
+ * Optional callback called before the adapter is disposed.
+ *
+ * This is useful for clean up tasks, e.g., leaving any ongoing calls.
+ */
+beforeDispose) => {
     return useAzureCommunicationCallAdapterGeneric(args, afterCreate, beforeDispose, 'Teams');
 };
 /**
@@ -1097,10 +1175,15 @@ export const useTeamsCallAdapter = (args, afterCreate, beforeDispose) => {
  * @public
  */
 export const createAzureCommunicationCallAdapterFromClient = (callClient, callAgent, locator, options) => __awaiter(void 0, void 0, void 0, function* () {
-    const deviceManager = yield callClient.getDeviceManager();
+    const deviceManager = (yield callClient.getDeviceManager());
+    yield Promise.all([deviceManager.getCameras(), deviceManager.getMicrophones()]);
+    if (deviceManager.isSpeakerSelectionAvailable) {
+        yield deviceManager.getSpeakers();
+    }
     /* @conditional-compile-remove(unsupported-browser) */
     yield callClient.feature(Features.DebugInfo).getEnvironmentInfo();
-    return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager, /* @conditional-compile-remove(rooms) */ options);
+    return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager, 
+    /* @conditional-compile-remove(video-background-effects) */ options);
 });
 /* @conditional-compile-remove(teams-identity-support) */
 /**
@@ -1112,7 +1195,11 @@ export const createAzureCommunicationCallAdapterFromClient = (callClient, callAg
  * @beta
  */
 export const createTeamsCallAdapterFromClient = (callClient, callAgent, locator, options) => __awaiter(void 0, void 0, void 0, function* () {
-    const deviceManager = yield callClient.getDeviceManager();
+    const deviceManager = (yield callClient.getDeviceManager());
+    yield Promise.all([deviceManager.getCameras(), deviceManager.getMicrophones()]);
+    if (deviceManager.isSpeakerSelectionAvailable) {
+        yield deviceManager.getSpeakers();
+    }
     /* @conditional-compile-remove(unsupported-browser) */
     yield callClient.feature(Features.DebugInfo).getEnvironmentInfo();
     return new AzureCommunicationCallAdapter(callClient, locator, callAgent, deviceManager, options);