Juntuchen/callback media (Azure#26860)

### Packages impacted by this PR


### Issues associated with this PR


### Describe the problem that is addressed by this PR


### What are the possible designs available to address the problem? If
there are more than one possible design, why was the one in this PR
chosen?


### Are there test cases added in this PR? _(If not, why?)_


### Provide a list of related PRs _(if any)_


### Command used to generate this PR:**_(Applicable only to SDK release
request PRs)_

### Checklists
- [ ] Added impacted package name to the issue description
- [ ] Does this PR needs any fixes in the SDK Generator?** _(If so,
create an Issue in the
[Autorest/typescript](https://github.com/Azure/autorest.typescript)
repository and link it here)_
- [ ] Added a changelog (if necessary)

Author: juntuchen-msft

sdk/communication/communication-call-automation/review/communication-call-automation.api.md

@@ -181,6 +181,8 @@ export interface CallMediaRecognizeDtmfOptions extends CallMediaRecognizeOptions
 
 // @public
 export interface CallMediaRecognizeOptions extends OperationOptions {
+    // (undocumented)
+    callbackUrl?: string;
     // (undocumented)
     initialSilenceTimeoutInSeconds?: number;
     // (undocumented)
@@ -272,6 +274,7 @@ export interface Choice {
 
 // @public
 export interface ContinuousDtmfRecognitionOptions extends OperationOptions {
+    callbackUrl?: string;
     operationContext?: string;
 }
 
@@ -494,9 +497,8 @@ export interface PlayFailed extends Omit<RestPlayFailed, "callConnectionId" | "s
 
 // @public
 export interface PlayOptions extends OperationOptions {
-    // (undocumented)
+    callbackUrl?: string;
     loop?: boolean;
-    // (undocumented)
     operationContext?: string;
 }
 
@@ -866,6 +868,7 @@ export interface SendDtmfFailed extends Omit<RestSendDtmfFailed, "callConnection
 
 // @public
 export interface SendDtmfOptions extends OperationOptions {
+    callbackUrl?: string;
     operationContext?: string;
 }
 

sdk/communication/communication-call-automation/src/callMedia.ts

@@ -119,6 +119,7 @@ export class CallMedia {
         loop: false,
       },
       operationContext: playOptions.operationContext,
+      callbackUri: playOptions.callbackUrl,
     };
 
     if (playOptions.loop !== undefined) {
@@ -145,6 +146,7 @@ export class CallMedia {
         loop: false,
       },
       operationContext: playOptions.operationContext,
+      callbackUri: playOptions.callbackUrl,
     };
 
     if (playOptions.loop !== undefined) {
@@ -187,6 +189,7 @@ export class CallMedia {
         interruptCallMediaOperation: recognizeOptions.interruptCallMediaOperation,
         recognizeOptions: recognizeOptionsInternal,
         operationContext: recognizeOptions.operationContext,
+        callbackUri: recognizeOptions.callbackUrl,
       };
     } else if (recognizeOptions.kind === "callMediaRecognizeChoiceOptions") {
       const recognizeOptionsInternal: RecognizeOptions = {
@@ -205,6 +208,7 @@ export class CallMedia {
         interruptCallMediaOperation: recognizeOptions.interruptCallMediaOperation,
         recognizeOptions: recognizeOptionsInternal,
         operationContext: recognizeOptions.operationContext,
+        callbackUri: recognizeOptions.callbackUrl,
       };
     } else if (recognizeOptions.kind === "callMediaRecognizeSpeechOptions") {
       const speechOptions: SpeechOptions = {
@@ -229,6 +233,7 @@ export class CallMedia {
         interruptCallMediaOperation: recognizeOptions.interruptCallMediaOperation,
         recognizeOptions: recognizeOptionsInternal,
         operationContext: recognizeOptions.operationContext,
+        callbackUri: recognizeOptions.callbackUrl,
       };
     } else if (recognizeOptions.kind === "callMediaRecognizeSpeechOrDtmfOptions") {
       const dtmfOptionsInternal: DtmfOptions = {
@@ -261,6 +266,7 @@ export class CallMedia {
         interruptCallMediaOperation: recognizeOptions.interruptCallMediaOperation,
         recognizeOptions: recognizeOptionsInternal,
         operationContext: recognizeOptions.operationContext,
+        callbackUri: recognizeOptions.callbackUrl,
       };
     }
     throw new Error("Invalid recognizeOptions");
@@ -325,6 +331,7 @@ export class CallMedia {
     const continuousDtmfRecognitionRequest: ContinuousDtmfRecognitionRequest = {
       targetParticipant: serializeCommunicationIdentifier(targetParticipant),
       operationContext: continuousDtmfRecognitionOptions.operationContext,
+      callbackUri: continuousDtmfRecognitionOptions.callbackUrl,
     };
     return this.callMedia.stopContinuousDtmfRecognition(
       this.callConnectionId,
@@ -348,6 +355,7 @@ export class CallMedia {
       tones: tones,
       targetParticipant: serializeCommunicationIdentifier(targetParticipant),
       operationContext: sendDtmfOptions.operationContext,
+      callbackUri: sendDtmfOptions.callbackUrl,
     };
     return this.callMedia.sendDtmf(this.callConnectionId, sendDtmfRequest, {});
   }

sdk/communication/communication-call-automation/src/generated/src/models/index.ts

@@ -28,6 +28,7 @@ export interface CallMediaRecognizeOptions extends OperationOptions {
   interruptPrompt?: boolean;
   initialSilenceTimeoutInSeconds?: number;
   speechModelEndpointId?: string;
+  callbackUrl?: string;
 }
 
 /** The recognize configuration specific to Dtmf. */
@@ -164,8 +165,12 @@ export interface MuteParticipantsOption extends OperationOptions {
  * Options to play audio.
  */
 export interface PlayOptions extends OperationOptions {
+  /** Determine if it is looping */
   loop?: boolean;
+  /** The value to identify context of the operation. */
   operationContext?: string;
+  /** Call back URI override for this request */
+  callbackUrl?: string;
 }
 
 /**
@@ -253,6 +258,8 @@ export interface DownloadRecordingOptions extends OperationOptions {
 export interface ContinuousDtmfRecognitionOptions extends OperationOptions {
   /** The value to identify context of the operation. */
   operationContext?: string;
+  /** Call back URI override for this request */
+  callbackUrl?: string;
 }
 
 /**
@@ -261,4 +268,6 @@ export interface ContinuousDtmfRecognitionOptions extends OperationOptions {
 export interface SendDtmfOptions extends OperationOptions {
   /** The value to identify context of the operation. */
   operationContext?: string;
+  /** Call back URI override for this request */
+  callbackUrl?: string;
 }

sdk/communication/communication-call-automation/src/generated/src/models/mappers.ts

@@ -12,7 +12,7 @@ generate-metadata: false
 license-header: MICROSOFT_MIT_NO_VERSION
 output-folder: ../src/generated
 tag: V2023-01-15-preview
-input-file: https://github.com/williamzhao87/azure-rest-api-specs/blob/b496fbaf1cef0d9a8d31cfb11c3fc301d4c328ef/specification/communication/data-plane/CallAutomation/preview/2023-01-15-preview/communicationservicescallautomation.json
+input-file: https://github.com/williamzhao87/azure-rest-api-specs/blob/18fef29e753a6637d5639874ab20825003ae2077/specification/communication/data-plane/CallAutomation/preview/2023-01-15-preview/communicationservicescallautomation.json
 package-version: 1.0.0-beta.1
 model-date-time-as-string: false
 optional-response-headers: true