vonage java sdk

Vonage Server SDK لـ Java

يتيح لك Java SDK استخدام واجهات برمجة تطبيقات Vonage في أي تطبيق قائم على JVM. ستحتاج إلى إنشاء حساب vonage.

• واجهات برمجة التطبيقات المدعومة
• SDKs الأخرى
• تثبيت
• الاستخدام
• إعدادات
• التعليمات
• يساهم!

واجهات برمجة التطبيقات المدعومة

• حساب
• طلب
• محادثة
• تحويل
• رسائل
• عدد البصيرة
• إدارة الأرقام
• التحقق من العدد
• تنقص
• SIM مبادلة
• رسالة قصيرة
• الحسابات الفرعية
• يؤكد
• فيديو
• صوت

SDKs أخرى

نحن نوفر أيضًا SDKs الخادم بلغات أخرى:

• كوتلين
• .شبكة
• PHP
• بيثون
• روبي
• Nodejs

نقدم أيضًا SDKs من جانب العميل لنظام التشغيل iOS و Android و JavaScript. شاهد جميع SDKs وتكاملنا على بوابة مطور Vonage.

تثبيت

يتم نشر الإصدارات إلى Maven Central. يمكن العثور على تعليمات لنظام الإنشاء في قسم المقتطفات. نوصي بشدة باستخدام أداة تدعم إدارة التبعية ، مثل Maven أو Gradle أو Ivy.

يمكن العثور على ملاحظات الإصدار لكل إصدار في Changelog.

قم ببناءها بنفسك

بدلاً من ذلك ، يمكنك استنساخ الريبو وبناء ملف الجرة بنفسك:

git clone [email protected]:vonage/vonage-java-sdk.git
mvn install -P uberjar

سيقوم ملف تعريف uberjar بإنشاء ملف جرة مع جميع التبعيات المطلوبة لتشغيل SDK المضمنة ، والتي يمكن العثور عليها في الدليل target . سيجعل هدف install SDK وتبعياته متوفرة في مستودع Maven المحلي (عادةً ما يكون موجودًا تحت دليل ~/.m2 ) ، والذي يمكن استخدامه بعد ذلك من مشاريع أخرى محليًا على جهازك. لاستخدام هذا في مشروع Gradle ، تحتاج إلى تضمين تنسيقات التبعية وإضافة mavenLocal() إلى كتلة repositories في ملف build.gradle .

الاستخدام

• للمساعدة في فهم واجهات برمجة التطبيقات لدينا ، تحقق من بوابة المطورين الرائعة لدينا.
• تحقق من Javadoc للحصول على الوثائق المرجعية الكاملة.
• هناك أيضًا العديد من عينات التعليمات البرمجية المفيدة في مستودع Vonage/Vonage-Java-Code-Snippets.
• للحصول على تعليمات استخدام API للفيديو ، راجع الدليل على بوابة المطورين الخاصة بنا.

إعدادات

مثيل نموذجي

بالنسبة للتكوين الافتراضي ، تحتاج فقط إلى تحديد بيانات اعتماد حساب Vonage الخاصة بك باستخدام مفتاح API و Secret و Secret Key ومعرف التطبيق أو كليهما. للحصول على أقصى قدر من التوافق مع جميع واجهات برمجة التطبيقات ، يوصى بتحديد كل من طرق المصادقة ، مثل ذلك:

 VonageClient client = VonageClient . builder ()
        . applicationId ( APPLICATION_ID )
        . privateKeyPath ( PRIVATE_KEY_PATH )
        . apiKey ( API_KEY )
        . apiSecret ( API_SECRET )
        . build ();

تخصيص قاعدة URI

افتراضيًا ، سيستخدم العميل 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 مهلة مدتها دقيقة واحدة للطلبات. يمكنك تغيير هذا ليكون أطول أو أقصر باستخدام HttpConfig . المثال التالي يعين هذا إلى 12 ثانية:

 VonageClient client = VonageClient . builder ()
        . applicationId ( APPLICATION_ID )
        . privateKeyPath ( PRIVATE_KEY_PATH )
        . httpConfig ( HttpConfig . builder (). timeoutMillis ( 12_000 ). build ())
        . build ();

الأسئلة المتداولة

س: ماذا حدث لـ com.vonage:client ؟

ج: لتجنب الالتباس مع مختلف SDKs من جانب العميل ، تم نقل SDK من جانب الخادم هذا من com.vonage:client إلى com.vonage:server-sdk . لن يتلقى القطع الأثرية القديمة ( com.vonage:client ) المزيد من التحديثات. يجب على جميع المستخدمين الانتقال إلى القطع الأثرية الجديدة. يرجى ملاحظة أن SDK هو نفسه وظيفيًا ، إنه مجرد تغيير في مساحة الاسم على Maven Central.

س: ما هي سياستك بشأن سلامة الموضوع؟

ج: تعني الهندسة المعمارية الحالية لـ SDK أن مؤشر ترابط واحد فقط يجب أن يستخدم العميل في وقت واحد. إذا كنت ترغب في استخدام SDK في بيئة متعددة مؤشرات الترابط ، فقم بإنشاء مثيل منفصل من VonageClient لكل موضوع.

س: هل يدعم هذا SDK معالجة الطلب / الاستجابة غير المتزامن؟

ج: حاليا لا ، لكنه على خريطة الطريق.

س: كيف يمكنني الترحيل من Tokbox إلى Vonage؟

ج: انظر دليل ترحيل Opentok.

يساهم!

نحن المساهمات في هذه المكتبة!

من الجيد التحدث إلينا أولاً إذا كنت تخطط لإضافة أي وظيفة جديدة. خلاف ذلك ، يتم تقدير تقارير الأخطاء وإصلاحات الأخطاء والتعليقات على المكتبة دائمًا.

اتصال