Merge pull request #286585 from pavelprystinka/pavelprystinka/custom_buttons_updatable

Update custom buttons API

Author: denrea

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

@@ -10,14 +10,13 @@ ms.service: azure-communication-services
 
 ## Remove buttons
 
-`CallCompositeCallScreenControlBarOptions`, allow the flexibility to customize the button bar by removing specific buttons such as camera, microphone, and audio controls. This API allows you to tailor the user interface according to their specific application requirements and user experience design. Just set the visibility to `false` to hide, the default behavior is  for `CallCompositeButtonOptions` object.
+`CallCompositeCallScreenControlBarOptions`, allow the flexibility to customize the button bar by removing specific buttons such as camera, microphone, and audio controls. This API allows you to tailor the user interface according to their specific application requirements and user experience design. Just set the `visible` or `enabled` to `false` for the `CallCompositeButtonViewData` to hide or disable button.
 
 #### [Kotlin](#tab/kotlin)
-
 ```kotlin
 val controlBarOptions = CallCompositeCallScreenControlBarOptions()
 
-val cameraButton = CallCompositeButtonOptions()
+val cameraButton = CallCompositeButtonViewData()
     .setVisible(false)
 
 controlBarOptions.setCameraButton(cameraButton)
@@ -38,7 +37,7 @@ callComposite.launch(context, locator, localOptions)
 ```java
 CallCompositeCallScreenControlBarOptions controlBarOptions = new CallCompositeCallScreenControlBarOptions();
 
-CallCompositeButtonOptions cameraButton = new CallCompositeButtonOptions()
+CallCompositeButtonOptions cameraButton = new CallCompositeButtonViewData()
         .setVisible(false);
 
 controlBarOptions.setCameraButton(cameraButton);
@@ -54,6 +53,18 @@ CallComposite callComposite = new CallCompositeBuilder()
 
 callComposite.launch(context, locator, localOptions);
 ```
+-----
+Button can be updated after launching call composite.
+
+#### [Kotlin](#tab/kotlin)
+```kotlin
+cameraButton.setVisible(true)
+```
+
+#### [Java](#tab/java)
+```java
+cameraButton.setVisible(true);
+```
 
 -----
 
@@ -62,13 +73,13 @@ callComposite.launch(context, locator, localOptions);
 `Call composite` is using Fluent UI icons. You can download the icons directly from [the Fluent UI GitHub repository](https://github.com/microsoft/fluentui-system-icons/) and incorporate them into your project as needed. This approach guarantees visual consistency across all user interface elements, enhancing the overall user experience.
 
 #### [Kotlin](#tab/kotlin)
-
 ```kotlin
 val controlBarOptions = CallCompositeCallScreenControlBarOptions()
 
 controlBarOptions.setCustomButtons(
     listOf(
-        CallCompositeCustomButtonOptions(
+        CallCompositeCustomButtonViewData(
+            "customButtonId",
             R.drawable.my_button_image,
             "My button",
             fun(it: CallCompositeCustomButtonClickEvent) {
@@ -96,7 +107,8 @@ CallCompositeCallScreenControlBarOptions controlBarOptions = new CallCompositeCa
 
 List<CallCompositeCustomButtonOptions> customButtons = new ArrayList<>();
 customButtons.add(
-        new CallCompositeCustomButtonOptions(
+        new CallCompositeCustomButtonViewData(
+                "customButtonId",
                 R.drawable.my_button_image,
                 "My button",
                 eventArgs -> {
@@ -120,3 +132,18 @@ callComposite.launch(context, locator, localOptions);
 ```
 
 -----
+
+Similar to `Call composite` provided buttons, custom buttons are updatable after the launch.
+
+
+
+#### [Kotlin](#tab/kotlin)
+
+```kotlin
+customButton.setVisible(true)
+```
+
+#### [Java](#tab/java)
+```java
+customButton.setVisible(true);
+```

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

@@ -9,12 +9,12 @@ ms.service: azure-communication-services
 ---
 
 
-## Remove buttons
+## Remove or disable buttons
 
-`CallScreenControlBarOptions`, allow the flexibility to customize the button bar by removing specific buttons such as camera, microphone, and audio controls. This API allows you to tailor the user interface according to their specific application requirements and user experience design. Just set the visibility to `false` to hide, the default behavior is  for `ButtonOptions` object.
+`CallScreenControlBarOptions`, allow the flexibility to customize the button bar by removing specific buttons such as camera, microphone, and audio controls. This API allows you to tailor the user interface according to their specific application requirements and user experience design. Just set the `visible` or `enabled` to `false` for the `ButtonViewData` to hide or disable button.
 
 ```swift
-let cameraButton = ButtonOptions(visible: false)
+let cameraButton = ButtonViewData(visible: false)
 
 let callScreenControlBarOptions = CallScreenControlBarOptions(
     cameraButton: cameraButton
@@ -27,6 +27,13 @@ let callComposite = CallComposite(credential: credential)
 callComposite.launch(locator: .roomCall(roomId: "..."), localOptions: localOptions)
 ```
 
+Button can be updated after launching call composite.
+
+```swift
+cameraButton.visible = true
+```
+
+
 ## Add custom actions
 
 `Call composite` is using Fluent UI icons. You can download the icons directly from [the Fluent UI GitHub repository](https://github.com/microsoft/fluentui-system-icons/) and incorporate them into your project as needed. This approach guarantees visual consistency across all user interface elements, enhancing the overall user experience.
@@ -47,3 +54,9 @@ let localOptions = LocalOptions(callScreenOptions: callScreenOptions)
 let callComposite = CallComposite(credential: credential)
 callComposite.launch(locator: .roomCall(roomId: "..."), localOptions: localOptions)
 ```
+
+Similar to `Call composite` provided buttons, custom buttons are updatable after the launch.
+
+```swift
+customButton.enabled = true
+```