مقدمة
نظرة عامة
يوضح هذا الدليل كيفية تكوين معلمات الجهاز عبر واجهة برمجة التطبيقات HTTP، بما في ذلك إعدادات خادم SIP، وتفاصيل تسجيل حساب SIP، ومعلمات مفاتيح DSS، وخيارات الجهاز الأخرى. يعمل الجهاز كخادم HTTP، في حين يرسل العميل طلبات HTTP محددة لتطبيق تغييرات التكوين، كما هو موضح في الرسم البياني أدناه.
في هذا المثال، يتم استخدام برنامج Postman لمحاكاة طلبات HTTP المرسلة إلى الجهاز.
الموديلات المعمول بها
جميع موديلات الهواتف المتوفرة حاليًا في خط منتجاتنا.
المتطلبات الأساسية
① جهاز اتصال متبادل BHP-SOS11V واحد، تم ترقيته إلى أحدث إصدار برنامج ثابت متاح ومتصل بمحول شبكة PoE.
② جهاز كمبيوتر واحد لإعداد الإعدادات مثبت عليه برنامج Postman، متصل بنفس المحول الشبكي، مع تأكيد وجود اتصال شبكي طبيعي.
مخطط توصيل الهاتف وجهاز الكمبيوتر
استخدام Postman لمحاكاة طلبات HTTP
تنزيل وتثبيت Postman
قم بتنزيل برنامج Postman من الرابط:
https://www.postman.com/downloads/
ثم اتبع إرشادات التثبيت لإكمال الإعداد.
تكوين Postman
انقر على ملف – جديد، ثم اختر طلب HTTP.
في نافذة الطلب الجديدة، اختر طريقة POST وأدخل عنوان URL HTTP للجهاز بالتنسيق التالي:
http://ip/xmlservice
لاحظ أن عنوان URL حساس لحالة الأحرف. استبدل ip بعنوان IP الفعلي للجهاز، كما هو موضح أدناه.
ثم قم بتكوين معلمات طلب HTTP المطلوبة:
طريقة المصادقة: Basic Auth
الرأس: Content-Type: xml/text
تكوين نص طلب HTTP
انقر على النص، واختر أصلي، ثم أدخل محتوى XML في نص الرسالة. يُعرض التنسيق النموذجي أدناه.
البنية كالتالي:
هذا هو رأس إعلان XML وهو مطلوب في كل طلب.
يحدد هذا بنية أمر XML. يمكن أن تكون سمة cmd إما get لاسترجاع المعلمات الحالية أو set لكتابة معلمات جديدة.
- sip.
يحدد هذا عنصر التكوين الفعلي. في هذا المثال، يسترد الطلب معلمات متعلقة بخط SIP من الجهاز.
في الاستخدام العملي، يجب تعديل القسم التالي وفقًا للمعلمة الفعلية التي تريد الاستعلام عنها أو تكوينها:
- sip.
كيفية الحصول على قائمة المعلمات المدعومة
قد تدعم الموديلات المختلفة معلمات HTTP API مختلفة. يمكنك استخدام إحدى الطريقتين التاليتين للحصول على قائمة المعلمات المدعومة لجهاز معين.
الطريقة 1: في واجهة الويب للجهاز، انتقل إلى النظام – تكوين النظام، ثم قم بتصدير ملف التكوين من النوع nc.
يمكنك النقر بالزر الأيمن لحفظ الملف، أو النقر بالزر الأيسر لعرض التكوين مباشرة. يتم سرد المعلمات الشائعة في القسم التالي.
الطريقة 2: بعض الموديلات لا توفر رابط ملف تكوين nc مباشرة في واجهة الويب. في هذه الحالة، يمكنك إدخال عنوان URL المقابل في شريط عناوين المتصفح لاسترجاع ملف تكوين nc يدويًا.
ملاحظة: قد تستغرق هذه الطريقة وقتًا أطول للاستجابة.
المعلمات الشائعة
يسرد هذا القسم العديد من المعلمات الشائعة للرجوع إليها. قد يتم إضافة المزيد من المعلمات في التحديثات المستقبلية.
معلمات خط SIP
مثال لمعلمات خط SIP (من جهاز التحكم في الوصول i30):
sip.line.1.PhoneNumber = 112
sip.line.1.DisplayName = 112
sip.line.1.SipName =
sip.line.1.RegAddr = 172.18.1.45
sip.line.1.RegPort = 2066
sip.line.1.RegUser = 112
sip.line.1.RegPswd = abc123
sip.line.1.RegTTL = 3600
sip.line.1.RegEnabled = 0
sip.line.1. تشير إلى أن هذه المعلمات تنتمي إلى خط SIP 1.
PhoneNumber يتوافق مع حقل رقم الهاتف في واجهة الويب.
DisplayName يتوافق مع اسم العرض.
RegAddr هو عنوان خادم وكيل SIP.
RegPort هو منفذ خادم وكيل SIP.
RegUser هو اسم مستخدم المصادقة، وعادةً ما يكون مماثلًا لرقم الهاتف.
RegPswd هو كلمة المرور.
RegTTL هو وقت انتهاء صلاحية التسجيل، والقيمة الافتراضية هي 3600 ثانية.
RegEnabled يحدد ما إذا كان الخط مفعلًا: 0 يعني معطلاً، 1 يعني مفعلًا.
معلمات مفاتيح DSS
مثال لمعلمات مفاتيح DSS لجهاز i30:
- dss.page.1.key.1.Type=1
- dss.page.1.key.1.Value=125@1/f
- dss.page.1.key.1.Title=
يوصى بتكوين مفتاح DSS في واجهة الويب أولاً، ثم استخدام HTTP API مع أمر get لقراءة قيم المعلمات المقابلة وتأكيد التعيين الدقيق.
Type=1 تشير إلى أن نوع مفتاح DSS هو مفتاح سريع لأجهزة مثل i30 أو i12. بالنسبة للموديلات الأخرى، تحقق من قيمة النوع الفعلية باستخدام الطريقة الموصى بها أعلاه.
Value=125@1/f تعني:
125 = رقم الوجهة
@1 = الخط 1
/f = النوع الفرعي: اتصال سريع
معلمات الشبكة
مثال لمعلمات الشبكة لأجهزة مثل i30 و i12:
- net.WANMode=DHCP
- net.static.IP=172.18.8.7
- net.static.SubnetMask=255.255.255.0
- net.static.Gateway=172.18.8.1
- net.static.PrimaryDNS=202.96.134.133
- net.static.SecondaryDNS=202.96.128.86
- net.static.DomainName=
- net.dhcp.Enabled=1
WANMode تشير إلى وضع الشبكة، والذي يمكن أن يكون DHCP أو ثابت. لا يمكن كتابة هذه المعلمة مباشرة باستخدام أمر set. فهي تتغير تلقائيًا وفقًا لقيمة dhcp.Enabled.
static.IP هو عنوان IP الثابت. وهو فعال فقط عندما يكون الجهاز في الوضع الثابت. في وضع DHCP، لا يزال يمكن استخدام أمر get لاسترجاع عنوان IP الحالي.
static.SubnetMask هو قناع الشبكة.
static.Gateway هو البوابة الافتراضية.
static.PrimaryDNS هو خادم DNS الأساسي.
static.SecondaryDNS هو خادم DNS الثانوي.
dhcp.Enabled يحدد ما إذا كان DHCP مفعلًا: 1 يعني أن وضع DHCP نشط، بينما 0 يعني استخدام وضع IP الثابت.
معلمات مستوى الصوت
مثال لمعلمات مستوى الصوت لجهاز BHP-SOS11V:
- phone.volume.HandFreeVol=9
- phone.volume.HandFreeRingVol=3
- phone.volume.HandFreeToneVol=3
phone.volume.HandFreeVol هو مستوى صوت مكبر الصوت. النطاق هو 1-9، حيث 9 هو أعلى مستوى صوت.
phone.volume.HandFreeRingVol هو مستوى صوت نغمة الرنين للمكالمات الواردة. النطاق هو 1-9، حيث 9 هو أعلى مستوى صوت.
phone.volume.HandFreeToneVol هو مستوى صوت النغمات للنغمات الإرشادية مثل التنبيهات وأصوات الإخطارات. النطاق هو 1-9، حيث 9 هو أعلى مستوى صوت.
معلمات معلومات النظام
معلمات معلومات النظام للقراءة فقط، أي لا يمكن استعلامها إلا باستخدام أمر get.
مثال:
- info.
تُرجع هذه المعلمة جميع معلومات النظام. إذا كنت تحتاج فقط إلى عنصر معين، فقم بتمديد مسار المعلمة إلى مستوى العقدة التالي.
على سبيل المثال، لاسترجاع عنوان MAC للجهاز:
- info.dev.mac
