Add CustomVoiceApi Java sample (#114)

* Add Java Samples
* Fix obvious format and grammar issues
* Manage all dependencies using Maven. Rewrote README.md

Author: baike960

CustomVoice-API-Samples/Java/README.md

@@ -0,0 +1,15 @@
+## Custom Voice API
+
+This project contains samples of HTTP-based Microsoft Custom Voice Synthesis APIs.
+ 
+## Build the samples
+
+1. First, you must obtain a standard (not free) Speech API subscription key by following instructions in Microsoft Cognitive Services subscription.
+2. Make sure that you have Maven installed. Under the directory with the pom file, run the command 'mvn clean install' to install all project dependencies.
+3. Run the VoiceSynthsisMain.java file. You need to pass in arguments of endpoint, ibizaStsUrl, subscriptionKey, localInputTextFile, locale, voiceName and concatenateResult based on the information of the region, your subscription key, your designated voice and your desirable format of output wav file.
+
+## Note:
+
+1.The input text file should be Unicode format with 'UTF-8-BOM' (you can check the text format with your preferred advanced text editor), like the one zh-CN.txt, and should be more than 50 lines.
+2.The voiceId could be acquired from the function getVoiceId() in the java file.
+3.'concatenateResult' is an optional parameter, if not given, the output will be multiple wave files per line.

CustomVoice-API-Samples/Java/en-US.txt

@@ -0,0 +1,50 @@
+This is the waistline , and it's falling .
+Alexis , meet Bill and Hillary , and the rest of America .
+This is Jordan , Scottie Pippen and the ring dynasty .
+The more I looked , the gloomier I got .
+He saw Macbeth , the three witches , and the boiling cauldron .
+But it is good to get together , cook together , eat together and enjoy .
+The priorities , they say , are sofa , blanket , and clothing .
+The metallic walls curve , twist , and turn .
+The seagrass fiber is tough , durable and smooth .
+The dissenters were Stevens , Souter , Ginsburg and Breyer .
+They're also seeing Casey Martin , the golfer .
+Lawrence Weschler , staff writer , The New Yorker .
+And Ronaldo has his dedications to fulfill .
+It's very troubling to me and it should be very troubling to all Americans .
+He has been superb , and nothing changed early in the game .
+The smell of gunsmoke and excrement drifted on the air .
+The dissenters were Breyer , Stevens , Ginsburg and Souter .
+These include fur hats , steel helmets , caps and other badges , and watches .
+The background music and the special decor complete the Latin theme .
+The resident female retorts in kind , piping and pointing .
+I take one pillowcase , and stuff the other pillowcase and both sheets into it .
+The same two crops , and blueberries , are threatened in Georgia .
+The coastline boasts cliffs , caves , bays , and beaches .
+The Bash began in baseball , and it went everywhere .
+Less fit letters are not forwarded , and so die .
+The hijackers had gained entry to the cockpit , and she did not know how .
+They engage in all activities .
+It's miserable , the cigarette business .
+I think it is ridiculous , and I think it's unfair , and I think it's offensive .
+People are born , live , and die on the sidewalks .
+I'm enchanted by the tenants of Buddhism , like reincarnation and the development of the mind .
+Like other visitors , he is a believer .
+The biggest winners are the airlines .
+He controls references to time , place , and location .
+The casino is in a jurisdiction that allows it , and the money is in a jurisdiction that allows it .
+But his weight lifting , bicycling and horseback riding have kept him taut and ready for all comers .
+It's gross during the summer .
+Sometimes the bodies are never identified .
+It was Enron, WorldCom and Global Crossing .
+The rotation is solid , defense is solid , the lineup's solid , the bullpen's solid .
+That helped push crude oil prices higher .
+The farm is in the Catskills , near Worcester , New York .
+No , none whatsoever , and that shopkeeper was right .
+She knows everything and everyone in the town , literally .
+In response , a rock grew taller , pushing the children higher , and higher .
+The industry has been cannibalizing itself .
+The chiffon stretch , the chiffon silk , wool .
+We thank you for your consideration , and look forward to hearing from you .
+Like Philip Barry , Mike , the reporter , is an outsider .
+The language in the settlement is unacceptable .

CustomVoice-API-Samples/Java/pom.xml

@@ -0,0 +1,81 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <groupId>voiceSynthesis</groupId>
+  <artifactId>voiceSynthesis-java</artifactId>
+  <version>0.0.1-SNAPSHOT</version>
+  <packaging>jar</packaging>
+
+  <name>voiceSynthesis-java</name>
+  <url>http://maven.apache.org</url>
+
+  <properties>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <maven.compiler.source>1.7</maven.compiler.source>
+	<maven.compiler.target>1.7</maven.compiler.target>
+  </properties>
+
+
+  <dependencies>
+  <dependency>
+    <groupId>junit</groupId>
+    <artifactId>junit</artifactId>
+    <version>4.12</version>
+    <scope>test</scope>
+</dependency>
+  <dependency>
+    <groupId>com.squareup.okhttp</groupId>
+    <artifactId>logging-interceptor</artifactId>
+    <version>2.7.5</version>
+</dependency>
+  <dependency>
+    <groupId>com.squareup.okhttp</groupId>
+    <artifactId>okhttp</artifactId>
+    <version>2.7.5</version>
+</dependency>
+  <dependency>
+    <groupId>com.squareup.okio</groupId>
+    <artifactId>okio</artifactId>
+    <version>1.6.0</version>
+</dependency>
+  <dependency>
+    <groupId>org.json</groupId>
+    <artifactId>json</artifactId>
+    <version>20180813</version>
+</dependency>
+  <dependency>
+    <groupId>io.swagger</groupId>
+    <artifactId>swagger-annotations</artifactId>
+    <version>1.5.18</version>
+</dependency>
+  <dependency>
+    <groupId>org.threeten</groupId>
+    <artifactId>threetenbp</artifactId>
+    <version>1.3.5</version>
+</dependency>
+  <dependency>
+    <groupId>commons-io</groupId>
+    <artifactId>commons-io</artifactId>
+    <version>2.6</version>
+  </dependency>
+  <dependency>
+    <groupId>com.google.code.gson</groupId>
+    <artifactId>gson</artifactId>
+    <version>2.8.1</version>
+  </dependency>
+  <dependency>
+    <groupId>io.gsonfire</groupId>
+    <artifactId>gson-fire</artifactId>
+    <version>1.8.0</version>
+  </dependency>
+  <dependency>
+    <groupId>org.hamcrest</groupId>
+    <artifactId>hamcrest-core</artifactId>
+    <version>1.3</version>
+    <scope>test</scope>
+  </dependency>
+    
+  </dependencies>
+  
+</project>

CustomVoice-API-Samples/Java/src/main/java/VoiceSynthesisMain.java

@@ -0,0 +1,201 @@
+import java.io.BufferedInputStream;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.net.MalformedURLException;
+import java.net.URI;
+import java.net.URL;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Scanner;
+import java.util.UUID;
+
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import io.swagger.client.ApiException;
+import io.swagger.client.ApiResponse;
+import io.swagger.client.api.VoiceSynthesisApi;
+import io.swagger.client.model.Voice;
+import io.swagger.client.model.VoiceSynthesis;
+import io.swagger.client.model.VoiceSynthesis.StatusEnum;
+import com.squareup.okhttp.Response;
+
+public class VoiceSynthesisMain {
+
+	//Cognitive service link
+    //https://docs.microsoft.com/en-us/azure/cognitive-services/speech-service/rest-apis#authentication
+
+	public static void main(String[] args) throws ApiException, IOException, InterruptedException, JSONException {
+		if(args.length<7) {
+			System.out.println("Not enough arguments. Expected number of arguments is 7.\n"
+					+ "endpoint: i.e. https://centralindia.cris.ai \n"
+					+ "ibizaStsUrl: i.e. https://centralindia.api.cognitive.microsoft.com/sts/v1.0/issueToken \n"
+					+ "subscriptionKey: a standard one acquired from Azure \n"
+					+ "localInputTextFile: i.e. \\Java project\\VoiceSynthsisAPIToJAVA\\en-US.txt \n"
+					+ "locale: i.e. it-IT \n"
+					+ "voiceName: i.e. ElsaNeural \n"
+					+ "concatenateResult: true or false. Whether you want the output file to be one part or multipart. \n"
+					+ "Program exited.");
+			return;
+		}
+		String endpoint =  args[0];
+        String ibizaStsUrl =  args[1];
+        // the Subscription key should be a standard one, not the free one.
+        String subscriptionKey = args[2];
+        // The input text file could contains only plain text or only SSML or mixed together(as shown in blow script)
+        // The input text file encoding format should be UTF-8-BOM
+        // The input text file should contains at least 50 lines of text
+        String localInputTextFile = args[3];
+        
+        String locale = args[4];
+        String voiceName = args[5];
+        if(!new File(localInputTextFile).exists()) {
+        	System.out.println("Input input text file does not exist. Program exited.");
+        	return;
+        }
+        
+        // indicate if want concatenate the output waves with a single file or not. True or false
+        String concatenateResult = args[6];
+		VoiceSynthsisAPIs(endpoint, ibizaStsUrl, subscriptionKey, localInputTextFile, locale, voiceName, concatenateResult);
+
+	}
+	
+	
+	private static void VoiceSynthsisAPIs(String endpoint, String ibizaStsUrl, String subscriptionKey, String
+			localInputTextFile, String locale, String voiceName, String concatenateResult) 
+					throws ApiException, IOException, JSONException, InterruptedException
+    {
+		
+
+
+        final String name = "Simple neural TTS batch synthesis";
+        final String description = "Simple neural TTS batch synthesis description";
+
+        // public voice means the voice could be used by all Subscriptions, if the voice is private(for your Subscription only), this should be set to false
+        boolean isPublicVoice = true;
+
+        // you can directly set the voiceId or query the voice information by name/locale/ispublic properties from server.
+        //var voiceId = new Guid("Your voice model Guid");
+        
+        VoiceSynthesisApi voiceApi=new VoiceSynthesisApi(subscriptionKey, endpoint);
+        
+        UUID voiceId = GetVoiceId( voiceApi, locale, voiceName, isPublicVoice);
+        
+        if (voiceId.getLeastSignificantBits()==0L && voiceId.getMostSignificantBits()==0L)
+        {
+            System.out.println("Does not have a available voice for locale :"+locale+ ", name : "+voiceName+", public : "+isPublicVoice);
+            return;
+        }
+
+        File file=new File(localInputTextFile);
+        // Submit a voice synthesis request and get a ID
+        //URI synthesisLocation = customVoiceAPI.CreateVoiceSynthesis(name, description, locale, localInputTextFile, voiceId, concatenateResult);
+        
+        JSONObject properties = new JSONObject(); 
+        
+        properties.put("ConcatenateResult", concatenateResult); 
+        
+        Response res=voiceApi.NewcreateVoiceSynthesisWithHttpInfo(name, description, locale, voiceId.toString(), properties.toString(),file);
+        List<String> synthesisLocation=res.headers("Location");
+        if(synthesisLocation==null ||synthesisLocation.size()==0) {
+        	System.out.println("No synthesis location returned from server. Program exited.");
+        }
+        String[] seq=synthesisLocation.get(0).toString().split("/");
+        UUID synthesisId = UUID.fromString(seq.length>0?seq[seq.length-1]:"");
+
+        System.out.println("Checking status.");
+        // check for the status of the submitted synthesis every 10 sec. (can also be 1, 2, 5 min depending on usage)
+        boolean completed = false;
+        while (!completed)
+        {
+            //var synthesis = customVoiceAPI.s(synthesisId);
+        	VoiceSynthesis synthesis=voiceApi.getVoiceSynthesis(synthesisId);
+        	
+            switch (synthesis.getStatus().toString())
+            {
+                case "Failed":
+                case "Succeeded":
+                    completed = true;
+                    // if the synthesis was successfull, download the results to local
+                    if (synthesis.getStatus().toString() == "Succeeded")
+                    {
+                        String resultsUri = synthesis.getResultsUrl();
+                        System.out.println(resultsUri);
+                        URL url=new URL(resultsUri);
+                        //WebClient webClient = new WebClient();
+                        //String filename = Path.GetTempFileName()+"_"+synthesis.Id+"_.zip";
+                        //webClient.DownloadFile(resultsUri, filename);
+                        
+                        File filename=File.createTempFile("_"+synthesis.getId()+"_", ".zip");
+                        try (BufferedInputStream inputStream = new BufferedInputStream(url.openStream());  
+                        		  FileOutputStream fileOS = new FileOutputStream(filename)) {
+                        		    byte data[] = new byte[1024];
+                        		    int byteContent;
+                        		    while ((byteContent = inputStream.read(data, 0, 1024)) != -1) {
+                        		        fileOS.write(data, 0, byteContent);
+                        		    }
+                        		} catch (IOException e) {
+                        		    // handles IO exceptions
+                        		}
+                        System.out.println("Synthesis succeeded. Results: "+filename);
+                    }
+                    break;
+
+                case "Running":
+                    break;
+
+                case "NotStarted":
+                    break;
+            }
+
+            System.out.println("Syntheses status: "+ synthesis.getStatus());
+            //await Task.Delay(TimeSpan.FromSeconds(10)).ConfigureAwait(false);
+            Thread.sleep(10*1000L);
+        }
+
+        System.out.println("Press any key...");
+        Scanner input=new Scanner(System.in);
+        input.nextLine();
+    }
+	
+	 private static UUID GetVoiceId( VoiceSynthesisApi voiceApi, String locale, String voiceName, boolean publicVoice) throws ApiException
+     {
+         // Get available voices list
+		 //VoiceSynthesisApi voiceApi=new VoiceSynthesisApi();
+         Iterable<Voice> voices = voiceApi.getSupportedVoicesForVoiceSynthesis();
+         Voice voice = null;
+         List<Voice> list=new ArrayList<>();
+         
+         
+         if (publicVoice)
+         {
+        	 for(Voice v:voices)
+             {
+            	 if( v.getName().contains(voiceName) &&v.getLocale().equals(locale) && v.isIsPublicVoice())
+            		 list.add(v);
+             }
+        	 voice=(list.size()>0)?list.get(0):null;
+        	 
+         }
+         else
+         {
+        	 for(Voice v:voices)
+             {
+            	 if(v.getLocale().equals(locale) && v.getName().contains(voiceName))
+            		 list.add(v);
+             }
+        	 voice=(list.size()>0)?list.get(0):null;
+         }
+         if (voice == null)
+         {
+             System.out.println("Does not have a available voice for locale : "+locale+", name : "+ voiceName+", public : "+publicVoice);
+             return new UUID( 0L , 0L );
+         }
+         return voice.getId();
+     }
+	
+	
+	
+
+}