أداة Zoom Meeting SDK للويب

# مجموعة أدوات Zoom للاجتماعات (ويب)

قم بتضمين إمكانيات اجتماعات Zoom في تطبيقات الويب بخيارين للتكامل: **Client View** (صفحة كاملة) أو **Component View** (قابلة للتضمين).

## كيفية تطبيق واجهة مستخدم فيديو مخصصة لاجتماع Zoom في تطبيق ويب

استخدم **Meeting SDK Web Component View**.

لا تستخدم Video SDK لهذا السؤال ما لم يكن المستخدم يبني صراحة منتج جلسة فيديو غير اجتماع.

البنية الأساسية:

```text صفحة المتصفح -> جلب توقيع Meeting SDK من الخادم الخلفي -> ZoomMtgEmbedded.createClient() -> client.init({ zoomAppRoot }) -> client.join({ signature, sdkKey, meetingNumber, userName, password }) -> تطبيق خيارات التخطيط والنمط والتخصيص حول حاوية الاجتماع المدمجة ```

التطبيق الأساسي:

```ts import ZoomMtgEmbedded from '@zoom/meetingsdk/embedded';

const client = ZoomMtgEmbedded.createClient();

export async function startEmbeddedMeeting(meetingNumber: string, userName: string, password: string) { const sigRes = await fetch('/api/signature', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ meetingNumber, role: 0 }), });

if (!sigRes.ok) throw new Error(`signature_fetch_failed:${sigRes.status}`);

const { signature, sdkKey } = await sigRes.json();

await client.init({ zoomAppRoot: document.getElementById('meetingSDKElement')!, language: 'en-US', patchJsMedia: true, leaveOnPageUnload: true, customize: { video: { isResizable: true, popper: { disableDraggable: false } }, }, });

await client.join({ signature, sdkKey, meetingNumber, userName, password, }); } ```

نقاط الفشل الشائعة: - المسار الخاطئ: Video SDK بدلا من Meeting SDK Component View - نقطة نهاية التوقيع المفقودة في الخادم الخلفي - حقل كلمة المرور الخاطئ (`password` هنا، وليس `passWord`) - متطلبات OBF/ZAK المفقودة للاجتماعات خارج حساب التطبيق - رؤوس SharedArrayBuffer المفقودة عند توقع ميزات اجتماع عالية المستوى

## قاعدة التوجيه الصارمة

إذا أراد المستخدم **واجهة مستخدم فيديو مخصصة لاجتماع Zoom في تطبيق ويب**، وجه إلى **Component View**، وليس Video SDK.

- **Meeting SDK Component View** = واجهة مستخدم مخصصة لاجتماع Zoom حقيقي - **Video SDK Web** = واجهة مستخدم مخصصة لمنتج جلسة فيديو غير اجتماع

بالنسبة لمسار واجهة المستخدم المخصصة المباشرة للاجتماع، ابدأ بـ [component-view/SKILL.md](component-view/SKILL.md).

## جديد في Web SDK؟ ابدأ من هنا!

**الطريقة الأسرع لإتقان المجموعة:**

1. **اختر عرضك** - [Client View مقابل Component View](#client-view-vs-component-view) - افهم الفروقات المعمارية الرئيسية 2. **البدء السريع** - [Client View](#quick-start-client-view) أو [Component View](#quick-start-component-view) - احصل على اجتماع عامل في دقائق 3. **SharedArrayBuffer** - [concepts/sharedarraybuffer.md](concepts/sharedarraybuffer.md) - مطلوب لفيديو HD وعرض المعرض والخلفيات الافتراضية 4. **تشخيصات الفحص الاختيارية** - [../../probe-sdk/SKILL.md](../../probe-sdk/SKILL.md) - تحقق من المتصفح والجهاز والشبكة قبل الانضمام

**بناء تكامل مخصص؟** - Component View يمنحك API قائم على Promise وواجهة مستخدم قابلة للتضمين - Client View يمنحك تجربة Zoom على الصفحة الكاملة المألوفة - بالنسبة لواجهة مستخدم اجتماع مخصصة، فضل **Component View** أولا - مثال على التوجيه بين المنتجات: [../../general/use-cases/custom-meeting-ui-web.md](../../general/use-cases/custom-meeting-ui-web.md) - [دعم المتصفحات](concepts/browser-support.md) - مصفوفة الميزات حسب المتصفح - مسار الخوض العميق الدقيق: [component-view/SKILL.md](component-view/SKILL.md)

**واجه مشاكل؟** - أخطاء الانضمام → تحقق من توليد التوقيع وتهجئة كلمة المرور (`passWord` مقابل `password`) - فيديو HD لا يعمل → فعل رؤوس SharedArrayBuffer - الملاحة الكاملة → [SKILL.md](SKILL.md)

## المتطلبات الأساسية

- تطبيق Zoom مع بيانات اعتماد Meeting SDK من [Marketplace](https://marketplace.zoom.us/) - SDK Key (معرف العميل) والسر - متصفح حديث (Chrome أو Firefox أو Safari أو Edge) - نقطة نهاية المصادقة في الخادم الخلفي لتوليد التوقيع

> **هل تحتاج إلى مساعدة في المصادقة؟** انظر إلى **[zoom-oauth](../../oauth/SKILL.md)** المهارة لتوليد JWT/التوقيع. > > **هل تريد تشخيصات ما قبل الانضمام؟** ربط **[probe-sdk](../../probe-sdk/SKILL.md)** قبل `init()`/`join()` لحماية البيئات ذات الجاهزية المنخفضة.

## بوابة الفحص الاختيارية (Probe SDK)

بالنسبة للبيئات ذات الانضمام الأول غير المستقرة، قم بتشغيل فحوصات Probe SDK قبل استدعاء `ZoomMtg.init()` أو `client.join()`:

1. قم بتشغيل تشخيصات الأذونات والجهاز والشبكة في Probe. 2. تطبيق سياسة الجاهزية (`allow` أو `warn` أو `block`). 3. المتابعة إلى انضمام Meeting SDK فقط لـ `allow` أو `warn` المعتمدة.

انظر [../../probe-sdk/SKILL.md](../../probe-sdk/SKILL.md) و [../../general/use-cases/probe-sdk-preflight-readiness-gate.md](../../general/use-cases/probe-sdk-preflight-readiness-gate.md).

## Client View مقابل Component View

**الفرق الحاسم**: هذان API مختلفان تماما مع أنماط مختلفة!

| الجانب | Client View | Component View | |--------|-------------|----------------| | **Object** | `