modify enhanceed mode customization and update readme

Author: amber-yujueWang

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

@@ -196,13 +196,14 @@ result.getPhrases().forEach(phrase -> {
 
 ### Transcribe with enhanced mode
 
-Enhanced mode provides advanced features to improve transcription accuracy with custom prompts.
+Enhanced mode provides advanced features to improve transcription accuracy with custom prompts. Enhanced mode is automatically enabled when you create an `EnhancedModeOptions` instance.
 
 ```java com.azure.ai.speech.transcription.transcriptionoptions.enhancedmode
 byte[] audioData = Files.readAllBytes(Paths.get("path/to/audio.wav"));
 
 AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData));
 
+// Enhanced mode is automatically enabled
 EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
     .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

@@ -120,8 +120,9 @@ 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.
+     * Customize EnhancedModeOptions to hide the enabled property from the public API.
+     * The enabled property is automatically set to true in the constructor.
+     * Both isEnabled() getter and setEnabled() setter are removed from the public API.
      *
      * @param packageCustomization the package customization
      */
@@ -141,8 +142,14 @@ private void customizeEnhancedModeOptions(PackageCustomization packageCustomizat
                         // Add JavaDoc
                         constructor.setJavadocComment(
                             new Javadoc(parseText(
-                                "Creates an instance of EnhancedModeOptions class with enabled set to true.")));
+                                "Creates an instance of EnhancedModeOptions class with enhanced mode automatically enabled.")));
                     });
+                
+                // Remove isEnabled() getter to hide enabled from public API
+                clazz.getMethodsByName("isEnabled").forEach(method -> method.remove());
+                
+                // Remove ALL setEnabled() methods to hide enabled from public API
+                clazz.getMethodsByName("setEnabled").forEach(method -> method.remove());
             });
         });
     }

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

@@ -50,17 +50,6 @@ public EnhancedModeOptions() {
         this.enabled = true;
     }
 
-    /**
-     * Get the enabled property: Enable enhanced mode for transcription. This is automatically set to true when task,
-     * targetLanguage, or prompt are specified.
-     *
-     * @return the enabled value.
-     */
-    @Generated
-    public Boolean isEnabled() {
-        return this.enabled;
-    }
-
     /**
      * Get the task property: Task type for enhanced mode.
      *
@@ -171,16 +160,4 @@ public static EnhancedModeOptions fromJson(JsonReader jsonReader) throws IOExcep
             return deserializedEnhancedModeOptions;
         });
     }
-
-    /**
-     * Set the enabled property: Enable enhanced mode for transcription. Must be set to true to use enhanced mode
-     * features.
-     *
-     * @param enabled the enabled value to set.
-     * @return the EnhancedModeOptions object itself.
-     */
-    public EnhancedModeOptions setEnabled(Boolean enabled) {
-        this.enabled = enabled;
-        return this;
-    }
 }

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

@@ -120,6 +120,7 @@ private static TranscriptionResult transcribeWithFullEnhancedMode(
         AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData));
 
         // Configure comprehensive LLM-enhanced mode settings
+        // Enhanced mode is automatically enabled when you create EnhancedModeOptions
         // Always include lexical format prompt for best results
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
             .setTask("transcribe")

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

@@ -239,7 +239,7 @@ public void enhancedModeBasic() throws Exception {
 
         AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData));
 
-        // Enable enhanced mode for improved transcription quality with lexical format
+        // Enhanced mode is automatically enabled when you create EnhancedModeOptions
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
             .setPrompts(java.util.Arrays.asList(
                 "Output must be in lexical format."
@@ -267,6 +267,7 @@ public void enhancedModeWithPrompts() throws Exception {
 
         AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData));
 
+        // Enhanced mode is automatically enabled
         // Use prompts to guide transcription with domain-specific terminology
         // Always include lexical format prompt for best results
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
@@ -299,6 +300,7 @@ public void enhancedModeWithTranslation() throws Exception {
 
         AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData));
 
+        // Enhanced mode is automatically enabled
         // Configure enhanced mode to transcribe Spanish audio and translate to English
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
             .setTargetLanguage("en-US"); // Translate to English
@@ -375,6 +377,7 @@ public void transcribeEnhancedMode() throws Exception {
 
         AudioFileDetails audioFileDetails = new AudioFileDetails(BinaryData.fromBytes(audioData));
 
+        // Enhanced mode is automatically enabled
         EnhancedModeOptions enhancedMode = new EnhancedModeOptions()
             .setTask("transcribe")
             .setPrompts(java.util.Arrays.asList("Output must be in lexical format."));