Java SDK นี้ช่วยให้คุณใช้ VONAGE APIs ในแอปพลิเคชันที่ใช้ JVM ใด ๆ คุณจะต้องสร้างบัญชี Vonage
นอกจากนี้เรายังให้เซิร์ฟเวอร์ SDKs ในภาษาอื่น ๆ :
นอกจากนี้เรายังเสนอ SDKs ฝั่งไคลเอ็นต์สำหรับ iOS, Android และ JavaScript ดู SDKs และการบูรณาการทั้งหมดของเราในพอร์ทัล Vonage Developer Portal
เผยแพร่จะเผยแพร่ไปยัง Maven Central คำแนะนำสำหรับระบบบิลด์ของคุณสามารถพบได้ในส่วนตัวอย่าง เรา ขอแนะนำอย่างยิ่ง ให้คุณใช้เครื่องมือที่รองรับการจัดการการพึ่งพาเช่น Maven, Gradle หรือ Ivy
บันทึกย่อสำหรับแต่ละเวอร์ชันสามารถพบได้ใน changelog
หรือคุณสามารถโคลน repo และสร้างไฟล์ jar ด้วยตัวเอง:
git clone [email protected]:vonage/vonage-java-sdk.git
mvn install -P uberjar
โปรไฟล์ uberjar
จะสร้างไฟล์ JAR ที่มีการพึ่งพาทั้งหมดที่จำเป็นในการเรียกใช้ SDK รวมซึ่งสามารถพบได้ในไดเรกทอรี target
เป้าหมาย install
จะทำให้ SDK และการพึ่งพาของมันมีอยู่ในที่เก็บ Maven ในพื้นที่ของคุณ (โดยปกติจะอยู่ภายใต้ไดเรกทอรี ~/.m2
ของคุณ) ซึ่งสามารถนำมาใช้จากโครงการอื่น ๆ ในเครื่องของคุณ ในการใช้สิ่งนี้ในโครงการ Gradle คุณจะต้องรวมพิกัดการพึ่งพาและเพิ่ม mavenLocal()
ลงในบล็อก repositories
ในไฟล์ build.gradle
ของคุณ
สำหรับการกำหนดค่าเริ่มต้นคุณเพียงแค่ต้องระบุข้อมูลรับรองบัญชี VONAGE ของคุณโดยใช้คีย์ API และความลับคีย์ส่วนตัวและรหัสแอปพลิเคชันหรือทั้งสองอย่าง สำหรับความเข้ากันได้สูงสุดกับ 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.vonage.com เป็นฐาน Uris สำหรับจุดสิ้นสุดต่างๆ ในการปรับแต่งสิ่งเหล่านี้คุณสามารถสร้างอินสแตนซ์ VonageClient
ด้วยวัตถุ HttpConfig
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 นี้สนับสนุนการประมวลผลคำขอ / ตอบกลับแบบอะซิงโครนัสหรือไม่?
ตอบ: ปัจจุบันไม่ แต่อยู่บนแผนงาน
ถาม: ฉันจะย้ายจาก tokbox ไปยัง Vonage ได้อย่างไร?
ตอบ: ดูคู่มือการย้ายถิ่นของ Opentok
เรามีส่วนร่วมในห้องสมุดนี้!
เป็นความคิดที่ดีที่จะพูดคุยกับเราก่อนหากคุณวางแผนที่จะเพิ่มฟังก์ชั่นใหม่ ๆ มิฉะนั้นรายงานข้อผิดพลาดการแก้ไขข้อผิดพลาดและข้อเสนอแนะเกี่ยวกับไลบรารีจะได้รับการชื่นชมเสมอ