إضافة الاتصال من المتصفح عبر Webphone SDK

استخدم SDK الحالي واحتفظ ببيانات الدخول الدائمة على الخادم واختبر الاتصال بأمان.

البدء بالحزمة والمرجع المدعومين

افتح وثائق API ← Webphone SDK. نزّل الحزمة أو ملفات المتصفح الموثقة واتبع أمثلة الإصدار نفسه. اقرأ تحذيرات الأمان قبل استخدام نسخة قديمة. هذا SDK للويب، وليس بديلاً لتكامل اتصال محمول أصلي.

يجهز المطور تطبيق HTTPS موثّقاً وهوية SIP مسموحة وأذونات ميكروفون وملفات SDK الحالي. يساعد SDK Playground على فحص الحساب والمتصفح، لكن مكالماته حقيقية وقد تُحاسب.

إبقاء بيانات الدخول الدائمة في الخلفية

1. ابدأ في الإنتاج بمثال الرمز المُدار الوارد في المرجع.
2. تتحقق الخلفية من المستخدم والهوية التي يحق له استخدامها.
3. تطلب تفويض المتصفح قصير الأجل بمفتاح API. أعد فقط البيانات المطلوبة للمتصفح، لا المفتاح الدائم.
4. هيئ SDK بهذه البيانات والمثال الحالي. عالج الانتهاء والخروج وأخطاء الاتصال بدلاً من إنشاء جلسات متكررة.

لا تقبل هوية عشوائية من متصفح غير موثّق ولا تتيح إنشاء رموز لحساب آخر. أبقِ المفاتيح وكلمات SIP خارج JavaScript العام والمستودعات والروابط والصور. وضع SIP المباشر بديل متقدم لا مبرر لإرسال أسرار دائمة للواجهة.

إظهار الجاهزية للمستخدم

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

لا تفترض أن SDK يوفر كامل سياسة تعدد الأجهزة. اتبع دورة الاتصال والفصل وأظهر تعارض الجلسات. لا تعرض جلسة منتهية كهاتف نشط. امسح حالة الحساب عند الخروج وهيئ هوية المستخدم الجديد المسموحة لا هوية السابق المخزنة.

إجراء اختبار قبول صغير

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

استخدم وجهات اختبار تملك إذنها وراجع الأسعار ولا تعتبر التكرار مجانياً. لا تجمع أو ترسل تسجيلات دون الإشعارات والتفويض اللازمين.

التشخيص حسب المرحلة

عند فشل التفويض افحص رد الخلفية وصلاحية الهوية دون تسجيل أسرار. عند فشل الإشارات افحص المنطقة وتوافق الشبكة والمتصفح. عند اتصال بلا صوت افحص الأجهزة والإذن ووصول الوسائط. احتفظ بإصداري SDK والمتصفح وخطأ منقح والوقت والمنطقة والمرجع العام للدعم.

مرجع API هو المعتمد للدوال والبيانات وأعمار الرموز. راجع البدء السريع لـAPI لوصول الحساب والطلبات الآمنة.