Merge pull request #230841 from pavelprystinka/feture/ui_library_rooms_call

Quickstart UI library Android and iOS Rooms integration

Author: prmerger-automator[bot]

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

@@ -337,16 +337,60 @@ CallCompositeRemoteOptions remoteOptions = new CallCompositeRemoteOptions(
         communicationTokenCredential,                
         "DISPLAY_NAME");
 ```
----
-
----
 
 #### Get a Microsoft Teams meeting link
 
 You can get a Microsoft Teams meeting link by using Graph APIs. This process is detailed in [Graph documentation](/graph/api/onlinemeeting-createorget?preserve-view=true&tabs=http&view=graph-rest-beta).
 
 The Communication Services Call SDK accepts a full Microsoft Teams meeting link. This link is returned as part of the `onlineMeeting` resource, under the [joinWebUrl property](/graph/api/resources/onlinemeeting?preserve-view=true&view=graph-rest-beta). You also can get the required meeting information from the **Join Meeting** URL in the Teams meeting invite itself.
 
+---
+
+### Set up a Rooms call
+
+[!INCLUDE [Public Preview Notice](../../../../includes/public-preview-include.md)]
+
+To set up a ACS Rooms call, initialize a `CallCompositeRoomLocator`, supply it to the `CallCompositeRemoteOptions` object and set `CallCompositeParticipantRole` to the `CallCompositeLocalOptions` by `setRoleHint()`.
+`CallComposite` will use role hint before connecting to the call. Once call is connected, actual up-to-date participant role is retrieved from ACS.
+
+
+For more information about Rooms, how to create and manage one see [Rooms Quickstart](../../../rooms/get-started-rooms.md)
+
+#### [Kotlin](#tab/kotlin)
+
+```kotlin
+val locator = CallCompositeRoomLocator("<ROOM_ID>")
+
+val remoteOptions = CallCompositeRemoteOptions(
+    locator,
+    communicationTokenCredential,            
+    "DISPLAY_NAME",
+)
+
+val localOptions = CallCompositeLocalOptions().setRoleHint(participantRole)
+
+val callComposite = CallCompositeBuilder().build()
+callComposite.launch(context, remoteOptions, localOptions)
+```
+
+#### [Java](#tab/java)
+
+```java
+CallCompositeJoinLocator locator = new CallCompositeRoomLocator("<ROOM_ID>");
+
+CallCompositeRemoteOptions remoteOptions = new CallCompositeRemoteOptions(
+        locator,
+        communicationTokenCredential,                
+        "DISPLAY_NAME");
+
+CallCompositeLocalOptions localOptions = new CallCompositeLocalOptions().setRoleHint(participantRole);
+
+CallComposite callComposite = new CallCompositeBuilder().build();
+callComposite.launch(context, remoteOptions, localOptions);
+```
+
+---
+
 ### Launch the composite
 
 To launch the call UI, inside the `startCallComposite` function, call `launch` on the `CallComposite` instance.

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

@@ -211,6 +211,29 @@ You can get a Microsoft Teams meeting link by using Graph APIs. This process is
 
 The Communication Services Call SDK accepts a full Microsoft Teams meeting link. This link is returned as part of the `onlineMeeting` resource, under the [joinWebUrl property](/graph/api/resources/onlinemeeting?preserve-view=true&view=graph-rest-beta). You also can get the required meeting information from the **Join Meeting** URL in the Teams meeting invite itself.
 
+### Set up a Rooms call
+
+[!INCLUDE [Public Preview Notice](../../../../includes/public-preview-include.md)]
+
+To set up a ACS Rooms call, inside the `startCallComposite` function, initialize a `RemoteOptions` instance for the `.roomCall` locator. Replace `<ROOM_ID>` with the Room ID for your call. Initialize a `LocalOptions` instance with `roleHint`.
+
+Replace `<DISPLAY_NAME>` with your name.
+
+`CallComposite` will use role hint before connecting to the call. Once call is connected, actual up-to-date participant role is retrieved from ACS.
+
+
+For more information about Rooms, how to create and manage one see [Rooms Quickstart](../../../rooms/get-started-rooms.md)
+
+```swift
+let remoteOptions = RemoteOptions(for: .roomCall(roomId: "<ROOM_ID>"),
+                                  credential: communicationTokenCredential,
+                                  displayName: "<DISPLAY_NAME>")
+let localOptions = LocalOptions(roleHint: participantRole)
+
+let callComposite = CallComposite()
+callComposite.launch(remoteOptions: remoteOptions, localOptions: localOptions)
+```
+
 ### Launch the composite
 
 Inside the `startCallComposite` function, call `launch` on the `CallComposite` instance: