Merge pull request #209329 from radubulboaca/master

add call role info & sdk references

Author: liljack17

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-call-android.md

@@ -53,4 +53,28 @@ call.addOnStateChangedListener { args: PropertyChangedEvent? ->
         args!!
     )
 }
+```
+
+To display the role of the local call participant or remote call participants, subscribe to the handler below. Learn more about roles and permissions for room call participants [here](../../../concepts/rooms/room-concept.md#predefined-participant-roles-and-permissions).
+
+```java
+// Get your role in the call
+call.getRole();
+
+// Subscribe to changes for your role in a call
+private void isCallRoleChanged(PropertyChangedEvent propertyChangedEvent) {
+    // handle self-role change
+}
+
+call.addOnRoleChangedListener(isCallRoleChanged);
+
+// Subscribe to role changes for remote participants
+private void isRoleChanged(PropertyChangedEvent propertyChangedEvent) {
+    // handle remote participant role change
+}
+
+remoteParticipant.addOnRoleChangedListener(isRoleChanged);
+
+// Get role of the remote participant
+remoteParticipant.getRole();
 ```

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-call-ios.md

@@ -99,3 +99,17 @@ func setCallAndObserver(call:Call!, error:Error?) {
     }
 }
 ```
+
+To display the role of the local call participant or remote call participants, subscribe to the handler below. Learn more about roles and permissions for room call participants [here](../../../concepts/rooms/room-concept.md#predefined-participant-roles-and-permissions).
+
+```swift
+// Subscribe to changes for your role in a call
+public func call(_ call: Call, didChangeRole args: PropertyChangedEventArgs) {
+    // handle self-role change
+}
+
+// Subscribe to role changes for remote participants
+func remoteParticipant(_ remoteParticipant: RemoteParticipant, didChangeRole args: PropertyChangedEventArgs) {
+    // handle remote participant role change
+}
+```

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-call-web.md

@@ -25,3 +25,21 @@ const context = { roomId: '<RoomId>' }
 const call = callAgent.join(context);
 
 ```
+
+To display the role of the local call participant or remote call participants, subscribe to the handler below. Learn more about roles and permissions for room call participants [here](../../../concepts/rooms/room-concept.md#predefined-participant-roles-and-permissions).
+
+```js
+// Subscribe to changes for your role in a call
+ const callRoleChangedHandler = () => {
+ 	console.log(call.role);
+ };
+
+ call.on('roleChanged', callRoleChangedHandler);
+
+// Subscribe to role changes for remote participants
+ const subscribeToRemoteParticipant = (remoteParticipant) => {
+ 	remoteParticipant.on('roleChanged', () => {
+ 	    console.log(remoteParticipant.role);
+ 	});
+ }
+```

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-java.md

@@ -190,4 +190,8 @@ If you wish to disband an existing `room`, you may issue an explicit delete requ
 
 ```java
 roomsClient.deleteRoomWithResponse(roomId, Context.NONE);
-```
+```
+
+## Reference documentation
+
+Read about the full set of capabilities of Azure Communication Services rooms from the [Java SDK reference](https://docs.microsoft.com/java/api/overview/azure/communication-rooms-readme) or [REST API reference](https://docs.microsoft.com/rest/api/communication/rooms).

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-javascript.md

@@ -161,3 +161,7 @@ If you wish to disband an existing `room`, you may issue an explicit delete requ
 // deletes the specified room
 await roomsClient.deleteRoom(roomId);
 ```
+
+## Reference documentation
+
+Read about the full set of capabilities of Azure Communication Services rooms from the [JavaScript SDK reference](https://docs.microsoft.com/javascript/api/overview/azure/communication-rooms-readme) or [REST API reference](https://docs.microsoft.com/rest/api/communication/rooms).

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-net.md

@@ -145,3 +145,7 @@ If you wish to disband an existing `room`, you may issue an explicit delete requ
 ```csharp
 Response deleteRoomResponse = await roomsClient.DeleteRoomAsync(createdRoomId);
 ```
+
+## Reference documentation
+
+Read about the full set of capabilities of Azure Communication Services rooms from the [.NET SDK reference](https://docs.microsoft.com/dotnet/api/azure.communication.rooms) or [REST API reference](https://docs.microsoft.com/rest/api/communication/rooms).

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-python.md

@@ -164,3 +164,7 @@ If you wish to disband an existing `room`, you may issue an explicit delete requ
 ```python
 self.rooms_client.delete_room(room_id=room)
 ```
+
+## Reference documentation
+
+Read about the full set of capabilities of Azure Communication Services rooms from the [Python SDK reference](https://docs.microsoft.com/python/api/overview/azure/communication-rooms-readme) or [REST API reference](https://docs.microsoft.com/rest/api/communication/rooms).