@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.
- package/dist/MicrosoftTeams.d.ts +221 -74
- package/dist/MicrosoftTeams.js +671 -528
- package/dist/MicrosoftTeams.js.map +1 -1
- package/dist/MicrosoftTeams.min.js +1 -1
- package/dist/MicrosoftTeams.min.js.map +1 -1
- package/package.json +1 -1
package/dist/MicrosoftTeams.d.ts
CHANGED
@@ -2025,7 +2025,7 @@ export namespace teams {
|
|
2025
2025
|
* @internal
|
2026
2026
|
* Limited to Microsoft-internal use
|
2027
2027
|
*/
|
2028
|
-
export namespace
|
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
|
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
|
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 =
|
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<
|
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:
|
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
|
-
/**
|
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
|
-
*
|
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
|
-
*
|
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
|
-
/**
|
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
|
-
/**
|
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
|
-
/**
|
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
|
-
/**
|
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
|
-
/**
|
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
|
-
/**
|
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
|
-
/**
|
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
|
-
/**
|
6521
|
+
/**
|
6522
|
+
* Represents the type of a call.
|
6523
|
+
*
|
6524
|
+
* @hidden
|
6525
|
+
* Hide from docs.
|
6526
|
+
*/
|
6473
6527
|
export enum CallType {
|
6474
|
-
/**
|
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
|
-
/**
|
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
|
-
* @
|
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
|
-
*
|
6485
|
-
*
|
6486
|
-
* result
|
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
|
-
* @
|
6493
|
-
*
|
6494
|
-
*
|
6495
|
-
*
|
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
|
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
|
6516
|
-
* authenticationTokenOfAnonymousUser can either contain a string value,
|
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
|
-
* @
|
6526
|
-
*
|
6527
|
-
*
|
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
|
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
|
-
*
|
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
|
6537
|
-
* @param
|
6538
|
-
* @param
|
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
|
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 -
|
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
|
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
|
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
|
-
* @
|
6563
|
-
*
|
6564
|
-
*
|
6565
|
-
*
|
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
|
-
*
|
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
|
-
* @
|
6572
|
-
*
|
6573
|
-
*
|
6574
|
-
*
|
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
|
-
* @
|
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
|
6598
|
-
*
|
6599
|
-
*
|
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
|
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
|
-
*
|
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:
|
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:
|
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:
|
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
|