@microsoft/teams-js 2.16.0-beta.1 → 2.16.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2025,7 +2025,7 @@ export namespace teams {
2025
2025
  * @internal
2026
2026
  * Limited to Microsoft-internal use
2027
2027
  */
2028
- export namespace videoEx {
2028
+ export namespace videoEffectsEx {
2029
2029
  /**
2030
2030
  * @hidden
2031
2031
  * Error level when notifying errors to the host, the host will decide what to do acording to the error level.
@@ -2046,7 +2046,7 @@ export namespace videoEx {
2046
2046
  * @internal
2047
2047
  * Limited to Microsoft-internal use
2048
2048
  */
2049
- interface VideoFrameConfig extends video.VideoFrameConfig {
2049
+ interface VideoFrameConfig extends videoEffects.VideoFrameConfig {
2050
2050
  /**
2051
2051
  * @hidden
2052
2052
  * Flag to indicate use camera stream to synthesize video frame or not.
@@ -2075,7 +2075,7 @@ export namespace videoEx {
2075
2075
  * @internal
2076
2076
  * Limited to Microsoft-internal use
2077
2077
  */
2078
- interface VideoBufferData extends video.VideoBufferData {
2078
+ interface VideoBufferData extends videoEffects.VideoBufferData {
2079
2079
  /**
2080
2080
  * @hidden
2081
2081
  * The model output if you passed in an {@linkcode VideoFrameConfig.audioInferenceModel}
@@ -2106,7 +2106,7 @@ export namespace videoEx {
2106
2106
  * @internal
2107
2107
  * Limited to Microsoft-internal use
2108
2108
  */
2109
- type VideoFrameData = video.VideoFrameData & {
2109
+ type VideoFrameData = videoEffects.VideoFrameData & {
2110
2110
  /**
2111
2111
  * @hidden
2112
2112
  * The model output if you passed in an {@linkcode VideoFrameConfig.audioInferenceModel}
@@ -2128,7 +2128,7 @@ export namespace videoEx {
2128
2128
  * @internal
2129
2129
  * Limited to Microsoft-internal use
2130
2130
  */
2131
- type VideoFrameHandler = (receivedVideoFrame: VideoFrameData) => Promise<video.VideoFrame>;
2131
+ type VideoFrameHandler = (receivedVideoFrame: VideoFrameData) => Promise<videoEffects.VideoFrame>;
2132
2132
  /**
2133
2133
  * @hidden
2134
2134
  * @beta
@@ -2176,7 +2176,7 @@ export namespace videoEx {
2176
2176
  * @internal
2177
2177
  * Limited to Microsoft-internal use
2178
2178
  */
2179
- function notifySelectedVideoEffectChanged(effectChangeType: video.EffectChangeType, effectId: string | undefined, effectParam?: string): void;
2179
+ function notifySelectedVideoEffectChanged(effectChangeType: videoEffects.EffectChangeType, effectId: string | undefined, effectParam?: string): void;
2180
2180
  /**
2181
2181
  * @hidden
2182
2182
  * Register the video effect callback, host uses this to notify the video extension the new video effect will by applied
@@ -3363,7 +3363,7 @@ export interface Context {
3363
3363
  * @deprecated
3364
3364
  * As of 2.0.0, please use {@link app.AppInfo.sessionId | app.Context.app.sessionId} instead
3365
3365
  *
3366
- * Unique ID for the current session for use in correlating telemetry data.
3366
+ * Unique ID for the current session for use in correlating telemetry data. A session corresponds to the lifecycle of an app. A new session begins upon the creation of a webview (on Teams mobile) or iframe (in Teams desktop) hosting the app, and ends when it is destroyed.
3367
3367
  */
3368
3368
  appSessionId?: string;
3369
3369
  /**
@@ -3874,7 +3874,7 @@ export namespace app {
3874
3874
  */
3875
3875
  theme: string;
3876
3876
  /**
3877
- * Unique ID for the current session for use in correlating telemetry data.
3877
+ * Unique ID for the current session for use in correlating telemetry data. A session corresponds to the lifecycle of an app. A new session begins upon the creation of a webview (on Teams mobile) or iframe (in Teams desktop) hosting the app, and ends when it is destroyed.
3878
3878
  */
3879
3879
  sessionId: string;
3880
3880
  /**
@@ -6159,6 +6159,8 @@ export namespace location {
6159
6159
  * Interact with meetings, including retrieving meeting details, getting mic status, and sharing app content.
6160
6160
  * This namespace is used to handle meeting related functionality like
6161
6161
  * get meeting details, get/update state of mic, sharing app content and more.
6162
+ *
6163
+ * To learn more, visit https://aka.ms/teamsmeetingapps
6162
6164
  */
6163
6165
  export namespace meeting {
6164
6166
  /** Error callback function type */
@@ -6277,10 +6279,15 @@ export namespace meeting {
6277
6279
  */
6278
6280
  tenantId?: string;
6279
6281
  }
6280
- /** Represents the current live streaming state of a meeting */
6282
+ /**
6283
+ * Represents the current Real-Time Messaging Protocol (RTMP) live streaming state of a meeting.
6284
+ *
6285
+ * @remarks
6286
+ * RTMP is a popular communication protocol for streaming audio, video, and data over the Internet.
6287
+ */
6281
6288
  export interface LiveStreamState {
6282
6289
  /**
6283
- * indicates whether meeting is streaming
6290
+ * true when the current meeting is being streamed through RTMP, or false if it is not.
6284
6291
  */
6285
6292
  isStreaming: boolean;
6286
6293
  /**
@@ -6296,7 +6303,8 @@ export namespace meeting {
6296
6303
  /** Represents app permission to share contents to meeting. */
6297
6304
  export interface IAppContentStageSharingCapabilities {
6298
6305
  /**
6299
- * indicates whether app has permission to share contents to meeting stage
6306
+ * indicates whether app has permission to share contents to meeting stage.
6307
+ * true when your `configurableTabs` or `staticTabs` entry's `context` array includes `meetingStage`.
6300
6308
  */
6301
6309
  doesAppHaveSharePermission: boolean;
6302
6310
  }
@@ -6313,8 +6321,7 @@ export namespace meeting {
6313
6321
  */
6314
6322
  export interface ISpeakingState {
6315
6323
  /**
6316
- * Indicates whether one or more participants in a meeting are speaking, or
6317
- * if no participants are speaking
6324
+ * true when one or more participants in a meeting are speaking, or false if no participants are speaking
6318
6325
  */
6319
6326
  isSpeakingDetected: boolean;
6320
6327
  /**
@@ -6454,54 +6461,123 @@ export namespace meeting {
6454
6461
  surprised = "surprised",
6455
6462
  applause = "applause"
6456
6463
  }
6457
- /** Represents the type of a meeting */
6464
+ /**
6465
+ * Represents the type of a meeting
6466
+ *
6467
+ * @hidden
6468
+ * Hide from docs.
6469
+ *
6470
+ * @remarks
6471
+ * Teams has several types of meetings to account for different user scenarios and requirements.
6472
+ */
6458
6473
  export enum MeetingType {
6459
- /** Used when the meeting type is not known. */
6474
+ /**
6475
+ * Used when the meeting type is not known.
6476
+ *
6477
+ * @remarks
6478
+ * This response is not an expected case.
6479
+ */
6460
6480
  Unknown = "Unknown",
6461
- /** Used for ad hoc meetings that are created on the fly. */
6481
+ /**
6482
+ * Used for group call meeting types.
6483
+ *
6484
+ * @remarks
6485
+ * To test this meeting type in Teams, start a chat with two or more users and click the "Call" button.
6486
+ * Note that a group call may return as this or {@link CallType.GroupCall}. These two different response types should be considered as equal.
6487
+ */
6462
6488
  Adhoc = "Adhoc",
6463
- /** Used for meetings that have been scheduled in advance. */
6489
+ /**
6490
+ * Used for single-occurrence meetings that have been scheduled in advance.
6491
+ *
6492
+ * @remarks
6493
+ * To create a meeting of this type in Teams, press the "New meeting" button from the calendar and enter a meeting title.
6494
+ * Before saving, ensure that the "Online Meeting" field is checked.
6495
+ */
6464
6496
  Scheduled = "Scheduled",
6465
- /** Used for meetings that occur on a recurring basis. */
6497
+ /**
6498
+ * Used for meetings that occur on a recurring basis.
6499
+ *
6500
+ * @remarks
6501
+ * To create a meeting of this type in Teams, press the "New meeting" button from the calendar, enter a meeting title, and then change the field labeled "Does not repeat" to some other value.
6502
+ * Before saving, ensure that the "Online Meeting" field is checked.
6503
+ */
6466
6504
  Recurring = "Recurring",
6467
- /** Used for live events or webinars. */
6505
+ /**
6506
+ * Used for webinars.
6507
+ *
6508
+ * @remarks
6509
+ * Meeting apps are only supported for those in the "event group" of a webinar, which are those who'll be presenting and producing the webinar.
6510
+ * To learn how to create a meeting of this type, visit https://aka.ms/teams/howto/webinars.
6511
+ */
6468
6512
  Broadcast = "Broadcast",
6469
- /** Used for meetings that are created on the fly, but with a more polished experience than ad hoc meetings. */
6513
+ /**
6514
+ * Used for meet now meetings, which are meetings users create on the fly.
6515
+ *
6516
+ * @remarks
6517
+ * To create a meeting of this type, click the "Meet now" button from the calendar in Teams or the "Teams call" button in Outlook.
6518
+ */
6470
6519
  MeetNow = "MeetNow"
6471
6520
  }
6472
- /** Represents the type of a call. */
6521
+ /**
6522
+ * Represents the type of a call.
6523
+ *
6524
+ * @hidden
6525
+ * Hide from docs.
6526
+ */
6473
6527
  export enum CallType {
6474
- /** Represents a call between two people. */
6528
+ /**
6529
+ * Represents a call between two people.
6530
+ *
6531
+ * @remarks
6532
+ * To test this feature, start a chat with one other user and click the "Call" button.
6533
+ */
6475
6534
  OneOnOneCall = "oneOnOneCall",
6476
- /** Represents a call between more than two people. */
6535
+ /**
6536
+ * Represents a call between more than two people.
6537
+ *
6538
+ * @remarks
6539
+ * To test this meeting type in Teams, start a chat with two or more users and click the "Call" button.
6540
+ * Note that a group call may return as this or {@link MeetingType.Adhoc}. These two different response types should be considered as equal.
6541
+ */
6477
6542
  GroupCall = "groupCall"
6478
6543
  }
6479
6544
  /**
6480
- * Allows an app to get the incoming audio speaker setting for the meeting user
6545
+ * Allows an app to get the incoming audio speaker setting for the meeting user.
6546
+ * To learn more, visit https://aka.ms/teamsjs/getIncomingClientAudioState
6481
6547
  *
6482
- * @param callback - Callback contains 2 parameters, error and result.
6548
+ * @remarks
6549
+ * Use {@link toggleIncomingClientAudio} to toggle the current audio state.
6550
+ * For private scheduled meetings, meet now, or calls, include the `OnlineMeetingParticipant.ToggleIncomingAudio.Chat` RSC permission in your app manifest.
6551
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/authorization.
6552
+ * This API can only be used in the `sidePanel` and `meetingStage` frame contexts.
6483
6553
  *
6484
- * error can either contain an error of type SdkError, incase of an error, or null when fetch is successful
6485
- * result can either contain the true/false value, incase of a successful fetch or null when the fetching fails
6486
- * result: True means incoming audio is muted and false means incoming audio is unmuted
6554
+ * @param callback - Callback contains 2 parameters, `error` and `result`.
6555
+ * `error` can either contain an error of type `SdkError`, in case of an error, or null when fetch is successful.
6556
+ * `result` will be true when incoming audio is muted and false when incoming audio is unmuted, or null when the request fails.
6487
6557
  */
6488
6558
  export function getIncomingClientAudioState(callback: errorCallbackFunctionType): void;
6489
6559
  /**
6490
- * Allows an app to toggle the incoming audio speaker setting for the meeting user from mute to unmute or vice-versa
6560
+ * Allows an app to toggle the incoming audio speaker setting for the meeting user from mute to unmute or vice-versa.
6561
+ * To learn more, visit https://aka.ms/teamsjs/toggleIncomingClientAudio
6491
6562
  *
6492
- * @param callback - Callback contains 2 parameters, error and result.
6493
- * error can either contain an error of type SdkError, incase of an error, or null when toggle is successful
6494
- * result can either contain the true/false value, incase of a successful toggle or null when the toggling fails
6495
- * result: True means incoming audio is muted and false means incoming audio is unmuted
6563
+ * @remarks
6564
+ * Use {@link getIncomingClientAudioState} to get the current audio state.
6565
+ * For private scheduled meetings, meet now, or calls, include the `OnlineMeetingParticipant.ToggleIncomingAudio.Chat` RSC permission in your app manifest.
6566
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/authorization.
6567
+ * This API can only be used in the `sidePanel` and `meetingStage` frame contexts.
6568
+ *
6569
+ * @param callback - Callback contains 2 parameters, `error` and `result`.
6570
+ * `error` can either contain an error of type `SdkError`, in case of an error, or null when toggle is successful.
6571
+ * `result` will be true when incoming audio is muted and false when incoming audio is unmuted, or null when the toggling fails.
6496
6572
  */
6497
6573
  export function toggleIncomingClientAudio(callback: errorCallbackFunctionType): void;
6498
6574
  /**
6499
6575
  * @hidden
6500
6576
  * Allows an app to get the meeting details for the meeting
6501
6577
  *
6502
- * @param callback - Callback contains 2 parameters, error and meetingDetailsResponse.
6503
- * error can either contain an error of type SdkError, incase of an error, or null when get is successful
6504
- * result can either contain a IMeetingDetailsResponse value, in case of a successful get or null when the get fails
6578
+ * @param callback - Callback contains 2 parameters, `error` and `meetingDetailsResponse`.
6579
+ * `error` can either contain an error of type `SdkError`, in case of an error, or null when get is successful
6580
+ * `result` can either contain a {@link IMeetingDetailsResponse} value, in case of a successful get or null when the get fails
6505
6581
  *
6506
6582
  * @internal
6507
6583
  * Limited to Microsoft-internal use
@@ -6511,67 +6587,105 @@ export namespace meeting {
6511
6587
  * @hidden
6512
6588
  * Allows an app to get the authentication token for the anonymous or guest user in the meeting
6513
6589
  *
6514
- * @param callback - Callback contains 2 parameters, error and authenticationTokenOfAnonymousUser.
6515
- * error can either contain an error of type SdkError, incase of an error, or null when get is successful
6516
- * authenticationTokenOfAnonymousUser can either contain a string value, incase of a successful get or null when the get fails
6590
+ * @param callback - Callback contains 2 parameters, `error` and `authenticationTokenOfAnonymousUser`.
6591
+ * `error` can either contain an error of type `SdkError`, in case of an error, or null when get is successful
6592
+ * `authenticationTokenOfAnonymousUser` can either contain a string value, in case of a successful get or null when the get fails
6517
6593
  *
6518
6594
  * @internal
6519
6595
  * Limited to Microsoft-internal use
6520
6596
  */
6521
6597
  export function getAuthenticationTokenForAnonymousUser(callback: (error: SdkError | null, authenticationTokenOfAnonymousUser: string | null) => void): void;
6522
6598
  /**
6523
- * Allows an app to get the state of the live stream in the current meeting
6599
+ * Allows an app to get the state of the outgoing live stream in the current meeting.
6524
6600
  *
6525
- * @param callback - Callback contains 2 parameters: error and liveStreamState.
6526
- * error can either contain an error of type SdkError, in case of an error, or null when get is successful
6527
- * liveStreamState can either contain a LiveStreamState value, or null when operation fails
6601
+ * @remarks
6602
+ * Use {@link requestStartLiveStreaming} or {@link requestStopLiveStreaming} to start/stop a live stream.
6603
+ * This API can only be used in the `sidePanel` frame context.
6604
+ * The `meetingExtensionDefinition.supportsStreaming` field in your app manifest must be `true` to use this API.
6605
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/meetingExtensionDefinition.
6606
+ *
6607
+ * @param callback - Callback contains 2 parameters: `error` and `liveStreamState`.
6608
+ * `error` can either contain an error of type `SdkError`, in case of an error, or null when the request is successful
6609
+ * `liveStreamState` can either contain a `LiveStreamState` value, or null when operation fails
6528
6610
  */
6529
6611
  export function getLiveStreamState(callback: getLiveStreamStateCallbackFunctionType): void;
6530
6612
  /**
6531
- * Allows an app to request the live streaming be started at the given streaming url
6613
+ * Allows an app to ask the local user to begin live streaming the current meeting to the given Real-Time Messaging Protocol (RTMP) stream url.
6614
+ * A confirmation dialog will be shown to the local user with options to "Allow" or "Cancel" this request.
6532
6615
  *
6533
6616
  * @remarks
6534
- * Use getLiveStreamState or registerLiveStreamChangedHandler to get updates on the live stream state
6617
+ * Meeting content (e.g., user video, screenshare, audio, etc.) can be externally streamed to any platform that supports the popular RTMP standard.
6618
+ * Content broadcasted through RTMP is automatically formatted and cannot be customized.
6619
+ * Use {@link getLiveStreamState} or {@link registerLiveStreamChangedHandler} to get updates on the live stream state.
6620
+ * This API can only be used in the `sidePanel` frame context.
6621
+ * The `meetingExtensionDefinition.supportsStreaming` field in your app manifest must be `true` to use this API.
6622
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/meetingExtensionDefinition.
6535
6623
  *
6536
- * @param streamUrl - the url to the stream resource
6537
- * @param streamKey - the key to the stream resource
6538
- * @param callback - Callback contains error parameter which can be of type SdkError in case of an error, or null when operation is successful
6624
+ * @param callback - completion callback that contains an `error` parameter, which can be of type `SdkError` in case of an error, or null when operation is successful
6625
+ * @param streamUrl - the url to the RTMP stream resource
6626
+ * @param streamKey - the key to the RTMP stream resource
6539
6627
  */
6540
6628
  export function requestStartLiveStreaming(callback: liveStreamErrorCallbackFunctionType, streamUrl: string, streamKey?: string): void;
6541
6629
  /**
6542
- * Allows an app to request the live streaming be stopped at the given streaming url
6630
+ * Allows an app to request that live streaming be stopped.
6543
6631
  *
6544
6632
  * @remarks
6545
- * Use getLiveStreamState or registerLiveStreamChangedHandler to get updates on the live stream state
6633
+ * Use {@link getLiveStreamState} or {@link registerLiveStreamChangedHandler} to get updates on the live stream state.
6634
+ * This API can only be used in the `sidePanel` frame context.
6635
+ * The `meetingExtensionDefinition.supportsStreaming` field in your app manifest must be `true` to use this API.
6636
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/meetingExtensionDefinition.
6546
6637
  *
6547
- * @param callback - Callback contains error parameter which can be of type SdkError in case of an error, or null when operation is successful
6638
+ * @param callback - completion callback that contains an error parameter, which can be of type `SdkError` in case of an error, or null when operation is successful
6548
6639
  */
6549
6640
  export function requestStopLiveStreaming(callback: liveStreamErrorCallbackFunctionType): void;
6550
6641
  /**
6551
- * Registers a handler for changes to the live stream.
6642
+ * Registers an event handler for state changes to the live stream.
6552
6643
  *
6553
6644
  * @remarks
6554
6645
  * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
6646
+ * Use {@link requestStartLiveStreaming} or {@link requestStopLiveStreaming} to start/stop a live stream.
6647
+ * This API can only be used in the `sidePanel` frame context.
6648
+ * The `meetingExtensionDefinition.supportsStreaming` field in your app manifest must be `true` to use this API.
6649
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/meetingExtensionDefinition.
6555
6650
  *
6556
6651
  * @param handler - The handler to invoke when the live stream state changes
6557
6652
  */
6558
6653
  export function registerLiveStreamChangedHandler(handler: registerLiveStreamChangedHandlerFunctionType): void;
6559
6654
  /**
6560
- * Allows an app to share contents in the meeting
6655
+ * Allows an app to share a given URL to the meeting stage for all users in the meeting.
6656
+ * To learn more, visit https://aka.ms/teamsjs/shareAppContentToStage
6561
6657
  *
6562
- * @param callback - Callback contains 2 parameters, error and result.
6563
- * error can either contain an error of type SdkError, incase of an error, or null when share is successful
6564
- * result can either contain a true value, incase of a successful share or null when the share fails
6565
- * @param appContentUrl - is the input URL which needs to be shared on to the stage
6658
+ * @remarks
6659
+ * This API can only be used in the `sidePanel` and `meetingStage` frame contexts.
6660
+ * For private scheduled meetings, meet now, or calls, include the `MeetingStage.Write.Chat` RSC permission in your app manifest.
6661
+ * For channel meetings, include the `ChannelMeetingStage.Write.Group` RSC permission in your app manifest.
6662
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/authorization.
6663
+ * Use {@link getAppContentStageSharingCapabilities} to determine if the local user is eligible to use this API.
6664
+ * Use {@link getAppContentStageSharingState} to determine whether app content is already being shared to the meeting stage.
6665
+ *
6666
+ * @param callback - Callback contains 2 parameters, `error` and `result`.
6667
+ * `error` can either contain an error of type `SdkError`, in case of an error, or null when share is successful
6668
+ * `result` can either contain a true value, in case of a successful share or null when the share fails
6669
+ * @param appContentUrl - is the input URL to be shared to the meeting stage.
6670
+ * the URL origin must be included in your app manifest's `validDomains` field.
6566
6671
  */
6567
6672
  export function shareAppContentToStage(callback: errorCallbackFunctionType, appContentUrl: string): void;
6568
6673
  /**
6569
- * Provides information related app's in-meeting sharing capabilities
6674
+ * Allows an app to request whether the local user's app version has the required app manifest permissions to share content to meeting stage.
6675
+ * To learn more, visit https://aka.ms/teamsjs/getAppContentStageSharingCapabilities
6570
6676
  *
6571
- * @param callback - Callback contains 2 parameters, error and result.
6572
- * error can either contain an error of type SdkError (error indication), or null (non-error indication)
6573
- * appContentStageSharingCapabilities can either contain an IAppContentStageSharingCapabilities object
6574
- * (indication of successful retrieval), or null (indication of failed retrieval)
6677
+ * @remarks
6678
+ * If you are updating your published app to include the share to stage feature, you can use this API to prompt users to update their app if they are using an older version.
6679
+ * Your app's `configurableTabs` or `staticTabs` entry's `context` array must include `meetingStage` for `doesAppHaveSharePermission` to be `true` in the `callback` response.
6680
+ *
6681
+ * @throws error if API is being used outside of `sidePanel` or `meetingStage` frame contexts.
6682
+ * @throws error if your app manifest does not include the `MeetingStage.Write.Chat` RSC permission in your app manifest in a private scheduled meeting, meet now, or call --
6683
+ * or if it does not include the `ChannelMeetingStage.Write.Group` RSC permission in your app manifest in a channel meeting.
6684
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/authorization.
6685
+ *
6686
+ * @param callback - Completion callback contains 2 parameters: `error` and `appContentStageSharingCapabilities`.
6687
+ * `error` can either contain an error of type `SdkError` (error indication), or null (non-error indication).
6688
+ * `appContentStageSharingCapabilities` will contain an {@link IAppContentStageSharingCapabilities} object if the request succeeds, or null if it failed.
6575
6689
  */
6576
6690
  export function getAppContentStageSharingCapabilities(callback: getAppContentCallbackFunctionType): void;
6577
6691
  /**
@@ -6585,18 +6699,32 @@ export namespace meeting {
6585
6699
  */
6586
6700
  export function stopSharingAppContentToStage(callback: errorCallbackFunctionType): void;
6587
6701
  /**
6588
- * Provides information related to current stage sharing state for app
6702
+ * Provides information related to current stage sharing state for your app.
6703
+ * To learn more, visit https://aka.ms/teamsjs/getAppContentStageSharingState
6589
6704
  *
6590
- * @param callback - Callback contains 2 parameters, error and result.
6705
+ * @remarks
6706
+ * This API can only be used in the `sidePanel` and `meetingStage` frame contexts.
6707
+ * For private scheduled meetings, meet now, or calls, include the `MeetingStage.Write.Chat` RSC permission in your app manifest.
6708
+ * For channel meetings, include the `ChannelMeetingStage.Write.Group` RSC permission in your app manifest.
6709
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/authorization.
6710
+ *
6711
+ * @param callback - Callback contains 2 parameters, `error` and `appContentStageSharingState`.
6591
6712
  * error can either contain an error of type SdkError (error indication), or null (non-error indication)
6592
- * appContentStageSharingState can either contain an IAppContentStageSharingState object
6593
- * (indication of successful retrieval), or null (indication of failed retrieval)
6713
+ * `appContentStageSharingState` can either contain an `IAppContentStageSharingState` object if the request succeeds, or null if it failed
6594
6714
  */
6595
6715
  export function getAppContentStageSharingState(callback: getAppContentStageCallbackFunctionType): void;
6596
6716
  /**
6597
- * Registers a handler for changes to paticipant speaking states. This API returns {@link ISpeakingState}, which will have isSpeakingDetected
6598
- * and/or an error object. If any participant is speaking, isSpeakingDetected will be true. If no participants are speaking, isSpeakingDetected
6599
- * will be false. Default value is false. Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
6717
+ * Registers a handler for changes to participant speaking states.
6718
+ * To learn more, visit https://aka.ms/teamsjs/registerSpeakingStateChangeHandler
6719
+ *
6720
+ * @remarks
6721
+ * This API returns {@link ISpeakingState}, which will have `isSpeakingDetected` and/or an error object.
6722
+ * If any participant is speaking, `isSpeakingDetected` will be true, or false if no participants are speaking.
6723
+ * Only one handler can be registered at a time. Subsequent registrations replace existing registrations.
6724
+ * This API can only be used in the `sidePanel` and `meetingStage` frame contexts.
6725
+ * For private scheduled meetings, meet now, or calls, include the `OnlineMeetingIncomingAudio.Detect.Chat` RSC permission in your app manifest.
6726
+ * For channel meetings, include the `OnlineMeetingIncomingAudio.Detect.Group` RSC permission in your app manifest.
6727
+ * Find the app manifest reference at https://aka.ms/teamsAppManifest/authorization.
6600
6728
  *
6601
6729
  * @param handler The handler to invoke when the speaking state of any participant changes (start/stop speaking).
6602
6730
  */
@@ -6636,12 +6764,24 @@ export namespace meeting {
6636
6764
  /**
6637
6765
  * Nested namespace for functions to control behavior of the app share button
6638
6766
  *
6767
+ * @hidden
6768
+ * Hide from docs.
6769
+ *
6770
+ * @internal
6771
+ * Limited to Microsoft-internal use
6772
+ *
6639
6773
  * @beta
6640
6774
  */
6641
6775
  export namespace appShareButton {
6642
6776
  /**
6643
6777
  * Property bag for the setVisibilityInfo
6644
6778
  *
6779
+ * @hidden
6780
+ * Hide from docs.
6781
+ *
6782
+ * @internal
6783
+ * Limited to Microsoft-internal use
6784
+ *
6645
6785
  * @beta
6646
6786
  */
6647
6787
  interface ShareInformation {
@@ -6662,6 +6802,13 @@ export namespace meeting {
6662
6802
  * @throws standard Invalid Url error
6663
6803
  * @param shareInformation has two elements, one isVisible boolean flag and another
6664
6804
  * optional string contentUrl, which will override contentUrl coming from Manifest
6805
+ *
6806
+ * @hidden
6807
+ * Hide from docs.
6808
+ *
6809
+ * @internal
6810
+ * Limited to Microsoft-internal use
6811
+ *
6665
6812
  * @beta
6666
6813
  */
6667
6814
  function setOptions(shareInformation: ShareInformation): void;
@@ -7197,7 +7344,7 @@ export interface ShowProfileRequestInternal {
7197
7344
  * Namespace to video extensibility of the SDK
7198
7345
  * @beta
7199
7346
  */
7200
- export namespace video {
7347
+ export namespace videoEffects {
7201
7348
  /** Notify video frame processed function type */
7202
7349
  type notifyVideoFrameProcessedFunctionType = () => void;
7203
7350
  /** Notify error function type */
@@ -7352,7 +7499,7 @@ export namespace video {
7352
7499
  *
7353
7500
  * @example
7354
7501
  * ```typescript
7355
- * video.registerForVideoFrame({
7502
+ * videoEffects.registerForVideoFrame({
7356
7503
  * videoFrameHandler: async (videoFrameData) => {
7357
7504
  * const originalFrame = videoFrameData.videoFrame as VideoFrame;
7358
7505
  * try {
@@ -7375,7 +7522,7 @@ export namespace video {
7375
7522
  * }
7376
7523
  * },
7377
7524
  * config: {
7378
- * format: video.VideoPixelFormat.NV12,
7525
+ * format: videoEffects.VideoPixelFormat.NV12,
7379
7526
  * }
7380
7527
  * });
7381
7528
  * ```
@@ -8745,7 +8892,7 @@ export namespace marketplace {
8745
8892
  * @hidden
8746
8893
  * Create a MediaStreamTrack from the media stream with the given streamId and processed by videoFrameHandler.
8747
8894
  */
8748
- export function processMediaStream(streamId: string, videoFrameHandler: video.VideoFrameHandler, notifyError: (string: any) => void, videoPerformanceMonitor?: VideoPerformanceMonitor): Promise<void>;
8895
+ export function processMediaStream(streamId: string, videoFrameHandler: videoEffects.VideoFrameHandler, notifyError: (string: any) => void, videoPerformanceMonitor?: VideoPerformanceMonitor): Promise<void>;
8749
8896
  /**
8750
8897
  * @hidden
8751
8898
  * Create a MediaStreamTrack from the media stream with the given streamId and processed by videoFrameHandler.
@@ -8754,7 +8901,7 @@ export function processMediaStream(streamId: string, videoFrameHandler: video.Vi
8754
8901
  * @internal
8755
8902
  * Limited to Microsoft-internal use
8756
8903
  */
8757
- export function processMediaStreamWithMetadata(streamId: string, videoFrameHandler: videoEx.VideoFrameHandler, notifyError: (string: any) => void, videoPerformanceMonitor?: VideoPerformanceMonitor): Promise<void>;
8904
+ export function processMediaStreamWithMetadata(streamId: string, videoFrameHandler: videoEffectsEx.VideoFrameHandler, notifyError: (string: any) => void, videoPerformanceMonitor?: VideoPerformanceMonitor): Promise<void>;
8758
8905
  /**
8759
8906
  * @hidden
8760
8907
  * Video effect change call back function definition