كيفية استخدام وحدة التكبير

تسمح وحدة Zoom بالعمل مع Zoom API ( https://marketplace.zoom.us/docs/guides/ ).

تركيب Zoom Module

يلزم استرداد API Key Secret Key لتطبيق Zoom الخاص بك أولاً ( https://marketplace.zoom.us/develop/create؟source=devdocs ). بعد الرابط ، سترى عدة أنواع من تطبيقات Zoom للاختيار.

سيظهر API Key Secret Key لتطبيق Zoom بعد اختيار نوع التطبيق.

نماذج بيانات MeetingRecurrence

عند تثبيت وحدة Zoom ، يتم أيضًا إنشاء نموذجين افتراضيين للبيانات في المشروع: Meeting Recurrence . يشير الأول إلى كائن مكالمة الفيديو نفسه ، ويكون Recurrence مسؤولاً عن انتظام (تكرار) اجتماع الفيديو هذا. تعتبر BPs التالية مساعدة في إنشاء واستخدام نماذج البيانات هذه:

• Make Zoom Meeting - يقوم بإنشاء كائن من نوع نموذج بيانات Meeting :
  • Join_url [ string ] - رابط الاجتماع ؛
  • start_time [ datetime ] - وقت بدء الاجتماع ؛
  • Status [ string ] - حالة الاجتماع ؛
  • Type [ enum ] - نوع الاجتماع
    • Instant - غير مجدول ، اجتماع لمرة واحدة
    • Scheduled - اجتماع مجدول
    • Recurring with no fixed time - اجتماع متكرر بدون وقت محدد
    • Recurring with fixed time - متكرر بوقت ثابت
  • Meeting_id [ integer ] - معرف الاجتماع ؛
  • Agenda [ string ] - معلومات جدول أعمال الاجتماع ؛
  • Topic [ string ] - موضوع الاجتماع؛
  • Recurrence [نوع recurrence للكائن] - كائن من نوع نموذج بيانات Recurrence ؛
  • Password [ string ] - كلمة مرور الاجتماع ؛

• Expand Zoom Meeting - لتوسيع كائن من نوع نموذج بيانات Meeting ؛
  • Join_url [ string ] - رابط الاجتماع ؛
  • start_time [ datetime ] - وقت بدء الاجتماع ؛
  • Status [ string ] - حالة الاجتماع ؛
  • Type [ enum ] - نوع الاجتماع
    • Instant - غير مجدول ، اجتماع لمرة واحدة
    • Scheduled - اجتماع مجدول
    • Recurring with no fixed time - اجتماع متكرر بدون وقت محدد
    • Recurring with fixed time - متكرر بوقت ثابت
  • Meeting_id [ integer ] - معرف الاجتماع ؛
  • Agenda [ string ] - معلومات جدول أعمال الاجتماع ؛
  • Topic [ string ] - موضوع الاجتماع؛
  • Recurrence [نوع recurrence للكائن] - كائن من نوع نموذج بيانات Recurrence ؛
  • Password [ string ] - كلمة مرور الاجتماع ؛

• Make Zoom Recurrence - إنشاء كائن من نوع نموذج بيانات Recurrence ؛
  • Type [ enum ] - نوع التكرار
    • Daily
    • Weekly
    • Monthly
  • Ends_time [ integer ] - عدد المرات التي سيحدث فيها الاجتماع المتكرر قبل إلغاؤه ، بين القيمة 1 و 50. لا يمكنك استخدام هذا المفتاح مع مفتاح end_date_time .
  • Monthly_day [ integer ] - مطلوب فقط للاجتماعات المتكررة الشهرية. يوم الشهر الذي يقع فيه الاجتماع المتكرر ، بين 1 و 31.
  • Weekly_days [ enum ] - مطلوب فقط للاجتماعات الأسبوعية المتكررة (1 - الاثنين ، 2 - الثلاثاء ، ... ، 7 - الأحد).
  • Repeat_interval [ integer ] - فترة تكرار الاجتماع. لفترة يومية ، بحد أقصى 90 يومًا. لفترة أسبوعية ، بحد أقصى 12 أسبوعًا.
  • End_date_time [ datetime ] - تاريخ ووقت الانتهاء النهائي للاجتماع المتكرر قبل أن يتم إلغاؤه ، بتنسيق UTC. لا يمكنك استخدام هذا المفتاح مع مفتاح end_times .

• Expand Zoom Recurrence - يوسع كائن من نوع نموذج بيانات Recurrence ؛
  • Type [ enum ] - نوع التكرار
    • Daily
    • Weekly
    • Monthly
  • Ends_time [ integer ] - عدد المرات التي سيحدث فيها الاجتماع المتكرر قبل إلغاؤه ، بين القيمة 1 و 50. لا يمكنك استخدام هذا المفتاح مع مفتاح end_date_time .
  • Monthly_day [ integer ] - مطلوب فقط للاجتماعات المتكررة الشهرية. يوم الشهر الذي يقع فيه الاجتماع المتكرر ، بين 1 و 31.
  • Weekly_days [ enum ] - مطلوب فقط للاجتماعات الأسبوعية المتكررة (1 - الاثنين ، 2 - الثلاثاء ، ... ، 7 - الأحد).
  • Repeat_interval [ integer ] - فترة تكرار الاجتماع. لفترة يومية ، بحد أقصى 90 يومًا. لفترة أسبوعية ، بحد أقصى 12 أسبوعًا.
  • End_date_time [ datetime ] - تاريخ ووقت الانتهاء النهائي للاجتماع المتكرر قبل أن يتم إلغاؤه ، بتنسيق UTC. لا يمكنك استخدام هذا المفتاح مع مفتاح end_times .

عمليات الأعمال التي تعمل مع Zoom Module

تتوفر عمليات أعمال وحدة Zoom المثبتة مسبقًا للواجهة الخلفية للتطبيق فقط:

• Zoom: Get meeting - الحصول على كائن الاجتماع بالمعرف المحدد:
  • Meeting_id [ integer ] - معرف الاجتماع ؛

• Zoom: Delete meeting - يحذف سجل الاجتماع من قاعدة DB المحدد ؛
  • Meeting_id [ integer ] (مطلوب) - معرف الاجتماع ؛

• Zoom: Update meeting - تحديث كائن الاجتماع في قاعدة DB المحدد:
  • Meeting_id [ integer ] (مطلوب) - معرف الاجتماع ؛
  • Topic [ string ] - موضوع الاجتماع؛
  • Type [ enum ] - نوع الاجتماع
    • Instant - غير مجدول ، اجتماع لمرة واحدة
    • Scheduled - اجتماع مجدول
    • Recurring with no fixed time - اجتماع متكرر بدون وقت محدد
    • Recurring with fixed time - متكرر بوقت ثابت
  • start_time [ datetime ] - وقت بدء الاجتماع ؛
  • Join_url [ string ] - رابط الاجتماع ؛
  • Password [ string ] - كلمة مرور الاجتماع ؛
  • Agenda [ string ] - معلومات جدول أعمال الاجتماع ؛
  • Recurrence [نوع recurrence للكائن] - كائن من نوع نموذج بيانات Recurrence ؛

• Zoom: Create Meeting - إنشاء كائن من نوع نموذج بيانات Meeting :
  • Type [ enum ] - نوع الاجتماع
    • Instant - غير مجدول ، اجتماع لمرة واحدة
    • Scheduled - اجتماع مجدول
    • Recurring with no fixed time - اجتماع متكرر بدون وقت محدد
    • Recurring with fixed time - متكرر بوقت ثابت
  • Password [ string ] - كلمة مرور الاجتماع ؛
  • Agenda [ string ] - معلومات جدول أعمال الاجتماع ؛
  • Recurrence [نوع recurrence للكائن] - كائن من نوع نموذج بيانات Recurrence ؛
  • User_id [ string ] (مطلوب) - ID المستخدم أو عنوان البريد الإلكتروني.

• Zoom: List meetings - استخدم API هذه لسرد الاجتماعات المجدولة للمستخدم (مضيف الاجتماع). يتم تعريف المستخدم API_KEY الخاصة به ؛
  • Page_size [ integer ] - عدد السجلات التي يتم إرجاعها خلال استدعاء API واحد. تم تعيينه على 30 بشكل افتراضي.
  • Page_number [ integer ] - رقم صفحة الصفحة الحالية في السجلات التي تم إرجاعها. تم تعيينه على 1 افتراضيًا.

مثال على الاستخدام

لنلقِ نظرة على مثال لتوليد رابط اجتماع Zoom عند النقر على الزر. لاستخدام العمليات التجارية للوحدة النمطية في الواجهة الأمامية للتطبيق ، فإن الخطوة الأولى هي تعيين Endpoint لإنشاء إنشاء الارتباط (تكبير / Zoom: Create meeting ).

1. أنشئ مجموعة جديدة في قسم Endpoints .
2. عندما يتم إنشاء المجموعة ، تحتاج إلى إنشاء Endpoint جديدة. Zoom: Create meeting بمثابة نوع طلب POST .
3. في عملية أعمال تطبيق الويب ، يمكن استخدام نقطة النهاية المنشأة حديثًا كما في المثال أدناه. هنا ، يتم إنشاء ارتباط وتقديمه كخاصية Label لمكون Label عند النقر فوق الزر ( onClick ) .

النتيجة مبينة أدناه: