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

package/dist/MicrosoftTeams.d.ts

@@ -1989,6 +1989,166 @@ export namespace teams {
         }
 }
 
+/**
+    * @hidden
+    * Extended video API
+    * @beta
+    *
+    * @internal
+    * Limited to Microsoft-internal use
+    */
+export namespace videoEx {
+        /**
+            * @hidden
+            * Video frame configuration supplied to the host to customize the generated video frame parameters
+            * @beta
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        interface VideoFrameConfig extends video.VideoFrameConfig {
+                /**
+                    * @hidden
+                    * Flag to indicate use camera stream to synthesize video frame or not.
+                    * Default value is true.
+                    * @beta
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    */
+                requireCameraStream?: boolean;
+                /**
+                    * @hidden
+                    * Machine learning model to run in the host to do audio inference for you
+                    * @beta
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    */
+                audioInferenceModel?: ArrayBuffer;
+        }
+        /**
+            * @hidden
+            * Represents a video frame
+            * @beta
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        interface VideoFrame extends video.VideoFrame {
+                /**
+                    * @hidden
+                    * The model output if you passed in an {@linkcode VideoFrameConfig.audioInferenceModel}
+                    * @beta
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    */
+                audioInferenceResult?: Uint8Array;
+        }
+        /**
+            * @hidden
+            * Video frame call back function
+            * @beta
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        type VideoFrameCallback = (frame: VideoFrame, notifyVideoFrameProcessed: () => void, notifyError: (errorMessage: string) => void) => void;
+        /**
+            * @hidden
+            * Register to process video frames
+            * @beta
+            *
+            * @param frameCallback - The callback to invoke when registerForVideoFrame has completed
+            * @param config - VideoFrameConfig to customize generated video frame parameters
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function registerForVideoFrame(frameCallback: VideoFrameCallback, config: VideoFrameConfig): void;
+        /**
+            * @hidden
+            * Video extension should call this to notify host that the current selected effect parameter changed.
+            * If it's pre-meeting, host will call videoEffectCallback immediately then use the videoEffect.
+            * If it's the in-meeting scenario, we will call videoEffectCallback when apply button clicked.
+            * @beta
+            * @param effectChangeType - the effect change type.
+            * @param effectId - Newly selected effect id. {@linkcode VideoEffectCallBack}
+            * @param effectParam Variant for the newly selected effect. {@linkcode VideoEffectCallBack}
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function notifySelectedVideoEffectChanged(effectChangeType: video.EffectChangeType, effectId: string | undefined, effectParam?: string): void;
+        /**
+            * @hidden
+            * Video effect change call back function definition
+            * @beta
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        type VideoEffectCallBack = (effectId: string | undefined, effectParam?: string) => void;
+        /**
+            * @hidden
+            * Register the video effect callback, host uses this to notify the video extension the new video effect will by applied
+            * @beta
+            * @param callback - The VideoEffectCallback to invoke when registerForVideoEffect has completed
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function registerForVideoEffect(callback: VideoEffectCallBack): void;
+        /**
+            * @hidden
+            * Personalized video effect
+            * @beta
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        interface PersonalizedEffect {
+                /**
+                    * Personalized effect id
+                    */
+                id: string;
+                /**
+                    * Display name
+                    */
+                name: string;
+                /**
+                    * Effect type defined by app
+                    */
+                type: string;
+                /**
+                    * Data URI of the thumbnail image content encoded in ASCII format using the base64 scheme
+                    */
+                thumbnail: string;
+        }
+        /**
+            * @hidden
+            * Send personalized effects to Teams client
+            * @beta
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function updatePersonalizedEffects(effects: PersonalizedEffect[]): void;
+        /**
+            * @hidden
+            * Checks if video capability is supported by the host
+            * @beta
+            *
+            * @returns true if the video capability is enabled in runtime.supports.video and
+            * false if it is disabled
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            */
+        function isSupported(): boolean;
+}
+
 /**
     * Namespace to interact with the authentication-specific part of the SDK.
     *
@@ -4136,6 +4296,17 @@ export namespace pages {
             * Limited to Microsoft-internal use
             */
         function registerFocusEnterHandler(handler: (navigateForward: boolean) => void): void;
+        /**
+            * @hidden
+            * Undocumented helper function with shared code between deprecated version and current version of the registerFocusEnterHandler API.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
+            * @param handler - The handler for placing focus within the application.
+            * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+            */
+        function registerFocusEnterHandlerHelper(handler: (navigateForward: boolean) => void, versionSpecificHelper?: () => void): void;
         /**
             * Sets/Updates the current frame with new information
             *
@@ -4216,6 +4387,17 @@ export namespace pages {
             * @param handler - The handler to invoke when the user toggles full-screen view for a tab.
             */
         function registerFullScreenHandler(handler: (isFullScreen: boolean) => void): void;
+        /**
+            * @hidden
+            * Undocumented helper function with shared code between deprecated version and current version of the registerFullScreenHandler API.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
+            * @param handler - The handler to invoke when the user toggles full-screen view for a tab.
+            * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+            */
+        function registerFullScreenHandlerHelper(handler: (isFullScreen: boolean) => void, versionSpecificHelper?: () => void): void;
         /**
             * Checks if the pages capability is supported by the host
             * @returns true if the pages capability is enabled in runtime.supports.pages and
@@ -4314,6 +4496,17 @@ export namespace pages {
                     * @param handler - The handler to invoke when the user selects the Save button.
                     */
                 function registerOnSaveHandler(handler: (evt: SaveEvent) => void): void;
+                /**
+                    * @hidden
+                    * Undocumented helper function with shared code between deprecated version and current version of the registerOnSaveHandler API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    *
+                    * @param handler - The handler to invoke when the user selects the Save button.
+                    * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+                    */
+                function registerOnSaveHandlerHelper(handler: (evt: SaveEvent) => void, versionSpecificHelper?: () => void): void;
                 /**
                     * Registers a handler for user attempts to remove content. This handler should be used
                     * to remove the underlying resource powering the content.
@@ -4322,11 +4515,33 @@ export namespace pages {
                     * @param handler - The handler to invoke when the user selects the Remove button.
                     */
                 function registerOnRemoveHandler(handler: (evt: RemoveEvent) => void): void;
+                /**
+                    * @hidden
+                    * Undocumented helper function with shared code between deprecated version and current version of the registerOnRemoveHandler API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    *
+                    * @param handler - The handler to invoke when the user selects the Remove button.
+                    * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+                    */
+                function registerOnRemoveHandlerHelper(handler: (evt: RemoveEvent) => void, versionSpecificHelper?: () => void): void;
                 /**
                     * Registers a handler for when the tab configuration is changed by the user
                     * @param handler - The handler to invoke when the user clicks on Settings.
                     */
                 function registerChangeConfigHandler(handler: () => void): void;
+                /**
+                    * @hidden
+                    * Undocumented helper function with shared code between deprecated version and current version of the registerConfigChangeHandler API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    *
+                    * @param handler - The handler to invoke when the user clicks on Settings.
+                    * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+                    */
+                function registerChangeConfigHandlerHelper(handler: () => void, versionSpecificHelper?: () => void): void;
                 /**
                     * Describes the results of the settings.save event. Includes result, notifySuccess, and notifyFailure
                     * to indicate the return object (result) and the status of whether the settings.save call succeeded or not and why.
@@ -4395,6 +4610,17 @@ export namespace pages {
                     * @param handler - The handler to invoke when the user presses the host client's back button.
                     */
                 function registerBackButtonHandler(handler: () => boolean): void;
+                /**
+                    * @hidden
+                    * Undocumented helper function with shared code between deprecated version and current version of the registerBackButtonHandler API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    *
+                    * @param handler - The handler to invoke when the user presses the host client's back button.
+                    * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+                    */
+                function registerBackButtonHandlerHelper(handler: () => boolean, versionSpecificHelper?: () => void): void;
                 /**
                     * Checks if the pages.backStack capability is supported by the host
                     * @returns true if the pages.backStack capability is enabled in runtime.supports.pages.backStack and
@@ -4443,18 +4669,51 @@ export namespace pages {
                     * @param handler - The handler to invoke when the personal app button is clicked in the app bar.
                     */
                 function onClick(handler: () => void): void;
+                /**
+                    * @hidden
+                    * Undocumented helper function with shared code between deprecated version and current version of the onClick API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    *
+                    * @param handler - The handler to invoke when the personal app button is clicked in the app bar.
+                    * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+                    */
+                function onClickHelper(handler: () => void, versionSpecificHelper?: () => void): void;
                 /**
                     * Registers a handler for entering hover of the app button.
                     * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
                     * @param handler - The handler to invoke when entering hover of the personal app button in the app bar.
                     */
                 function onHoverEnter(handler: () => void): void;
+                /**
+                    * @hidden
+                    * Undocumented helper function with shared code between deprecated version and current version of the onHoverEnter API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    *
+                    * @param handler - The handler to invoke when entering hover of the personal app button in the app bar.
+                    * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+                    */
+                function onHoverEnterHelper(handler: () => void, versionSpecificHelper?: () => void): void;
                 /**
                     * Registers a handler for exiting hover of the app button.
                     * Only one handler can be registered at a time. A subsequent registration replaces an existing registration.
                     * @param handler - The handler to invoke when exiting hover of the personal app button in the app bar.
                     */
                 function onHoverLeave(handler: () => void): void;
+                /**
+                    * @hidden
+                    * Undocumented helper function with shared code between deprecated version and current version of the onHoverLeave API.
+                    *
+                    * @internal
+                    * Limited to Microsoft-internal use
+                    *
+                    * @param handler - The handler to invoke when existing hover of the personal app button in the app bar.
+                    * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+                    */
+                function onHoverLeaveHelper(handler: () => void, versionSpecificHelper?: () => void): void;
                 /**
                     * Checks if pages.appButton capability is supported by the host
                     * @returns true if the pages.appButton capability is enabled in runtime.supports.pages.appButton and
@@ -5606,6 +5865,17 @@ export namespace teamsCore {
             * @internal
             */
         function registerOnLoadHandler(handler: (context: LoadContext) => void): void;
+        /**
+            * @hidden
+            * Undocumented helper function with shared code between deprecated version and current version of the registerOnLoadHandler API.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
+            * @param handler - The handler to invoke when the page is loaded.
+            * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+            */
+        function registerOnLoadHandlerHelper(handler: (context: LoadContext) => void, versionSpecificHelper?: () => void): void;
         /**
             * @hidden
             * Registers a handler to be called before the page is unloaded.
@@ -5616,6 +5886,18 @@ export namespace teamsCore {
             * @internal
             */
         function registerBeforeUnloadHandler(handler: (readyToUnload: () => void) => boolean): void;
+        /**
+            * @hidden
+            * Undocumented helper function with shared code between deprecated version and current version of the registerBeforeUnloadHandler API.
+            *
+            * @internal
+            * Limited to Microsoft-internal use
+            *
+            * @param handler - - The handler to invoke before the page is unloaded. If this handler returns true the page should
+            * invoke the readyToUnload function provided to it once it's ready to be unloaded.
+            * @param versionSpecificHelper - The helper function containing logic pertaining to a specific version of the API.
+            */
+        function registerBeforeUnloadHandlerHelper(handler: (readyToUnload: () => void) => boolean, versionSpecificHelper?: () => void): void;
         /**
             * Checks if teamsCore capability is supported by the host
             * @returns true if the teamsCore capability is enabled in runtime.supports.teamsCore and
@@ -5841,11 +6123,11 @@ export namespace video {
             */
         enum EffectChangeType {
                 /**
-                    * current video effect changed
+                    * Current video effect changed
                     */
                 EffectChanged = 0,
                 /**
-                    * disable the video effect
+                    * Disable the video effect
                     */
                 EffectDisabled = 1
         }
@@ -5867,8 +6149,8 @@ export namespace video {
             */
         function registerForVideoFrame(frameCallback: VideoFrameCallback, config: VideoFrameConfig): void;
         /**
-            * Video extension should call this to notify host client that the current selected effect parameter changed.
-            * If it's pre-meeting, host client will call videoEffectCallback immediately then use the videoEffect.
+            * Video extension should call this to notify host that the current selected effect parameter changed.
+            * If it's pre-meeting, host will call videoEffectCallback immediately then use the videoEffect.
             * If it's the in-meeting scenario, we will call videoEffectCallback when apply button clicked.
             * @beta
             * @param effectChangeType - the effect change type.
@@ -5876,7 +6158,7 @@ export namespace video {
             */
         function notifySelectedVideoEffectChanged(effectChangeType: EffectChangeType, effectId: string | undefined): void;
         /**
-            * Register the video effect callback, host client uses this to notify the video extension the new video effect will by applied
+            * Register the video effect callback, host uses this to notify the video extension the new video effect will by applied
             * @beta
             * @param callback - The VideoEffectCallback to invoke when registerForVideoEffect has completed
             */