此Java SDK允許您在任何基於JVM的應用程序中使用Vonage API。您需要創建一個Vonage帳戶。
我們還提供其他語言的服務器SDK:
我們還為iOS,Android和JavaScript提供客戶端SDK。查看我們在Vonage開發人員門戶網站上的所有SDK和集成。
發布發行給Maven Central。您的構建系統的說明可以在“摘要”部分中找到。我們強烈建議您使用支持依賴性管理的工具,例如Maven,Gradle或Ivy。
每個版本的發行說明都可以在ChangElog中找到。
或者,您可以克隆回購併自己構建JAR文件:
git clone [email protected]:vonage/vonage-java-sdk.git
mvn install -P uberjar
uberjar
配置文件將創建一個JAR文件,其中包含的SDK所需的所有依賴項,可以在target
目錄中找到。 install
目標將使您的本地Maven存儲庫中的SDK及其依賴關係可用(通常位於您的~/.m2
目錄下),然後可以從機器上本地的其他項目中使用。要在Gradle項目中使用它,您需要包括依賴關係坐標,然後將mavenLocal()
添加到build.gradle
文件中的repositories
庫中。
對於默認配置,您只需要使用API密鑰和秘密,私有密鑰和應用程序ID或兩者指定Vonage帳戶憑據。為了最大程度地兼容所有API,建議您指定這兩種身份驗證方法,例如:
VonageClient client = VonageClient . builder ()
. applicationId ( APPLICATION_ID )
. privateKeyPath ( PRIVATE_KEY_PATH )
. apiKey ( API_KEY )
. apiSecret ( API_SECRET )
. build ();
默認情況下,客戶端將使用https://api.nexmo.com,https://rest.nexmo.com,https://api-eu.vonage.com和https://video.api.api. vonage.com作為各種端點的基礎uris。要自定義這些,您可以使用HttpConfig
對象實例化VonageClient
。
已經創建了HttpConfig.Builder
來協助構建此對象。用法如下:
HttpConfig httpConfig = HttpConfig . builder ()
. apiBaseUri ( "https://api.example.com" )
. restBaseUri ( "https://rest.example.com" )
. apiEuBaseUri ( "https://api-eu.example.com" )
. videoBaseUri ( "https://video.example.com" )
. build ();
VonageClient client = VonageClient . builder ()
. apiKey ( API_KEY ). apiSecret ( API_SECRET )
. httpConfig ( httpConfig )
. build ();
如果您不指定屬性,則將採用默認值為的任何內容。您還可以使用一種方法設置所有三個方法:
HttpConfig httpConfig = HttpConfig . builder (). baseUri ( "http://example.com" ). build ();
VonageClient client = VonageClient . builder ()
. apiKey ( API_KEY ). apiSecret ( API_SECRET )
. httpConfig ( httpConfig )
. build ();
默認情況下,SDK的請求有1分鐘的超時。您可以使用HttpConfig
更改它為更長或更短。以下示例將其設置為12秒:
VonageClient client = VonageClient . builder ()
. applicationId ( APPLICATION_ID )
. privateKeyPath ( PRIVATE_KEY_PATH )
. httpConfig ( HttpConfig . builder (). timeoutMillis ( 12_000 ). build ())
. build ();
問: com.vonage:client
?
答:避免與我們的各種客戶端SDK混淆,該服務器端SDK已從com.vonage:client
坐標轉移到com.vonage:server-sdk
。舊的Artifactid( com.vonage:client
)將無法獲得進一步的更新。所有用戶都應遷移到新的Artifactid。請注意,SDK在功能上是相同的,它只是Maven Central上的名稱空間更改。
問:您對線程安全的政策是什麼?
答: SDK的當前體系結構意味著一次只能使用客戶端。如果您想在多線程環境中使用SDK,請為每個線程創建一個單獨的VonageClient
實例。
問:此SDK是否支持異步請求 /響應處理?
答:目前沒有,但在路線圖上。
問:我如何從圖錶盒遷移到Vonage?
答:請參閱《 Opentok遷移指南》。
我們為這個圖書館做出了貢獻!
如果您打算添加任何新功能,最好先與我們交談。否則,始終對圖書館的錯誤報告,錯誤修復和反饋表示讚賞。