Meeting SDK/Linux

# Zoom Meeting SDK - Linux Development

إرشادات متخصصة لبناء روبوتات اجتماعات بدون واجهة مستخدم باستخدام Zoom Meeting SDK على Linux. يتيح هذا SDK المشاركة في الاجتماعات من جانب الخادم، والتقاط البيانات الوسائطية الخام، والنسخ، وأتمتة الاجتماعات المدعومة بالذكاء الاصطناعي.

## كيفية بناء روبوت اجتماع يربط تلقائيا ويسجل

استخدم هذه المهارة عند الحاجة إلى: - انضمام روبوت مرئي إلى اجتماع Zoom حقيقي - تسجيل الروبوت للبيانات الوسائطية بنفسه - أو تفعيل سير عمل التسجيل السحابي المدار من قبل Zoom بعد الانضمام

سلسلة المهارات: - الأساسية: `meeting-sdk/linux` - إضافة `zoom-rest-api` للبحث عن OBF/ZAK أو الجدولة أو إعدادات التسجيل السحابي - إضافة `zoom-webhooks` عند الحاجة إلى استرجاع التسجيل السحابي بعد الاجتماع

سير العمل الأدنى للتسجيل الخام:

```cpp JoinParam join_param; join_param.userType = SDK_UT_WITHOUT_LOGIN; auto& params = join_param.param.withoutloginuserJoin; params.meetingNumber = meeting_number; params.userName = "Recording Bot"; params.psw = meeting_password.c_str(); params.app_privilege_token = obf_token.c_str();

SDKError join_err = meeting_service->Join(join_param); if (join_err != SDKERR_SUCCESS) { throw std::runtime_error("join_failed"); }

// في استدعاء MEETING_STATUS_INMEETING: auto* record_ctrl = meeting_service->GetMeetingRecordingController(); if (!record_ctrl) { throw std::runtime_error("recording_controller_unavailable"); }

if (record_ctrl->CanStartRawRecording() != SDKERR_SUCCESS) { throw std::runtime_error("raw_recording_not_permitted"); }

SDKError record_err = record_ctrl->StartRawRecording(); if (record_err != SDKERR_SUCCESS) { throw std::runtime_error("start_raw_recording_failed"); }

GetAudioRawdataHelper()->subscribe(new MyAudioDelegate()); ```

استخدم **التسجيل الخام** عندما يجب أن يمتلك الروبوت بيانات PCM/YUV أو تغذية خط أنابيب الذكاء الاصطناعي مباشرة. استخدم **التسجيل السحابي + webhooks** عندما تكون المتطلبات هي أصول MP4/M4A/النسخ المدارة من قبل Zoom بعد الاجتماع.

**الوثائق الرسمية**: https://developers.zoom.us/docs/meeting-sdk/linux/ **مرجع API**: https://marketplacefront.zoom.us/sdk/meeting/linux/ **مستودع العينات (التسجيل الخام)**: https://github.com/zoom/meetingsdk-linux-raw-recording-sample **مستودع العينات (بدون واجهة)**: https://github.com/zoom/meetingsdk-headless-linux-sample

## الروابط السريعة

**جديد في Meeting SDK Linux؟ اتبع هذا المسار:**

1. **[linux.md](linux.md)** - دليل البدء السريع مع سير العمل الكامل 2. **[concepts/high-level-scenarios.md](concepts/high-level-scenarios.md)** - معماريات روبوتات الإنتاج 3. **[meeting-sdk-bot.md](meeting-sdk-bot.md)** - روبوت موثوق مع منطق إعادة المحاولة 4. **[references/linux-reference.md](references/linux-reference.md)** - المتطلبات، Docker، CMake

**حالات الاستخدام الشائعة:** - **روبوت النسخ** → [high-level-scenarios.md#scenario-1-transcription-bot](concepts/high-level-scenarios.md) - **روبوت التسجيل** → [high-level-scenarios.md#scenario-2-recording-bot](concepts/high-level-scenarios.md) - **مساعد الاجتماع بالذكاء الاصطناعي** → [high-level-scenarios.md#scenario-3-ai-meeting-assistant](concepts/high-level-scenarios.md) - **مراقبة الجودة** → [high-level-scenarios.md#scenario-4-monitoring-quality-bot](concepts/high-level-scenarios.md) - **روبوت الانضمام التلقائي + التسجيل** → [meeting-sdk-bot.md](meeting-sdk-bot.md) لتنسيق التسجيل الخام وإعادة المحاولة والمسح السحابي

**هل تواجه مشاكل؟** - مشاكل صوت Docker → [references/linux-reference.md#pulseaudio-setup](references/linux-reference.md) - رفض إذن التسجيل الخام → [meeting-sdk-bot.md#raw-recording-permission-denied](meeting-sdk-bot.md) - أخطاء البناء → [references/linux-reference.md#troubleshooting](references/linux-reference.md)

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

إذا طلب المستخدم بناء روبوت **ينضم تلقائيا إلى اجتماع Zoom ويسجله**، ابدأ بـ [meeting-sdk-bot.md](meeting-sdk-bot.md).

- استخدم **Meeting SDK Linux** للمشارك المرئي وسير الانضمام والتحكم في التسجيل الخام. - اربط **zoom-rest-api** عندما يجب على الروبوت جلب توكنات OBF/ZAK أو جدولة الاجتماعات أو تفعيل إعدادات التسجيل من جانب الحساب. - اربط **zoom-webhooks** عندما تكون المتطلبات هي استرجاع تسجيل Zoom السحابي بعد انتهاء الاجتماع.

## نظرة عامة على SDK

Zoom Meeting SDK لـ Linux هي **مكتبة C++ محسنة لبيئات الخادم بدون واجهة مستخدم**: - **التشغيل بدون واجهة مستخدم**: لا توجد حاجة إلى واجهة رسومية، مثالية لـ Docker/cloud - **الوصول إلى البيانات الخام**: فيديو YUV420، صوت PCM بـ 32kHz - **حلقة أحداث GLib**: معالجة غير متزامنة للاستدعاءات - **جاهز لـ Docker**: ملفات Dockerfile معدة مسبقا لـ CentOS/Ubuntu - **تكامل PulseAudio**: أجهزة صوتية افتراضية للبيئات بدون واجهة مستخدم

### الاختلافات الرئيسية عن Video SDK

| الميزة | Meeting SDK (Linux) | Video SDK | |---------|-------------------|-----------| | **الاستخدام الأساسي** | الانضمام إلى الاجتماعات الموجودة كروبوت | استضافة جلسات فيديو مخصصة | | **الرؤية** | مشارك مرئي | مشارك الجلسة | | **الواجهة** | بدون واجهة مستخدم | واجهة مخصصة اختيارية | | **المصادقة** | JWT + OBF/ZAK للاجتماعات الخارجية | JWT فقط | | **التسجيل** | التسجيل الخام والسحابي | التسجيل السحابي |