前提條件

• 完成注冊阿里云賬號，并完成企業實名認證。具體操作，請參見注冊阿里云賬號和企業實名認證。

• 開通語音服務。具體操作。請參見開通服務。

• 獲取AccessKey。具體操作，請參見獲取AccessKey。

• 購買號碼。具體操作，請參見真實號管理。

• 創建文本轉語音模板或上傳語音文件。具體操作，請參見創建文本轉語音模板和通過控制臺上傳語音文件。

入參列表

出參列表

技術對接步驟

1. 下載SDK工具包

   • SDK工具包中一共包含了2個類庫，一個aliyun-java-sdk-core包，另外一個是alicom-dyvms-api包，將這兩個包執行mvn package命令或者mvn deploy命令打包出相應的jar包，添加到工程類庫中依賴使用。

   • SDK&DEMO下載地址，請參見SDK&DEMO下載。

2. 編寫樣例程序

   說明

   調用接口前，需配置環境變量，通過環境變量讀取訪問憑證。AccessKey ID和AccessKey Secret的環境變量名：VMS_AK_ENV 、VMS_SK_ENV。配置詳情請參見配置訪問憑證。

           //設置訪問超時時間
           System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
           System.setProperty("sun.net.client.defaultReadTimeout", "10000");
   
           //云通信產品-語音API服務產品名稱（產品名固定，無需修改）
           final String product = "Dyvmsapi";
           //產品域名（接口地址固定，無需修改）
           final String domain = "dyvmsapi.aliyuncs.com";
           // 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
           // 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
           // 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
           String accessKeyId = System.getenv("VMS_AK_ENV");
           String accessKeySecret = System.getenv("VMS_SK_ENV");
   
           //初始化acsClient 暫時不支持多region
           IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
           DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
           IAcsClient acsClient = new DefaultAcsClient(profile);
   
           SingleCallByTtsRequest request = new SingleCallByTtsRequest();
           //必填-被叫顯號,可在語音控制臺中找到所購買的顯號
           request.setCalledShowNumber("0256000****");
           //必填-被叫號碼
           request.setCalledNumber("150000****");
           //必填-Tts模板ID
           request.setTtsCode("TTS_000000");
            //可選-當模板中存在變量時需要設置此值
           request.setTtsParam("{\"code\":\"123456\"}");
           //可選-音量取值范圍 0--200
           request.setVolume(100);
           //可選-播放次數
           request.setPlayTimes(3);
           //可選-外部擴展字段,此ID將在回執消息中帶回給調用方
           request.setOutId("yourOutId");
   
           //hint 此處可能會拋出異常，注意catch
           SingleCallByTtsResponse singleCallByTtsResponse = acsClient.getAcsResponse(request);
   
           if(singleCallByTtsResponse.getCode() != null && singleCallByTtsResponse.getCode().equals("OK")) {
                    //請求成功
               System.out.println("語音文本外呼---------------");
               System.out.println("RequestId=" + singleCallByTtsResponse.getRequestId());
               System.out.println("Code=" + singleCallByTtsResponse.getCode());
               System.out.println("Message=" + singleCallByTtsResponse.getMessage());
               System.out.println("CallId=" + singleCallByTtsResponse.getCallId());
           }
               

錯誤碼列表