Merge pull request #266966 from pavelprystinka/pavelprystinka/acs_ui_mobile_pip_ga

Update ACS mobile PiP how-to

Author: JamesJBarnett

articles/communication-services/how-tos/ui-library-sdk/includes/pip/android.md

@@ -12,7 +12,7 @@ For more information, see the [open-source Android UI Library](https://github.co
 
 ### Picture-in-picture setup
 
-To enable multitasking and picture-in-picture, use `CallCompositeBuilder.multitasking` to set `CallCompositeMultitaskingOptions` with  `enableMultitasking` and `enableSystemPiPWhenMultitasking` constructor parameters.
+To enable multitasking and picture-in-picture, use `CallCompositeBuilder.multitasking` to set `CallCompositeMultitaskingOptions` with  `enableMultitasking` and `enableSystemPictureInPictureWhenMultitasking` constructor parameters.
 
 #### [Kotlin](#tab/kotlin)
 
@@ -38,33 +38,37 @@ The **Back** button appears when `enableMultitasking` is set to `true`.
 
 :::image type="content" source="media/android-call-screen.png" alt-text="Screenshot of the Android call screen with the Back button visible.":::
 
-When you turn on multitasking for `CallComposite`, the call activity starts in a dedicated task. In the task history, the user sees two screens: one for the app's activity and one for Communication Services call activity.
+When user taps back button Calling UI is hidden and, if configured, Picture-in-Picture view is displayed.
 
-#### [Kotlin](#tab/kotlin)
+When multitasking is ON for `CallComposite`, the call activity starts in a dedicated task. In the task history, the user sees two screens: one for the app's activity and one for Communication Services call activity.
+
+
+-----
+
+To enter multitasking programmatically and if configured display Picture-in-Picture, call the `sendToBackground` method.
 
+#### [Kotlin](#tab/kotlin)
 ```kotlin
-callComposite.displayCallCompositeIfWasHidden(context)
+callComposite.sendToBackground()
 ```
 
 #### [Java](#tab/java)
 
 ```java
-callComposite.displayCallCompositeIfWasHidden(context);
+callComposite.sendToBackground();
 ```
-
 -----
 
-To enter multitasking programmatically, call the `hide` method.
+To bring user back to the calling activity programmatically use `bringToForeground` function:
 
 #### [Kotlin](#tab/kotlin)
+
 ```kotlin
-callComposite.hide()
+callComposite.bringToForeground(context)
 ```
 
 #### [Java](#tab/java)
 
 ```java
-callComposite.hide();
+callComposite.bringToForeground(context);
 ```
-
------

articles/communication-services/how-tos/ui-library-sdk/includes/pip/ios.md

@@ -20,7 +20,7 @@ To enable multitasking and picture-in-picture, use the `CallCompositeOptions` co
 ```swift
 let callCompositeOptions = CallCompositeOptions(
             enableMultitasking: true,
-            enableSystemPiPWhenMultitasking: true)
+            enableSystemPictureInPictureWhenMultitasking: true)
 
 let callComposite = CallComposite(withOptions: callCompositeOptions)
 ```
@@ -29,14 +29,22 @@ The **Back** button appears when `enableMultitasking` is set to `true`.
 
 :::image type="content" source="media/ios-call-screen.png" alt-text="Screenshot of the iOS call screen with the Back button visible.":::
 
-To open the call UI, the user opens a call activity programmatically or by selecting the notification on the top bar. To reopen the UI programmatically, the app needs to preserve a reference to `CallComposite` and execute the `displayCallCompositeIfWasHidden` method.
+
+When user taps back button Calling UI is hidden and, if configured, Picture-in-Picture view is displayed.
+
+
+-----
+
+To enter or exit multitasking programmatically, use `isHidden` property:
+
 
 ```swift
-callComposite.displayCallCompositeIfWasHidden(context)
+// Close calling UI and display PiP
+callComposite.isHidden = true
 ```
 
-To enter multitasking programmatically, call the `hide` method.
-
 ```swift
-callComposite.hide()
+// Displaye calling UI and close PiP
+callComposite.isHidden = false
 ```
+

articles/communication-services/how-tos/ui-library-sdk/picture-in-picture.md

@@ -22,7 +22,6 @@ While a user is on a call, a full-screen UI can prevent the user from multitaski
 
 This article shows you how to turn on picture-in-picture in the Azure Communication Services UI Library. The picture-in-picture feature is system provided and is subject to feature support on the device, including CPU load, RAM availability, and battery state.
 
-[!INCLUDE [Public Preview Notice](../../includes/public-preview-include.md)]
 
 ## Prerequisites
 

articles/communication-services/quickstarts/ui-library/includes/get-started-call/ios.md

@@ -48,7 +48,7 @@ In Xcode, create a new project:
 
     target 'UILibraryQuickStart' do
         use_frameworks!
-        pod 'AzureCommunicationUICalling', '1.2.0'
+        pod 'AzureCommunicationUICalling', '1.6.0'
     end
     ```