المقدمة
يصف هذا المستند خطوات تكوين تسلسلات DTMF للسماح للمستخدمين بتنفيذ الإجراءات على مساحات Cisco Meeting Server (CMS).
المتطلبات الأساسية
المتطلبات
توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:
- خادم الاجتماعات من Cisco
- DTMF
المكونات المستخدمة
تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:
- Cisco Meeting Server الذي يشغل البرنامج، الإصدار 3.8
تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.
معلومات أساسية
من الممكن تعريف تسلسلات DTMF المخصصة في CMS للمشاركين في الفضاء لاستخدامها في إستدعاء الإجراءات التي تؤثر على المساحة والمشاركين فيها. على سبيل المثال، يمكن إستخدام تسلسل DTMF من قبل المشارك لتبديل كتم الصوت الخاص به، لبدء أو إيقاف تشغيل الاجتماع، أو إنهاء الاجتماع.
يقوم DtmfProfile بتعريف تسلسلات DTMF التي سيتم إستخدامها لاستدعاء كل إجراء محدد متوفر. من خلال تعيين ملف تعريف dtmf إلى النظام/ملفات التعريف عبر واجهة برمجة تطبيقات CMS، تصبح تسلسلات DTMF متوفرة بشكل عام. يمكن ضبط القيود الخاصة بإجراءات DTMF عن طريق إنشاء CallLegProfile بأذونات مختلفة لكل إجراء، وبتطبيقها على مستويات مختلفة من واجهة برمجة التطبيقات.
التكوين
1. إنشاء كائن dtmfProfile وتطبيقه بشكل عام
لإنشاء كائن dtmfProfile:
1. سجل الدخول إلى صفحة إدارة ويب CMS.
2. انتقل إلى التكوين > API.
3. انتقل إلى قسم /API/V1/dtmfProfile وقم بتوسيعه.
4. انقر فوق إنشاء جديد.
5. قم بتحديد تسلسلات DTMF ليتم إستخدامها لتنفيذ الإجراء (الإجراءات) المطلوبة. في هذا المثال، يتم تعريف تسلسلات DTMF للإجراءات switteMuteSelfAudio وendCall.
6. انقر فوق إنشاء.
لتطبيق dtmfProfile بشكل عام:
1. انتقل إلى التكوين > API.
2. انتقل إلى قسم /API/V1/system/profile وقم بتوسيعه.
3. انقر فوق عرض أو تحرير.
4. في إعداد dtmfProfile، انقر إختيار وحدد الكائن الذي تم إنشاؤه مسبقا.
5. انقر فوق تعديل.
2. أذونات الضبط الدقيق لتنفيذ إجراءات DTMF
يمكن تحقيق التحكم متعدد المستويات في الأذونات لتنفيذ إجراء DTMF من خلال تكوين CallLegProfile، والذي يمكن تطبيقه على مستويات مختلفة في واجهة برمجة التطبيقات (API). يوضح هذا المخطط جميع المستويات الممكنة:
يحدد المستوى الذي يتم فيه تطبيق CallLegProfile نطاقه. تتجاوز ملفات التعريف المعينة في المستويات الأدنى تلك المحددة أعلاه. توضح هذه الأمثلة كيف يمكن إستخدام هذا المبدأ للسماح باستدعاء إجراءات DTMF إلى مساحات أو مستخدمين معينين فقط.
السماح بالعمليات في مساحة معينة فقط
يمكن إنشاء أذونات CallLegProfile السلبية لتنفيذ إجراءات DTMF وتطبيقها على مستوى /النظام/ملفات التعريف. بعد ذلك، يمكن إنشاء LegProfile آخر يسمح بالإجراءات وتطبيقها على مستوى CoSpace، وبالتالي تحديد نطاق الأذونات على CoSpace محدد (أو مجموعة من CoSpaces، إذا تم تطبيقها على عدة).
1. انتقل إلى التكوين > API.
2. انتقل إلى قسم /API/V1/CallLegProfile وقم بتوسيعه.
3. انقر فوق إنشاء جديد.
4. انتقل إلى الإجراءات التي يجب عدم السماح بها، وقم بتعيينها إلى خطأ.
5. انقر فوق إنشاء.
في هذا المثال، تم إنشاء callLegProfile لعدم السماح بإنهاء الاجتماع بتعيين endCallAllowed إلى false:
تلميح: إذا كان CallLegProfile مناسبا موجودا بالفعل، يمكن تعديله بدلا من إنشاء ملف تعريف جديد.
6. قم بتعيينها على النظام/ملف التعريف لمنع الإجراء بشكل عام:
7. قم بإنشاء CallLegProfile جديد هذه المرة للسماح بالإجراء. في هذا المثال، تم إنشاء callLegProfile مع تعيين endCallAllowed إلى true:
8. انتقل إلى التكوين > API>/API/V1/coSpaces وقم بتوسيعه.
9. ابحث عن CoSpace الذي تريد تعيينه له، وتحت callLegProfile، أختر الذي أنشأته للسماح بالإجراءات.
بما أن CallLegProfile هذا يتم تطبيقه على مستوى واجهة برمجة تطبيقات أقل، فإنه يتجاوز CallLegProfile الذي كان مطبقا سابقا على /system/profile، مما ينتج عنه إستدعاء إجراءات DTMF من CoSpace المعين فقط.
السماح فقط للمستخدمين الذين لديهم كلمة مرور بتنفيذ الإجراءات
يمكن تضييق نطاق الأذونات لمجموعة من المستخدمين الذين يحتاجون إلى حقوق خاصة مثل مشغلي الفيديو. يمكن إنشاء accessMethod، مع رقم الدليل الخاص به، للوصول إلى coSpace مع تطبيق callLegProfile محدد يسمح بإجراءات DTMF.
1. انتقل إلى التكوين > API>/API/V1/coSpaces وقم بتوسيعه.
2. من القائمة، أختر CoSpace الذي تريد إنشاء AccessMethod له.
3. من قائمة الكائنات ذات الصلة، انقر فوق الارتباط /API/V1/coSpaces/<coSpace ID>/accessMethods:
4. في حقل uri، أدخل رقما للمستخدمين المتميزين للطلب في هذا الفضاء.
5. إنشاء رمز مرور. عندما يطلب المستخدمون المتميزون رقم AccessMethod، يحتاجون إلى إدخال هذا الرمز متبوعا بعلامة # لكي يتم السماح لهم بالدخول إلى الاجتماع.
6. تحت CallLegProfile، أختر الذي يسمح بإنهاء المكالمة.
7. بشكل إختياري، أدخل اسما ل AccessMethod ليسهل التعرف عليه من داخل مستكشف واجهة برمجة التطبيقات.
في هذا المثال، يتم إنشاء AccessMethod بالرقم 3001 لمشغلي الفيديو لاستخدامها عند الانضمام إلى coSpace (تم تعيين رقم الدليل 3000 إلى coSpace، ويطلب المستخدمون العاديون هذا الرقم للانضمام إلى الاجتماعات على هذه المساحة). وهو محمي بكلمة مرور، ويتم تعيين CallLegProfile الذي يسمح بإنهاء المكالمة له بشكل خاص.
8. تطبيق CallLegProfile الذي لا يسمح بالإجراءات بشكل عام من خلال تكليفه بالنظام/ملفات التعريف.
في هذا المثال، لا توجد حاجة لتعيين CallLegProfile إلى CoSpace نفسه. يرث ملف التعريف المطبق بشكل عام، وبالتالي لا يملك المستخدمون الذين ينضمون إلى الاجتماع بطلب رقم coSpace (3000) الإذن لإنهاء المكالمة عبر DTMF.
نتيجة لهذا التكوين، يمكن لمشغلي الفيديو الانضمام إلى الاجتماع من خلال طلب رقم accessMethod (3001) بدلا من رقم coSpace (3000). تستخدم أدوات الاتصال الخاصة بهم CallLegProfile الذي يسمح بتطبيق الإجراء، وبالتالي يمكنهم فقط إستخدام تسلسل DTMF المحدد لإنهاء المكالمة.
معلومات ذات صلة
الدليل المرجعي لواجهة برمجة التطبيقات CMS 3.8