Add PauseOnStart Recording Option Swagger

sdk/communication/azure-communication-callautomation/CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Features Added
 - Start/Stop continuous DTMF recognition by subscribing/unsubscribing to tones.
 - Send DTMF tones to a participant in the call
+- StartRecording now accepts PauseOnStart.
 
 ### Breaking Changes
 

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/CallRecordingAsync.java

@@ -159,6 +159,9 @@ private StartCallRecordingRequestInternal getStartCallRecordingRequest(StartReco
         if (options.getRecordingChannel() != null) {
             request.setRecordingChannelType(RecordingChannelInternal.fromString(options.getRecordingChannel().toString()));
         }
+        if (options.getPauseOnStart() != null) {
+            request.setPauseOnStart(options.getPauseOnStart());
+        }
         if (options.getRecordingStateCallbackUrl() != null) {
             request.setRecordingStateCallbackUri(options.getRecordingStateCallbackUrl());
         }

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/implementation/CallMediasImpl.java

@@ -80,7 +80,7 @@ Mono<Response<Void>> startTranscription(
                 @HeaderParam("Accept") String accept,
                 Context context);
 
-        @Post("/calling/callConnections/{callConnectionId}:StopTranscripition")
+        @Post("/calling/callConnections/{callConnectionId}:StopTranscription")
         @ExpectedResponses({202})
         @UnexpectedResponseExceptionType(CommunicationErrorResponseException.class)
         Mono<Response<Void>> stopTranscription(

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/implementation/models/StartCallRecordingRequestInternal.java

@@ -71,6 +71,13 @@ public final class StartCallRecordingRequestInternal {
     @JsonProperty(value = "externalStorage")
     private ExternalStorageInternal externalStorage;
 
+    /*
+     * When set to true will start recording in Pause mode, which could be
+     * resumed.
+     */
+    @JsonProperty(value = "pauseOnStart")
+    private Boolean pauseOnStart;
+
     /**
      * Get the callLocator property: The call locator.
      *
@@ -243,4 +250,24 @@ public StartCallRecordingRequestInternal setExternalStorage(ExternalStorageInter
         this.externalStorage = externalStorage;
         return this;
     }
+
+    /**
+     * Get the pauseOnStart property: When set to true will start recording in Pause mode, which could be resumed.
+     *
+     * @return the pauseOnStart value.
+     */
+    public Boolean isPauseOnStart() {
+        return this.pauseOnStart;
+    }
+
+    /**
+     * Set the pauseOnStart property: When set to true will start recording in Pause mode, which could be resumed.
+     *
+     * @param pauseOnStart the pauseOnStart value to set.
+     * @return the StartCallRecordingRequestInternal object itself.
+     */
+    public StartCallRecordingRequestInternal setPauseOnStart(Boolean pauseOnStart) {
+        this.pauseOnStart = pauseOnStart;
+        return this;
+    }
 }

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/implementation/models/TranscriptionStatus.java

@@ -0,0 +1,46 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.communication.callautomation.implementation.models;
+
+import com.azure.core.util.ExpandableStringEnum;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import java.util.Collection;
+
+/** Defines values for TranscriptionStatus. */
+public final class TranscriptionStatus extends ExpandableStringEnum<TranscriptionStatus> {
+    /** Static value transcriptionStarted for TranscriptionStatus. */
+    public static final TranscriptionStatus TRANSCRIPTION_STARTED = fromString("transcriptionStarted");
+
+    /** Static value transcriptionFailed for TranscriptionStatus. */
+    public static final TranscriptionStatus TRANSCRIPTION_FAILED = fromString("transcriptionFailed");
+
+    /** Static value transcriptionResumed for TranscriptionStatus. */
+    public static final TranscriptionStatus TRANSCRIPTION_RESUMED = fromString("transcriptionResumed");
+
+    /** Static value transcriptionLocaleUpdated for TranscriptionStatus. */
+    public static final TranscriptionStatus TRANSCRIPTION_LOCALE_UPDATED = fromString("transcriptionLocaleUpdated");
+
+    /** Static value transcriptionStopped for TranscriptionStatus. */
+    public static final TranscriptionStatus TRANSCRIPTION_STOPPED = fromString("transcriptionStopped");
+
+    /** Static value unspecifiedError for TranscriptionStatus. */
+    public static final TranscriptionStatus UNSPECIFIED_ERROR = fromString("unspecifiedError");
+
+    /**
+     * Creates or finds a TranscriptionStatus from its string representation.
+     *
+     * @param name a name to look for.
+     * @return the corresponding TranscriptionStatus.
+     */
+    @JsonCreator
+    public static TranscriptionStatus fromString(String name) {
+        return fromString(name, TranscriptionStatus.class);
+    }
+
+    /** @return known TranscriptionStatus values. */
+    public static Collection<TranscriptionStatus> values() {
+        return values(TranscriptionStatus.class);
+    }
+}

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/implementation/models/TranscriptionStatusDetails.java

@@ -0,0 +1,59 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+// Code generated by Microsoft (R) AutoRest Code Generator.
+
+package com.azure.communication.callautomation.implementation.models;
+
+import com.azure.core.util.ExpandableStringEnum;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import java.util.Collection;
+
+/** Defines values for TranscriptionStatusDetails. */
+public final class TranscriptionStatusDetails extends ExpandableStringEnum<TranscriptionStatusDetails> {
+    /** Static value subscriptionStarted for TranscriptionStatusDetails. */
+    public static final TranscriptionStatusDetails SUBSCRIPTION_STARTED = fromString("subscriptionStarted");
+
+    /** Static value streamConnectionReestablished for TranscriptionStatusDetails. */
+    public static final TranscriptionStatusDetails STREAM_CONNECTION_REESTABLISHED =
+            fromString("streamConnectionReestablished");
+
+    /** Static value streamConnectionUnsuccessful for TranscriptionStatusDetails. */
+    public static final TranscriptionStatusDetails STREAM_CONNECTION_UNSUCCESSFUL =
+            fromString("streamConnectionUnsuccessful");
+
+    /** Static value streamUrlMissing for TranscriptionStatusDetails. */
+    public static final TranscriptionStatusDetails STREAM_URL_MISSING = fromString("streamUrlMissing");
+
+    /** Static value serviceShutdown for TranscriptionStatusDetails. */
+    public static final TranscriptionStatusDetails SERVICE_SHUTDOWN = fromString("serviceShutdown");
+
+    /** Static value streamConnectionInterrupted for TranscriptionStatusDetails. */
+    public static final TranscriptionStatusDetails STREAM_CONNECTION_INTERRUPTED =
+            fromString("streamConnectionInterrupted");
+
+    /** Static value speechServicesConnectionError for TranscriptionStatusDetails. */
+    public static final TranscriptionStatusDetails SPEECH_SERVICES_CONNECTION_ERROR =
+            fromString("speechServicesConnectionError");
+
+    /** Static value subscriptionStopped for TranscriptionStatusDetails. */
+    public static final TranscriptionStatusDetails SUBSCRIPTION_STOPPED = fromString("subscriptionStopped");
+
+    /** Static value unspecifiedError for TranscriptionStatusDetails. */
+    public static final TranscriptionStatusDetails UNSPECIFIED_ERROR = fromString("unspecifiedError");
+
+    /**
+     * Creates or finds a TranscriptionStatusDetails from its string representation.
+     *
+     * @param name a name to look for.
+     * @return the corresponding TranscriptionStatusDetails.
+     */
+    @JsonCreator
+    public static TranscriptionStatusDetails fromString(String name) {
+        return fromString(name, TranscriptionStatusDetails.class);
+    }
+
+    /** @return known TranscriptionStatusDetails values. */
+    public static Collection<TranscriptionStatusDetails> values() {
+        return values(TranscriptionStatusDetails.class);
+    }
+}

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/implementation/models/TranscriptionUpdate.java

@@ -14,20 +14,20 @@ public final class TranscriptionUpdate {
      * The transcriptionStatus property.
      */
     @JsonProperty(value = "transcriptionStatus")
-    private String transcriptionStatus;
+    private TranscriptionStatus transcriptionStatus;
 
     /*
      * The transcriptionStatusDetails property.
      */
     @JsonProperty(value = "transcriptionStatusDetails")
-    private String transcriptionStatusDetails;
+    private TranscriptionStatusDetails transcriptionStatusDetails;
 
     /**
      * Get the transcriptionStatus property: The transcriptionStatus property.
      *
      * @return the transcriptionStatus value.
      */
-    public String getTranscriptionStatus() {
+    public TranscriptionStatus getTranscriptionStatus() {
         return this.transcriptionStatus;
     }
 
@@ -37,7 +37,7 @@ public String getTranscriptionStatus() {
      * @param transcriptionStatus the transcriptionStatus value to set.
      * @return the TranscriptionUpdate object itself.
      */
-    public TranscriptionUpdate setTranscriptionStatus(String transcriptionStatus) {
+    public TranscriptionUpdate setTranscriptionStatus(TranscriptionStatus transcriptionStatus) {
         this.transcriptionStatus = transcriptionStatus;
         return this;
     }
@@ -47,7 +47,7 @@ public TranscriptionUpdate setTranscriptionStatus(String transcriptionStatus) {
      *
      * @return the transcriptionStatusDetails value.
      */
-    public String getTranscriptionStatusDetails() {
+    public TranscriptionStatusDetails getTranscriptionStatusDetails() {
         return this.transcriptionStatusDetails;
     }
 
@@ -57,7 +57,7 @@ public String getTranscriptionStatusDetails() {
      * @param transcriptionStatusDetails the transcriptionStatusDetails value to set.
      * @return the TranscriptionUpdate object itself.
      */
-    public TranscriptionUpdate setTranscriptionStatusDetails(String transcriptionStatusDetails) {
+    public TranscriptionUpdate setTranscriptionStatusDetails(TranscriptionStatusDetails transcriptionStatusDetails) {
         this.transcriptionStatusDetails = transcriptionStatusDetails;
         return this;
     }

sdk/communication/azure-communication-callautomation/src/main/java/com/azure/communication/callautomation/models/StartRecordingOptions.java

@@ -27,6 +27,8 @@ public final class StartRecordingOptions {
 
     private RecordingFormat recordingFormat;
 
+    private Boolean pauseOnStart;
+
     private List<CommunicationIdentifier> audioChannelParticipantOrdering;
 
     private List<ChannelAffinity> channelAffinity;
@@ -132,6 +134,26 @@ public StartRecordingOptions setRecordingFormat(RecordingFormat recordingFormat)
         return this;
     }
 
+    /**
+     * Get pause on start.
+     *
+     * @return pause on start.
+     */
+    public Boolean getPauseOnStart() {
+        return pauseOnStart;
+    }
+
+    /**
+     * Set the pause on start property.
+     *
+     * @param pauseOnStart the {@link pauseOnStart}.
+     * @return the {@link StartRecordingOptions}
+     */
+    public StartRecordingOptions setPauseOnStart(Boolean pauseOnStart) {
+        this.pauseOnStart = pauseOnStart;
+        return this;
+    }
+
     /**
      * Get the audioChannelParticipantOrdering property: The sequential order in which audio channels are assigned to
      * participants in the unmixed recording. When 'recordingChannelType' is set to 'unmixed' and

sdk/communication/azure-communication-callautomation/swagger/README.md

@@ -28,7 +28,7 @@ autorest README.md --java --v4 --use=@autorest/[email protected] --use=@autorest/model
 ``` yaml
 tag: package-2023-01-15-preview
 require:
-    - https://github.com/williamzhao87/azure-rest-api-specs/blob/8f5bd72f81f7fa9020f6834f06f3db54a475ee68/specification/communication/data-plane/CallAutomation/readme.md
+    - https://github.com/williamzhao87/azure-rest-api-specs/blob/5b7321a923a30b83b978e3a30ed1d497e35052fd/specification/communication/data-plane/CallAutomation/readme.md
 java: true
 output-folder: ../
 license-header: MICROSOFT_MIT_SMALL