modify enhanceed mode customization

Author: amber-yujueWang

sdk/cognitiveservices/azure-ai-speech-transcription/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Release History
 
-## 1.0.0-beta.1 (2025-12-12)
+## 1.0.0-beta.1 (2025-12-18)
 
 ### Features Added
 

sdk/cognitiveservices/azure-ai-speech-transcription/README.md

@@ -204,7 +204,6 @@ byte[] audioData = Files.readAllBytes(Paths.get("path/to/audio.wav"));
 AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData));
 
 EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
-    .setEnabled(true)
     .setTask("transcribe")
     .setPrompts(java.util.Arrays.asList("Output must be in lexical format."));
 

sdk/cognitiveservices/azure-ai-speech-transcription/customization/src/main/java/SpeechTranscriptionCustomization.java

@@ -59,8 +59,8 @@ public void customize(LibraryCustomization customization, Logger logger) {
             logger.info("Customizing TranscriptionDiarizationOptions.toJson()");
             customizeDiarizationOptionsToJson(models);
 
-            // Customize EnhancedModeOptions to add setter for enabled property
-            logger.info("Customizing EnhancedModeOptions to add setEnabled() method");
+            // Customize EnhancedModeOptions constructor to auto-set enabled to true
+            logger.info("Customizing EnhancedModeOptions constructor to auto-set enabled to true");
             customizeEnhancedModeOptions(models);
 
             // Customize AudioFileDetails.getFilename() to auto-generate filename from contentType if not set
@@ -119,6 +119,34 @@ private void customizeDiarizationOptionsToJson(PackageCustomization packageCusto
         });
     }
 
+    /**
+     * Customize EnhancedModeOptions constructor to automatically set enabled property to true.
+     * This ensures enhanced mode is enabled when EnhancedModeOptions is instantiated.
+     *
+     * @param packageCustomization the package customization
+     */
+    private void customizeEnhancedModeOptions(PackageCustomization packageCustomization) {
+        packageCustomization.getClass("EnhancedModeOptions").customizeAst(ast -> {
+            ast.getClassByName("EnhancedModeOptions").ifPresent(clazz -> {
+                // Remove the @Generated no-arg constructor and replace with one that sets enabled = true
+                clazz.getConstructors()
+                    .stream()
+                    .filter(c -> c.getParameters().isEmpty())
+                    .findFirst()
+                    .ifPresent(constructor -> {
+                        // Remove @Generated annotation to prevent overwriting
+                        constructor.getAnnotationByName("Generated").ifPresent(com.github.javaparser.ast.Node::remove);
+                        // Set the constructor body to initialize enabled = true
+                        constructor.setBody(parseBlock("{ this.enabled = true; }"));
+                        // Add JavaDoc
+                        constructor.setJavadocComment(
+                            new Javadoc(parseText(
+                                "Creates an instance of EnhancedModeOptions class with enabled set to true.")));
+                    });
+            });
+        });
+    }
+
     /**
      * Customize AudioFileDetails.getFilename() to auto-generate a filename from contentType if not explicitly set.
      * This allows developers to omit setFilename() and have the SDK automatically provide a sensible default.
@@ -147,30 +175,6 @@ private void customizeAudioFileDetailsGetFilename(PackageCustomization packageCu
         });
     }
 
-    /**
-     * Customize the EnhancedModeOptions to add a setter for the enabled property.
-     * The enabled property must be explicitly set by users to enable enhanced mode features.
-     *
-     * @param packageCustomization the package customization
-     */
-    private void customizeEnhancedModeOptions(PackageCustomization packageCustomization) {
-        packageCustomization.getClass("EnhancedModeOptions").customizeAst(ast -> {
-            ast.getClassByName("EnhancedModeOptions").ifPresent(clazz -> {
-                // Add setEnabled method following the fluent pattern
-                com.github.javaparser.ast.body.MethodDeclaration setEnabledMethod
-                    = clazz.addMethod("setEnabled", Modifier.Keyword.PUBLIC);
-                setEnabledMethod.addParameter("Boolean", "enabled");
-                setEnabledMethod.setType("EnhancedModeOptions");
-                setEnabledMethod.setBody(parseBlock("{ this.enabled = enabled; return this; }"));
-                setEnabledMethod.setJavadocComment(
-                    new Javadoc(parseText(
-                        "Set the enabled property: Enable enhanced mode for transcription. Must be set to true to use enhanced mode features."))
-                            .addBlockTag("param", "enabled the enabled value to set.")
-                            .addBlockTag("return", "the EnhancedModeOptions object itself."));
-            });
-        });
-    }
-
     /**
      * Customize TranscriptionOptions to:
      * 1. Add AudioFileDetails field (final)

sdk/cognitiveservices/azure-ai-speech-transcription/src/main/java/com/azure/ai/speech/transcription/models/EnhancedModeOptions.java

@@ -44,10 +44,10 @@ public final class EnhancedModeOptions implements JsonSerializable<EnhancedModeO
     private List<String> prompts;
 
     /**
-     * Creates an instance of EnhancedModeOptions class.
+     * Creates an instance of EnhancedModeOptions class with enabled set to true.
      */
-    @Generated
     public EnhancedModeOptions() {
+        this.enabled = true;
     }
 
     /**

sdk/cognitiveservices/azure-ai-speech-transcription/src/samples/java/com/azure/ai/speech/transcription/EnhancedModeSample.java

@@ -122,7 +122,6 @@ private static TranscriptionResult transcribeWithFullEnhancedMode(
         // Configure comprehensive LLM-enhanced mode settings
         // Always include lexical format prompt for best results
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
-            .setEnabled(true)
             .setTask("transcribe")
             .setPrompts(Arrays.asList(
                 "Output must be in lexical format."

sdk/cognitiveservices/azure-ai-speech-transcription/src/samples/java/com/azure/ai/speech/transcription/ReadmeSamples.java

@@ -241,7 +241,6 @@ public void enhancedModeBasic() throws Exception {
 
         // Enable enhanced mode for improved transcription quality with lexical format
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
-            .setEnabled(true)
             .setPrompts(java.util.Arrays.asList(
                 "Output must be in lexical format."
             ));
@@ -271,7 +270,6 @@ public void enhancedModeWithPrompts() throws Exception {
         // Use prompts to guide transcription with domain-specific terminology
         // Always include lexical format prompt for best results
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
-            .setEnabled(true)
             .setPrompts(java.util.Arrays.asList(
                 "Output must be in lexical format.",
                 "Medical consultation discussing hypertension and diabetes",
@@ -303,7 +301,6 @@ public void enhancedModeWithTranslation() throws Exception {
 
         // Configure enhanced mode to transcribe Spanish audio and translate to English
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
-            .setEnabled(true)
             .setTargetLanguage("en-US"); // Translate to English
 
         TranscriptionOptions options = new TranscriptionOptions(audioFileDetails)
@@ -379,7 +376,6 @@ public void transcribeEnhancedMode() throws Exception {
         AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData));
 
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
-            .setEnabled(true)
             .setTask("transcribe")
             .setPrompts(java.util.Arrays.asList("Output must be in lexical format."));