fixes #331 adding profanity_filter

Author: germanattanasio

src/main/java/com/ibm/watson/developer_cloud/speech_to_text/v1/SpeechToText.java

@@ -71,9 +71,11 @@ public class SpeechToText extends WatsonService {
   private static final String URL = "https://stream.watsonplatform.net/speech-to-text/api";
   private static final String WORD_ALTERNATIVES_THRESHOLD = "word_alternatives_threshold";
   private static final String WORD_CONFIDENCE = "word_confidence";
-
+  private static final String PROFANITY_FILTER = "profanity_filter";
+  
   private static final Type TYPE_LIST_MODELS = new TypeToken<List<SpeechModel>>() {}.getType();
   private static final Type TYPE_SESSION_STATUS = new TypeToken<SpeechSessionStatus>() {}.getType();
+  
 
   /**
    * Instantiates a new Speech to Text service.
@@ -109,6 +111,9 @@ private void buildRecognizeRequest(RequestBuilder requestBuilder, RecognizeOptio
     if (options.continuous() != null)
       requestBuilder.query(CONTINUOUS, options.continuous());
 
+    if (options.profanityFilter() != null)
+      requestBuilder.query(PROFANITY_FILTER, options.profanityFilter());
+
     if (options.maxAlternatives() != null)
       requestBuilder.query(MAX_ALTERNATIVES, options.maxAlternatives());
 

src/main/java/com/ibm/watson/developer_cloud/speech_to_text/v1/model/RecognizeOptions.java

@@ -42,6 +42,7 @@ public static class Builder {
     private Boolean timestamps;
     private Double wordAlternativesThreshold;
     private Boolean wordConfidence;
+    private Boolean profanityFilter;
 
 
     private Builder(RecognizeOptions options) {
@@ -57,6 +58,7 @@ private Builder(RecognizeOptions options) {
       this.timestamps = options.timestamps;
       this.wordAlternativesThreshold = options.wordAlternativesThreshold;
       this.wordConfidence = options.wordConfidence;
+      this.profanityFilter = options.profanityFilter;
     }
 
     /**
@@ -99,6 +101,19 @@ public Builder contentType(String contentType) {
     }
 
 
+    /**
+     * If true, filters profanity from all output except for keyword results by
+     * replacing inappropriate words with a series of asterisks. Set the parameter to false to
+     * return results with no censoring. Applies to US English transcription only.
+     * 
+     * @param profanityFilter the profanity filter
+     * @return the recognize options
+     */
+    public Builder profanityFilter(Boolean profanityFilter) {
+      this.profanityFilter = profanityFilter;
+      return this;
+    }
+
     /**
      * If true, multiple final results that represent multiple consecutive phrases separated by
      * pauses are returned. Otherwise, the recognition ends after first "end of speech" is detected.
@@ -262,7 +277,7 @@ public Builder wordConfidence(Boolean wordConfidence) {
   @SerializedName("keywords_threshold")
   private Double keywordsThreshold;
   private Integer maxAlternatives;
-
+  private Boolean profanityFilter;
   private String model;
   private String sessionId;
   private Boolean timestamps;
@@ -284,6 +299,7 @@ private RecognizeOptions(Builder builder) {
     this.timestamps = builder.timestamps;
     this.wordAlternativesThreshold = builder.wordAlternativesThreshold;
     this.wordConfidence = builder.wordConfidence;
+    this.profanityFilter = builder.profanityFilter;
   }
 
   /**
@@ -295,7 +311,15 @@ public String contentType() {
     return contentType;
   }
 
-
+  /**
+   * Gets the profanity filter
+   * 
+   * @return the profanity filter
+   */
+  public Boolean profanityFilter() {
+    return profanityFilter;
+  }
+  
   /**
    * Gets the continuous.
    * 

src/test/java/com/ibm/watson/developer_cloud/speech_to_text/v1/SpeechToTextIT.java

@@ -166,6 +166,7 @@ public void testRecognizeFileStringRecognizeOptions() {
       .wordConfidence(true)
       .model(EN_BROADBAND16K)
       .contentType(contentType)
+      .profanityFilter(false)
       .build();
     SpeechResults results = service.recognize(audio, options).execute();
     assertNotNull(results.getResults().get(0).getAlternatives().get(0).getTranscript());