عميل Zoom Meeting SDK لعرض الويب

# Zoom Meeting SDK الويب - عرض العميل

تجربة اجتماع Zoom كاملة الصفحة مضمنة في تطبيق الويب الخاص بك. يوفر عرض العميل واجهة Zoom المألوفة مع الحد الأدنى من التخصيص المطلوب.

## نظرة عامة

يستخدم عرض العميل كائن `ZoomMtg` العام الفردي لتقديم تجربة اجتماع كاملة الصفحة مطابقة لعميل Zoom الويب.

| الجانب | التفاصيل | |--------|---------| | **كائن API** | `ZoomMtg` (كائن فردي عام) | | **نمط API** | مبني على رد الاتصال | | **الواجهة** | استحواذ كامل الصفحة | | **معامل كلمة المرور** | `passWord` (W كبيرة) | | **الأحداث** | `inMeetingServiceListener()` | | **الأفضل لـ** | التكامل السريع، واجهة Zoom القياسية |

## التثبيت

### NPM

```bash npm install @zoom/meetingsdk --save ```

```javascript import { ZoomMtg } from '@zoom/meetingsdk'; ```

### CDN

```html <script src="https://source.zoom.us/{VERSION}/lib/vendor/react.min.js"></script> <script src="https://source.zoom.us/{VERSION}/lib/vendor/react-dom.min.js"></script> <script src="https://source.zoom.us/{VERSION}/lib/vendor/redux.min.js"></script> <script src="https://source.zoom.us/{VERSION}/lib/vendor/redux-thunk.min.js"></script> <script src="https://source.zoom.us/{VERSION}/lib/vendor/lodash.min.js"></script> <script src="https://source.zoom.us/zoom-meeting-{VERSION}.min.js"></script> ```

## سير التهيئة الكامل

```javascript // الخطوة 1: التحقق من توافق المتصفح console.log('Requirements:', ZoomMtg.checkSystemRequirements());

// الخطوة 2: تعيين مسار CDN (اختياري - للصين أو الاستضافة المخصصة) // ZoomMtg.setZoomJSLib('https://source.zoom.us/{VERSION}/lib', '/av');

// الخطوة 3: تحميل وحدات WebAssembly مسبقا ZoomMtg.preLoadWasm(); ZoomMtg.prepareWebSDK();

// الخطوة 4: تحميل موارد اللغة ZoomMtg.i18n.load('en-US'); ZoomMtg.i18n.onLoad(() => { // الخطوة 5: تهيئة SDK ZoomMtg.init({ leaveUrl: '/meeting-ended', patchJsMedia: true, disableCORP: !window.crossOriginIsolated, success: () => { console.log('SDK initialized'); // الخطوة 6: الانضمام إلى الاجتماع const joinPayload = { signature: signature, meetingNumber: meetingNumber, userName: userName, passWord: passWord, success: (res) => { console.log('Joined meeting');

// الخطوة 7: العمليات بعد الانضمام ZoomMtg.getAttendeeslist({}); ZoomMtg.getCurrentUser({ success: (res) => console.log('Current user:', res.result.currentUser) }); }, error: (err) => console.error('Join failed:', err) };

// مهم: قم بتضمين الحقول الاختيارية فقط عند وجود قيم حقيقية // قد يؤدي تمرير undefined لبعض الحقول الاختيارية إلى أخطاء الانضمام في وقت التشغيل if (userEmail) joinPayload.userEmail = userEmail; if (tk) joinPayload.tk = tk; if (zak) joinPayload.zak = zak;

ZoomMtg.join(joinPayload); }, error: (err) => console.error('Init failed:', err) }); }); ```

## ZoomMtg.init() - جميع الخيارات

### مطلوب

| المعامل | النوع | الوصف | |--------|-------|-------| | `leaveUrl` | `string` | عنوان URL للإعادة بعد مغادرة الاجتماع |

### تخصيص الواجهة

| المعامل | النوع | القيمة الافتراضية | الوصف | |--------|-------|---------|-------| | `showMeetingHeader` | `boolean` | `true` | إظهار رقم الاجتماع والموضوع | | `disableInvite` | `boolean` | `false` | إخفاء زر الدعوة | | `disableCallOut` | `boolean` | `false` | إخفاء خيار الاتصال | | `disableRecord` | `boolean` | `false` | إخفاء زر التسجيل | | `disableJoinAudio` | `boolean` | `false` | إخفاء خيار الانضمام إلى الصوت | | `disablePreview` | `boolean` | `false` | تخطي معاينة الصوت والفيديو | | `audioPanelAlwaysOpen` | `boolean` | `false` | إبقاء لوحة الصوت مفتوحة | | `showPureSharingContent` | `boolean` | `false` | منع التراكب على المحتوى المشترك | | `videoHeader` | `boolean` | `true` | إظهار رأس بطاقة الفيديو | | `isLockBottom` | `boolean` | `true` | إظهار/إخفاء التذييل | | `videoDrag` | `boolean` | `true` | تفعيل سحب بطاقات الفيديو | | `sharingMode` | `string` | `'both'` | `'both'` أو `'fit'` | | `screenShare` | `boolean` | `true` | تفعيل مشاركة عنوان URL للمتصفح | | `hideShareAudioOption` | `boolean` | `false` | إخفاء خانة اختيار "مشاركة صوت التبويب" | | `disablePictureInPicture` | `boolean` | `false` | تعطيل وضع الصورة في الصورة | | `disableZoomLogo` | `boolean` | `false` | إزالة شعار Zoom (غير موصى به) | | `defaultView` | `string` | `'speaker'` | `'gallery'` أو `'speaker'` أو `'multiSpeaker'` |

### تبديلات الميزات

| المعامل | النوع | القيمة الافتراضية | الوصف | |--------|-------|---------|-------| | `isSupportAV` | `boolean` | `true` | تفعيل الصوت والفيديو | | `isSupportChat` | `boolean` | `true` | تفعيل الدردشة أثناء الاجتماع | | `isSupportQA` | `boolean` | `true` | تفعيل الأسئلة والأجوبة في الندوة | | `isSupportCC` | `boolean` | `true` | تفعيل التسميات التوضيحية المغلقة | | `isSupportPolling` | `boolean` | `true` | تفعيل الاستطلاعات | | `isSupportBreakout` | `boolean` | `true` | تفعيل غرف المناقشة | | `isSupportNonverbal` | `boolean` | `true` | تفعيل التعليقات غير اللفظية | | `isSupportSi` | - | - | - |