updating the update transcription and media streaming

Author: Vinothini Dharmaraj

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

@@ -370,9 +370,9 @@ protected CallMedia() { }
         public virtual Azure.Response Unhold(Azure.Communication.CommunicationIdentifier targetParticipant, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual System.Threading.Tasks.Task<Azure.Response> UnholdAsync(Azure.Communication.CallAutomation.UnholdOptions options, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual System.Threading.Tasks.Task<Azure.Response> UnholdAsync(Azure.Communication.CommunicationIdentifier targetParticipant, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
-        public virtual Azure.Response UpdateTranscription(string locale, string speechRecognitionModelEndpointId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual Azure.Response UpdateTranscription(Azure.Communication.CallAutomation.UpdateTranscriptionOptions options = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual Azure.Response UpdateTranscription(string locale, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
-        public virtual System.Threading.Tasks.Task<Azure.Response> UpdateTranscriptionAsync(string locale, string speechRecognitionModelEndpointId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
+        public virtual System.Threading.Tasks.Task<Azure.Response> UpdateTranscriptionAsync(Azure.Communication.CallAutomation.UpdateTranscriptionOptions options = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
         public virtual System.Threading.Tasks.Task<Azure.Response> UpdateTranscriptionAsync(string locale, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) { throw null; }
     }
     [System.Runtime.InteropServices.StructLayoutAttribute(System.Runtime.InteropServices.LayoutKind.Sequential)]
@@ -1367,6 +1367,7 @@ public partial class StopMediaStreamingOptions
     {
         public StopMediaStreamingOptions() { }
         public System.Uri OperationCallbackUri { get { throw null; } set { } }
+        public string OperationContext { get { throw null; } set { } }
     }
     public partial class StopTranscriptionOptions
     {
@@ -1609,6 +1610,12 @@ public UnholdOptions(Azure.Communication.CommunicationIdentifier targetParticipa
         public string OperationContext { get { throw null; } set { } }
         public Azure.Communication.CommunicationIdentifier TargetParticipant { get { throw null; } }
     }
+    public partial class UpdateTranscriptionOptions
+    {
+        public UpdateTranscriptionOptions(string locale) { }
+        public string OperationContext { get { throw null; } set { } }
+        public string SpeechRecognitionModelEndpointId { get { throw null; } set { } }
+    }
     [System.Runtime.InteropServices.StructLayoutAttribute(System.Runtime.InteropServices.LayoutKind.Sequential)]
     public readonly partial struct VoiceKind : System.IEquatable<Azure.Communication.CallAutomation.VoiceKind>
     {

sdk/communication/Azure.Communication.CallAutomation/src/CallMedia.cs

@@ -1382,17 +1382,21 @@ public virtual Response UpdateTranscription(string locale, CancellationToken can
         /// <summary>
         /// API to change transcription language.
         /// </summary>
-        /// <param name="locale">Defines new locale for transcription.</param>
-        /// <param name="speechRecognitionModelEndpointId">Sets Endpoint id where the custom model was deployed.</param>
+        /// <param name="options">An optional object containing update transcription options and configurations.</param>
         /// <param name="cancellationToken">An optional CancellationToken to cancel the request.</param>
         /// <returns>Returns an HTTP response with a 202 status code for success, or an HTTP failure error code in case of an error.</returns>
-        public virtual Response UpdateTranscription(string locale, string speechRecognitionModelEndpointId, CancellationToken cancellationToken = default)
+        public virtual Response UpdateTranscription(UpdateTranscriptionOptions options = default, CancellationToken cancellationToken = default)
         {
             using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(CallMedia)}.{nameof(UpdateTranscription)}");
             scope.Start();
             try
             {
-                UpdateTranscriptionRequestInternal request = new UpdateTranscriptionRequestInternal(locale) { SpeechRecognitionModelEndpointId = speechRecognitionModelEndpointId };
+                UpdateTranscriptionRequestInternal request = new(options.Locale)
+                {
+                    OperationContext = options.OperationContext,
+                    SpeechRecognitionModelEndpointId = options.SpeechRecognitionModelEndpointId
+                };
+
                 return CallMediaRestClient.UpdateTranscription(CallConnectionId, request, cancellationToken);
             }
             catch (Exception ex)
@@ -1427,17 +1431,21 @@ public virtual async Task<Response> UpdateTranscriptionAsync(string locale, Canc
         /// <summary>
         /// API to change transcription language.
         /// </summary>
-        /// <param name="locale">Defines new locale for transcription.</param>
-        /// <param name="speechRecognitionModelEndpointId">Sets Endpoint id where the custom model was deployed.</param>
+        /// <param name="options">An optional object containing update transcription options and configurations.</param>
         /// <param name="cancellationToken">An optional CancellationToken to cancel the request.</param>
         /// <returns>Returns an HTTP response with a 202 status code for success, or an HTTP failure error code in case of an error.</returns>
-        public virtual async Task<Response> UpdateTranscriptionAsync(string locale, string speechRecognitionModelEndpointId, CancellationToken cancellationToken = default)
+        public virtual async Task<Response> UpdateTranscriptionAsync(UpdateTranscriptionOptions options = default, CancellationToken cancellationToken = default)
         {
             using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(CallMedia)}.{nameof(UpdateTranscription)}");
             scope.Start();
             try
             {
-                UpdateTranscriptionRequestInternal request = new UpdateTranscriptionRequestInternal(locale) { SpeechRecognitionModelEndpointId = speechRecognitionModelEndpointId };
+                UpdateTranscriptionRequestInternal request = new(options.Locale)
+                {
+                    OperationContext = options.OperationContext,
+                    SpeechRecognitionModelEndpointId = options.SpeechRecognitionModelEndpointId
+                };
+
                 return await CallMediaRestClient.UpdateTranscriptionAsync(CallConnectionId, request, cancellationToken).ConfigureAwait(false);
             }
             catch (Exception ex)
@@ -1536,7 +1544,7 @@ public virtual async Task<Response> StopMediaStreamingAsync(StopMediaStreamingOp
             {
                 var request = options == default
                     ? new StopMediaStreamingRequestInternal()
-                    : new StopMediaStreamingRequestInternal() { OperationCallbackUri = options.OperationCallbackUri?.AbsoluteUri };
+                    : new StopMediaStreamingRequestInternal() { OperationCallbackUri = options.OperationCallbackUri?.AbsoluteUri, OperationContext = options.OperationContext };
 
                 return await CallMediaRestClient.StopMediaStreamingAsync(CallConnectionId, request, cancellationToken).ConfigureAwait(false);
             }

sdk/communication/Azure.Communication.CallAutomation/src/Generated/Models/StopMediaStreamingRequestInternal.Serialization.cs

@@ -15,5 +15,8 @@ public class StopMediaStreamingOptions
         /// This setup is per-action. If this is not set, the default callback URI set by CreateCall/AnswerCall will be used.
         /// </summary>
         public Uri OperationCallbackUri { get; set; }
+
+        /// <summary> The value to identify context of the operation. </summary>
+        public string OperationContext { get; set; }
     }
 }

sdk/communication/Azure.Communication.CallAutomation/src/Generated/Models/StopMediaStreamingRequestInternal.cs

@@ -0,0 +1,28 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+namespace Azure.Communication.CallAutomation
+{
+    /// <summary>
+    /// Options for the stop transcription Request.
+    /// </summary>
+    public class UpdateTranscriptionOptions
+    {
+        /// <summary>
+        /// Options for the Update Transcription operation.
+        /// </summary>
+        public UpdateTranscriptionOptions(string locale)
+        {
+            this.Locale = locale;
+        }
+
+        /// <summary> Defines Locale for the transcription e,g en-US. </summary>
+        internal string Locale { get; set; }
+
+        /// <summary> The value to identify context of the operation. </summary>
+        public string OperationContext { get; set; }
+
+        /// <summary> Endpoint where the custom model was deployed. </summary>
+        public string SpeechRecognitionModelEndpointId { get; set; }
+    }
+}

sdk/communication/Azure.Communication.CallAutomation/src/Generated/Models/UpdateTranscriptionRequestInternal.Serialization.cs

@@ -10,7 +10,7 @@ model-namespace: false
 tag: package-2024-06-15-preview
 
 require:
-    - https://github.com/Azure/azure-rest-api-specs/blob/d1296700aa6cd650970e9891dd58eef5698327fd/specification/communication/data-plane/CallAutomation/readme.md
+    - https://github.com/Azure/azure-rest-api-specs/blob/1aa912658531534e4e57ea613591075f7b97897c/specification/communication/data-plane/CallAutomation/readme.md
 
 
 title: Azure Communication Services