Add voice gender to Audio translation

Author: ikhimenko

src/main/java/com/translated/lara/net/LaraClient.java

@@ -15,9 +15,11 @@
 import com.translated.lara.net.json.AudioStatusTypeAdapter;
 import com.translated.lara.net.json.DocumentStatusTypeAdapter;
 import com.translated.lara.net.json.TextResultValueTypeAdapter;
+import com.translated.lara.net.json.VoiceGenderTypeAdapter;
 import com.translated.lara.translator.Audio;
 import com.translated.lara.translator.Document;
 import com.translated.lara.translator.TextResult;
+import com.translated.lara.translator.VoiceGender;
 
 import javax.crypto.Mac;
 import javax.crypto.spec.SecretKeySpec;
@@ -46,6 +48,7 @@ public class LaraClient {
             .registerTypeAdapter(TextResult.Value.class, new TextResultValueTypeAdapter())
             .registerTypeAdapter(Document.Status.class, new DocumentStatusTypeAdapter())
             .registerTypeAdapter(Audio.Status.class, new AudioStatusTypeAdapter())
+            .registerTypeAdapter(VoiceGender.class, new VoiceGenderTypeAdapter())
             .setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES)
             .setDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ")
             .create();
@@ -384,7 +387,7 @@ private AuthToken authenticate(AccessKey accessKey) throws LaraException {
             AuthenticationResponse authResponse = response.as(AuthenticationResponse.class);
 
             if (authResponse == null || authResponse.getToken() == null || authResponse.getToken().isEmpty()) {
-                throw new LaraApiConnectionException("Missing access token in authentication response: " + response.toString());
+                throw new LaraApiConnectionException("Missing access token in authentication response: " + response);
             }
 
             String refreshToken = connection.getHeaderField("x-lara-refresh-token");

src/main/java/com/translated/lara/net/json/VoiceGenderTypeAdapter.java

@@ -0,0 +1,20 @@
+package com.translated.lara.net.json;
+
+import com.google.gson.JsonDeserializationContext;
+import com.google.gson.JsonDeserializer;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonParseException;
+import com.translated.lara.translator.VoiceGender;
+
+import java.lang.reflect.Type;
+
+public class VoiceGenderTypeAdapter implements JsonDeserializer<VoiceGender> {
+    @Override
+    public VoiceGender deserialize(JsonElement jsonElement, Type type, JsonDeserializationContext context) throws JsonParseException {
+        if (jsonElement != null && !jsonElement.isJsonNull()) {
+            return VoiceGender.valueOf(jsonElement.getAsString().toUpperCase());
+        } else {
+            return null;
+        }
+    }
+}

src/main/java/com/translated/lara/translator/AudioOptions.java

@@ -15,6 +15,7 @@ public class AudioOptions {
     private String[] glossaries = null;
     private Boolean noTrace = null;
     private TranslationStyle style = null;
+    private VoiceGender voiceGender = null;
 
     /**
      * Returns the list of adaptation targets (for example customer IDs or domains).
@@ -111,6 +112,24 @@ public AudioOptions setStyle(TranslationStyle style) {
         return this;
     }
 
+    /**
+     * Returns the voice gender for the translated audio synthesis.
+     */
+    public VoiceGender getVoiceGender() {
+        return voiceGender;
+    }
+
+    /**
+     * Sets the voice gender for the translated audio synthesis.
+     *
+     * @param voiceGender voice gender; may be {@code null}
+     * @return this {@code AudioOptions} instance for method chaining
+     */
+    public AudioOptions setVoiceGender(VoiceGender voiceGender) {
+        this.voiceGender = voiceGender;
+        return this;
+    }
+
     /**
      * Converts the configured options into HTTP parameters
      * to be sent to the LARA audio translation endpoint.
@@ -122,6 +141,7 @@ public HttpParams<Object> toParams() {
         params.set("adapt_to", adaptTo);
         params.set("glossaries", glossaries);
         params.set("style", TranslationStyle.toString(style));
+        params.set("voice_gender", VoiceGender.toString(voiceGender));
 
         return params;
     }

src/main/java/com/translated/lara/translator/VoiceGender.java

@@ -0,0 +1,28 @@
+package com.translated.lara.translator;
+
+/**
+ * Voice gender for audio translation synthesis.
+ */
+public enum VoiceGender {
+
+    MALE("male"),
+    FEMALE("female");
+
+    private final String value;
+
+    VoiceGender(String value) {
+        this.value = value;
+    }
+
+    @Override
+    public String toString() {
+        return value;
+    }
+
+    /**
+     * Returns the API string value for the given gender, or null if null.
+     */
+    public static String toString(VoiceGender gender) {
+        return gender != null ? gender.toString() : null;
+    }
+}