Merge pull request #235326 from minnieliu/peiliu/updateNetRoomsQuickstart

Update the Rooms Quickstart for .Net SDK

Author: Court72

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

@@ -2,15 +2,15 @@
 title: include file
 description: include file
 services: azure-communication-services
-author: radubulboaca
-manager: mariusu
+author: peiliu
+manager: alexokun
 
 ms.service: azure-communication-services
 ms.subservice: azure-communication-services
-ms.date: 09/08/2022
+ms.date: 04/20/2023
 ms.topic: include
 ms.custom: include file
-ms.author: antonsamson
+ms.author: peiliu
 ---
 
 ## Prerequisites
@@ -48,7 +48,7 @@ Install the Azure Communication Rooms client library for .NET with [NuGet][https
 dotnet add package Azure.Communication.Identity
 dotnet add package Azure.Communication.Rooms
 ```
-You'll need to use the Azure Communication Rooms client library for .NET [version 1.0.0-beta.1](https://www.nuget.org/packages/Azure.Communication.Rooms/1.0.0-beta.1) or above. 
+You'll need to use the Azure Communication Rooms client library for .NET [version 1.0.0-beta.2](https://www.nuget.org/packages/Azure.Communication.Rooms/1.0.0-beta.2) or above.
 
 ### Set up the app framework
 
@@ -86,11 +86,11 @@ Create a new `RoomsClient` object that will be used to create new `rooms` and ma
 var connectionString = "<connection_string>";
 RoomsClient roomsClient = new RoomsClient(connectionString);
 
-// create identities for users
-var client = new CommunicationIdentityClient(connectionString);
-var user1 = await client.CreateUserAndTokenAsync(scopes: new[] { CommunicationTokenScope.VoIP });
-var user2 = await client.CreateUserAndTokenAsync(scopes: new[] { CommunicationTokenScope.VoIP });
- 
+// Create identities for users
+CommunicationIdentityClient identityClient = new CommunicationIdentityClient(connectionString);
+CommunicationUserIdentifier user1 = await identityClient.CreateUser();
+CommunicationUserIdentifier user2 = await identityClient.CreateUser();
+
 ```
 
 ## Create a room
@@ -99,11 +99,24 @@ Create a new `room` with default properties using the code snippet below:
 
 ```csharp
 
-//Create a room
+// Create a room
 List roomParticipants = new List<RoomParticipant>();
 roomParticipants.Add(new RoomParticipant(new CommunicationUserIdentifier(user1.Value.User.Id), RoleType.Presenter));
 
-CommunicationRoom createdRoom = await RoomCollection.CreateRoomAsync(validFrom, validUntil, RoomJoinPolicy.InviteOnly, roomParticipants, cancellationToken);
+
+RoomParticipant participant1 = new RoomParticipant(user1) { Role = ParticipantRole.Presenter };
+RoomParticipant participant2 = new RoomParticipant(user2) { Role = ParticipantRole.Attendee };
+
+List<RoomParticipant> participants = new List<RoomParticipant>();
+
+participants.Add(participant1);
+participants.Add(participant2);
+
+DateTimeOffset validFrom = DateTimeOffset.UtcNow;
+DateTimeOffset validUntil = validFrom.AddDays(1);
+CancellationToken cancellationToken = new CancellationTokenSource().Token;
+
+CommunicationRoom createdRoom = await roomsClient.CreateRoomAsync(validFrom, validUntil, roomParticipants, cancellationToken);
 string roomId = createdRoom.Id;
 Console.WriteLine("\nCreated room with id: " + roomId);
 
@@ -118,8 +131,8 @@ Retrieve the details of an existing `room` by referencing the `roomId`:
 ```csharp
 
 // Retrieve the room with corresponding ID
-CommunicationRoom getRoomResponse = await roomsClient.GetRoomAsync(roomId);
-Console.WriteLine("\Retrieved room with id: " + getRoomResponse.Id);
+CommunicationRoom room = await roomsClient.GetRoomAsync(roomId);
+Console.WriteLine("\Retrieved room with id: " + room.Id);
 
 ```
 
@@ -129,30 +142,53 @@ The lifetime of a `room` can be modified by issuing an update request for the `V
 
 ```csharp
 
-//Update room lifetime
-DateTimeOffset  validFrom = new DateTime(2022, 05, 01, 00, 00, 00, DateTimeKind.Utc);
-DateTimeOffset  validUntil = validFrom.AddDays(1);
-
-CommunicationRoom updatedRoom = await RoomCollection.UpdateRoomAsync(roomId, validFrom, validUntil, RoomJoinPolicy.InviteOnly, null, cancellationToken);
+// Update room lifetime
+DateTimeOffset validFrom = DateTimeOffset.UtcNow;
+DateTimeOffset validUntil = DateTimeOffset.UtcNow.AddDays(10);
+CommunicationRoom updatedRoom = await roomsClient.UpdateRoomAsync(roomId, validFrom, validUntil, cancellationToken);
 Console.WriteLine("\nUpdated room with validFrom: " + updatedRoom.ValidFrom + " and validUntil: " + updatedRoom.ValidUntil);
+```
+
+### List all active rooms
+
+To retrieve all active rooms, use the `GetRoomsAsync` method exposed on the client.
+
+```csharp
+
+// List all active rooms
+AsyncPageable<CommunicationRoom> allRooms = await roomsClient.GetRoomsAsync();
+await foreach (CommunicationRoom room in allRooms)
+{
+    if (room is not null)
+    {
+        Console.WriteLine("\nFirst room id in all active rooms: " + room.Id);
+        break;
+    }
+}
 
 ```
 
-## Add new participants
+### Add new participants or update existing participants
 
 To add new participants to a `room`, use the `AddParticipantsAsync` method exposed on the client.
 
 ```csharp
 
-// Add participants
 List<RoomParticipant> participants = new List<RoomParticipant>();
-participants.Add(new RoomParticipant(new CommunicationUserIdentifier(user2.Value.User.Id), RoleType.Attendee));
+// Update participant2 from Attendee to Consumer
+RoomParticipant participant2 = new RoomParticipant(user2) { Role = ParticipantRole.Consumer };
+// Add participant3
+CommunicationUserIdentifier user3 = await identityClient.CreateUser();
+RoomParticipant participant3 = new RoomParticipant(user3) { Role = ParticipantRole.Attendee };
+participants.Add(participant2);
+participants.Add(participant3);
+
+Response addOrUpdateParticipantsResponse = await roomsClient.AddOrUpdateParticipantsAsync(roomId, participants);
+Console.WriteLine("\nAdded or updated participants to room");
 
-var addParticipantsResult = await RoomCollection.AddParticipantsAsync(roomId, participants);
-Console.writeLine("\nAdded participants to room");
 ```
 
-Participants that have been added to a `room` become eligible to join calls.
+Participants that have been added to a `room` become eligible to join calls. Participants that have been updated will see their new `role` in the call.
 
 ## Get list of participants
 
@@ -161,8 +197,12 @@ Retrieve the list of participants for an existing `room` by referencing the `roo
 ```csharp
 
 // Get list of participants in room
-ParticipantsCollection existingParticipants = await RoomCollection.GetParticipantsAsync(roomId);
-Console.writeLine("\nRetrieved participants for room: ", existingParticipants);
+AsyncPageable<RoomParticipant> existingParticipants = await roomsClient.GetParticipantsAsync(roomId);
+Console.WriteLine("\nRetrieved participants from room: ");
+await foreach (RoomParticipant participant in existingParticipants)
+{
+    Console.WriteLine($"{participant.CommunicationIdentifier.ToString()},  {participant.Role.ToString()}");
+}
 
 ```
 
@@ -171,14 +211,12 @@ Console.writeLine("\nRetrieved participants for room: ", existingParticipants);
 To remove a participant from a `room` and revoke their access, use the `RemoveParticipantsAsync` method.
 
 ```csharp
-// Remove user from room
-var communicationUser = user2.Value.User.Id;
 
+// Remove user from room
 List<CommunicationIdentifier> participants = new List<CommunicationIdentifier>();
-participants.Add(new CommunicationUserIdentifier(communicationUser));
+participants.Add(user2);
 
-var removeParticipantsResult = await RoomCollection.RemoveParticipantsAsync(roomId, participants);
-await roomsClient.removeParticipants(roomId, removeParticipantsList);
+Response removeParticipantsResponse = await roomsClient.RemoveParticipantsAsync(roomId, participants);
 Console.WriteLine("\nRemoved participants from room");
 
 ```
@@ -189,14 +227,13 @@ If you wish to disband an existing `room`, you may issue an explicit delete requ
 ```csharp
 
 // Deletes the specified room
-Response deleteRoomResponse = await RoomCollection.DeleteRoomAsync(createdRoomId);
-Console.WriteLine("\nDeleted room with id: " + createdRoomId);
-
+Response deleteRoomResponse = await RoomCollection.DeleteRoomAsync(roomId);
+Console.WriteLine("\nDeleted room with id:" + roomId);
 ```
 
 ## Run the code
 
-To run the code, make sure you are on the directory where your `Program.cs` file is. 
+To run the code, make sure you are on the directory where your `Program.cs` file is.
 
 ```console
 
@@ -210,37 +247,27 @@ The expected output describes each completed action:
 
 Azure Communication Services - Rooms Quickstart
 
-Created a room with id:  99445276259151407
+Created a room with id: 99445276259151407
+
+Retrieved room with id: 99445276259151407
 
-Retrieved room with id:  99445276259151407
+Updated room with validFrom: 2023-05-11T22:11:46.784Z and validUntil: 2023-05-21T22:16:46.784Z
 
-Updated room with validFrom:  2023-05-11T22:11:46.784Z  and validUntil:  2023-05-11T22:16:46.784Z
+First room id in all active rooms: 99445276259151407
 
-Added participants to room
+Added or updated participants to room
 
-Retrieved participants for room:  [
-  {
-    id: {
-      kind: 'communicationUser',
-      communicationUserId: '8:acs:b6aada1f-0b1d-47ac-866f-91aae00a1d01_00000018-ac89-7c76-35f3-343a0d00e901'
-    },
-    role: 'Attendee'
-  },
-  {
-    id: {
-      kind: 'communicationUser',
-      communicationUserId: '8:acs:b6aada1f-0b1d-47ac-866f-91aae00a1d01_00000018-ac89-7ccc-35f3-343a0d00e902'
-    },
-    role: 'Consumer'
-  }
-]
+Retrieved participants from room:
+8:acs:b6aada1f-0b1d-47ac-866f-91aae00a1d01_00000018-ac89-7c76-35f3-343a0d00e901, Presenter
+8:acs:b6aada1f-0b1d-47ac-866f-91aae00a1d01_00000018-f00d-aa4b-0cf9-9c3a0d00543e, Consumer
+8:acs:b6aada1f-0b1d-47ac-866f-91aae00a1d01_00000018-f00d-aaf2-0cf9-9c3a0d00543f, Attendee
 
 Removed participants from room
 
-Deleted room with id:  99445276259151407
+Deleted room with id: 99445276259151407
 
 ```
 
 ## Reference documentation
 
-Read about the full set of capabilities of Azure Communication Services rooms from the [.NET SDK reference](/dotnet/api/azure.communication.rooms) or [REST API reference](/rest/api/communication/rooms).
+Read about the full set of capabilities of Azure Communication Services re [.NET SDK reference](/dotnet/api/azure.communication.rooms) or [REST API reference](/rest/api/communication/rooms).