[Media Composition] Break down Update into more granular functions (Azure#30039)

* Change update to more granular functions

* Add new live tests and update generate api file

* Fix build

* Update sdk/communication/Azure.Communication.MediaComposition/README.md

Co-authored-by: Orlando Watson <thewatsonorlando@gmail.com>

* Addressing review comments

Co-authored-by: Minnie Liu <peiliu@microsoft.com>
Co-authored-by: Orlando Watson <thewatsonorlando@gmail.com>

Author: 3 people

sdk/communication/Azure.Communication.MediaComposition/README.md

@@ -122,8 +122,8 @@ var gridMediaCompositionResponse = await mediaCompositionClient.GetAsync(mediaCo
 
 ### Updating an existing media composition
 
-Note: Updating the `groupCallInput` and the `teamsMeetingInput` is currently not supported. A new media composition will need to be created if `groupCallInput` and the `teamsMeetingInput` needs to change.
-```C# Snippet:UpdateMediaComposition
+You can update the layout:
+```C# Snippet:UpdateLayout
 var layout = new MediaCompositionLayout()
 {
     Resolution = new(720, 480),
@@ -133,7 +133,57 @@ var layout = new MediaCompositionLayout()
         SupportAspectRatio = 3 / 2
     }
 };
-var response = await mediaCompositionClient.UpdateAsync(mediaCompositionId, layout);
+var response = await mediaCompositionClient.UpdateLayoutAsync(mediaCompositionId, layout);
+```
+
+Note: Upserting `GroupCall`, `Room`, and `TeamsMeeting` input kind is currently not supported if the media composition is running. The media composition will need to be stopped if `GroupCall`, `Room`, or `TeamsMeeting` inputs need to change.
+You can upsert or remove inputs:
+
+```C# Snippet:UpsertInputs
+var inputsToUpsert = new Dictionary<string, MediaInput>()
+{
+    ["james"] = new()
+    {
+        Participant = new(
+            id: new() { MicrosoftTeamsUser = new("f3ba9014-6dca-4456-8ec0-fa03cfa2b70p") },
+            call: "teamsMeeting")
+        {
+            PlaceholderImageUri = "https://imageendpoint"
+        }
+    }
+};
+var response = await mediaCompositionClient.UpsertInputsAsync(mediaCompositionId, inputsToUpsert);
+```
+
+```C# Snippet:RemoveInputs
+var inputIdsToRemove = new List<string>()
+{
+    "jane", "jerry"
+};
+var response = await mediaCompositionClient.RemoveInputsAsync(mediaCompositionId, inputIdsToRemove);
+```
+
+You can also upsert or remove outputs:
+```C# Snippet:UpsertOutputs
+var outputsToUpsert = new Dictionary<string, MediaOutput>()
+{
+    {
+        "youtube",
+        new()
+        {
+            Rtmp = new("key", new(1920, 1080), "rtmp://a.rtmp.youtube.com/live2")
+        }
+    }
+};
+var response = await mediaCompositionClient.UpsertOutputsAsync(mediaCompositionId, outputsToUpsert);
+```
+
+```C# Snippet:RemoveOutputs
+var outputIdsToRemove = new List<string>()
+{
+    "acsGroupCall"
+};
+var response = await mediaCompositionClient.RemoveOutputsAsync(mediaCompositionId, outputIdsToRemove);
 ```
 
 ### Starting the media composition to start streaming

sdk/communication/Azure.Communication.MediaComposition/api/Azure.Communication.MediaComposition.netstandard2.0.cs

@@ -151,12 +151,20 @@ public MediaCompositionClient(System.Uri endpoint, Azure.Core.TokenCredential to
         public virtual System.Threading.Tasks.Task<Azure.Response> DeleteAsync(string mediaCompositionId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody> Get(string mediaCompositionId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody>> GetAsync(string mediaCompositionId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody> RemoveInputs(string mediaCompositionId, System.Collections.Generic.IEnumerable<string> inputIds, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody>> RemoveInputsAsync(string mediaCompositionId, System.Collections.Generic.IEnumerable<string> inputIds, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody> RemoveOutputs(string mediaCompositionId, System.Collections.Generic.IEnumerable<string> outputIds, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody>> RemoveOutputsAsync(string mediaCompositionId, System.Collections.Generic.IEnumerable<string> outputIds, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual Azure.Response<Azure.Communication.MediaComposition.CompositionStreamState> Start(string mediaCompositionId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.MediaComposition.CompositionStreamState>> StartAsync(string mediaCompositionId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual Azure.Response<Azure.Communication.MediaComposition.CompositionStreamState> Stop(string mediaCompositionId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.MediaComposition.CompositionStreamState>> StopAsync(string mediaCompositionId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
-        public virtual Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody> Update(string mediaCompositionId, Azure.Communication.MediaComposition.Models.MediaCompositionLayout layout = null, System.Collections.Generic.IDictionary<string, Azure.Communication.MediaComposition.MediaInput> inputs = null, System.Collections.Generic.IDictionary<string, Azure.Communication.MediaComposition.MediaOutput> outputs = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
-        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody>> UpdateAsync(string mediaCompositionId, Azure.Communication.MediaComposition.Models.MediaCompositionLayout layout = null, System.Collections.Generic.IDictionary<string, Azure.Communication.MediaComposition.MediaInput> inputs = null, System.Collections.Generic.IDictionary<string, Azure.Communication.MediaComposition.MediaOutput> outputs = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody> UpdateLayout(string mediaCompositionId, Azure.Communication.MediaComposition.Models.MediaCompositionLayout layout, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody>> UpdateLayoutAsync(string mediaCompositionId, Azure.Communication.MediaComposition.Models.MediaCompositionLayout layout, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody> UpsertInputs(string mediaCompositionId, System.Collections.Generic.IDictionary<string, Azure.Communication.MediaComposition.MediaInput> inputs, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody>> UpsertInputsAsync(string mediaCompositionId, System.Collections.Generic.IDictionary<string, Azure.Communication.MediaComposition.MediaInput> inputs, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody> UpsertOutputs(string mediaCompositionId, System.Collections.Generic.IDictionary<string, Azure.Communication.MediaComposition.MediaOutput> outputs, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Communication.MediaComposition.MediaCompositionBody>> UpsertOutputsAsync(string mediaCompositionId, System.Collections.Generic.IDictionary<string, Azure.Communication.MediaComposition.MediaOutput> outputs, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
     }
     public partial class MediaCompositionClientOptions : Azure.Core.ClientOptions
     {