Merge pull request #57 from twilio/twiml-speech-recognition

Add speech recognition parameters

Author: jingming

src/main/java/com/twilio/twiml/Gather.java

@@ -29,6 +29,24 @@ public class Gather extends TwiML {
     @XmlAttribute
     private final String finishOnKey;
 
+    @XmlAttribute
+    private final String partialResultCallback;
+
+    @XmlAttribute
+    private final Method partialResultCallbackMethod;
+
+    @XmlAttribute
+    private final Language language;
+
+    @XmlAttribute
+    private final String hints;
+
+    @XmlAttribute
+    private final Boolean bargeIn;
+
+    @XmlAttribute
+    private final String acknowledgeSoundUrl;
+
     @SuppressWarnings("checkstyle:indentation")
     @XmlElements({
         @XmlElement(name = "Say", type = Say.class),
@@ -49,6 +67,12 @@ private Gather(Builder b) {
         this.method = b.method;
         this.finishOnKey = b.finishOnKey;
         this.actions = Lists.newArrayList(b.actions);
+        this.partialResultCallback = b.partialResultCallback;
+        this.partialResultCallbackMethod = b.partialResultCallbackMethod;
+        this.language = b.language;
+        this.hints = b.hints;
+        this.bargeIn = b.bargeIn;
+        this.acknowledgeSoundUrl = b.acknowledgeSoundUrl;
     }
 
     public Integer getTimeout() {
@@ -75,13 +99,43 @@ public List<TwiML> getActions() {
         return actions;
     }
 
+    public String getPartialResultCallback() {
+        return partialResultCallback;
+    }
+
+    public Method getPartialResultCallbackMethod() {
+        return partialResultCallbackMethod;
+    }
+
+    public Language getLanguage() {
+        return language;
+    }
+
+    public String getHints() {
+        return hints;
+    }
+
+    public Boolean getBargeIn() {
+        return bargeIn;
+    }
+
+    public String getAcknowledgeSoundUrl() {
+        return acknowledgeSoundUrl;
+    }
+
     public static class Builder {
         private Integer timeout;
         private Integer numDigits;
         private String action;
         private Method method;
         private String finishOnKey;
         private List<TwiML> actions = Lists.newArrayList();
+        private String partialResultCallback;
+        private Method partialResultCallbackMethod;
+        private Language language;
+        private String hints;
+        private Boolean bargeIn;
+        private String acknowledgeSoundUrl;
 
         public Builder timeout(int timeout) {
             this.timeout = timeout;
@@ -123,6 +177,36 @@ public Builder pause(Pause pause) {
             return this;
         }
 
+        public Builder partialResultCallback(String partialResultCallback) {
+            this.partialResultCallback = partialResultCallback;
+            return this;
+        }
+
+        public Builder partialResultCallbackMethod(Method partialResultCallbackMethod) {
+            this.partialResultCallbackMethod = partialResultCallbackMethod;
+            return this;
+        }
+
+        public Builder language(Language language) {
+            this.language = language;
+            return this;
+        }
+
+        public Builder hints(String hints) {
+            this.hints = hints;
+            return this;
+        }
+
+        public Builder bargeIn(Boolean bargeIn) {
+            this.bargeIn = bargeIn;
+            return this;
+        }
+
+        public Builder acknowledgeSoundUrl(String acknowledgeSoundUrl) {
+            this.acknowledgeSoundUrl = acknowledgeSoundUrl;
+            return this;
+        }
+
         public Gather build() {
             return new Gather(this);
         }

src/main/java/com/twilio/twiml/Language.java

@@ -0,0 +1,48 @@
+package com.twilio.twiml;
+
+/**
+ * Twilio Languages
+ */
+public enum Language {
+    EN("en"),
+    EN_GB("en-gb"),
+    EN_AU("en-AU"),
+    EN_CA("en-GB"),
+    EN_IN("en-IN"),
+    EN_US("en-US"),
+    ES("es"),
+    ES_ES("es-ES"),
+    ES_MX("es-MX"),
+    FR("fr"),
+    FR_CA("fr-CA"),
+    FR_FR("fr-FR"),
+    DE("de"),
+    DE_DE("de-DE"),
+    DA_DK("da-DK"),
+    CA_ES("ca-ES"),
+    FI_FI("fi-FI"),
+    IT_IT("it-IT"),
+    JA_JP("ja-JP"),
+    KO_KR("ko-KR"),
+    NB_NO("nb-NO"),
+    NL_NL("nl-NL"),
+    PL_PL("pl-PL"),
+    PT_BR("pt-BR"),
+    PT_PT("pt-PT"),
+    RU_RU("ru-RU"),
+    SV_SE("sv-SE"),
+    ZH_CN("zh-CN"),
+    ZH_HK("zh-HK"),
+    ZH_TW("zh-TW");
+
+    private final String value;
+
+    Language(String value) {
+        this.value = value;
+    }
+
+    @Override
+    public String toString() {
+        return this.value;
+    }
+}

src/main/java/com/twilio/twiml/Say.java

@@ -28,50 +28,6 @@ public String toString() {
         }
     }
 
-    public enum Language {
-        EN("en"),
-        EN_GB("en-gb"),
-        EN_AU("en-AU"),
-        EN_CA("en-GB"),
-        EN_IN("en-IN"),
-        EN_US("en-US"),
-        ES("es"),
-        ES_ES("es-ES"),
-        ES_MX("es-MX"),
-        FR("fr"),
-        FR_CA("fr-CA"),
-        FR_FR("fr-FR"),
-        DE("de"),
-        DE_DE("de-DE"),
-        DA_DK("da-DK"),
-        CA_ES("ca-ES"),
-        FI_FI("fi-FI"),
-        IT_IT("it-IT"),
-        JA_JP("ja-JP"),
-        KO_KR("ko-KR"),
-        NB_NO("nb-NO"),
-        NL_NL("nl-NL"),
-        PL_PL("pl-PL"),
-        PT_BR("pt-BR"),
-        PT_PT("pt-PT"),
-        RU_RU("ru-RU"),
-        SV_SE("sv-SE"),
-        ZH_CN("zh-CN"),
-        ZH_HK("zh-HK"),
-        ZH_TW("zh-TW");
-
-        private final String value;
-
-        Language(String value) {
-            this.value = value;
-        }
-
-        @Override
-        public String toString() {
-            return this.value;
-        }
-    }
-
     @XmlAttribute
     private final Integer loop;
 

src/test/java/com/twilio/twiml/GatherTest.java

@@ -19,10 +19,11 @@ public void testXml() throws TwiMLException {
             .play(new Play.Builder("Hi!").build())
             .say(new Say.Builder("Hello world!").build())
             .timeout(5)
+            .hints("Hi there")
             .build();
 
         Assert.assertEquals(
-            "<Gather timeout=\"5\" numDigits=\"4\" action=\"/gather\" method=\"GET\" finishOnKey=\"1\">" +
+            "<Gather timeout=\"5\" numDigits=\"4\" action=\"/gather\" method=\"GET\" finishOnKey=\"1\" hints=\"Hi there\">" +
                 "<Pause/>" +
                 "<Play>Hi!</Play>" +
                 "<Say>Hello world!</Say>" +

src/test/java/com/twilio/twiml/SayTest.java

@@ -12,7 +12,7 @@ public class SayTest {
     public void testXml() throws TwiMLException {
         Say say = new Say.Builder("I <3 Twilio")
             .loop(4)
-            .language(Say.Language.EN_GB)
+            .language(Language.EN_GB)
             .voice(Say.Voice.MAN)
             .build();
 
@@ -23,7 +23,7 @@ public void testXml() throws TwiMLException {
     public void testUrl() throws TwiMLException {
         Say say = new Say.Builder("I <3 Twilio")
             .loop(4)
-            .language(Say.Language.ES)
+            .language(Language.ES)
             .voice(Say.Voice.ALICE)
             .build();