Deewanالتوثيق

أسماء الحقول ورموز الأخطاء وأمثلة الشيفرة بالإنجليزية، كما تستخدمها في برنامجك.

الندوات

مضيفون يقدّمون لجمهور يصل إلى 500 شخص، يشاهدون ويدردشون ويتفاعلون ويرفعون أيديهم ويطرحون الأسئلة.

الندوة غرفة فيها منصّة وجمهور. يقدّم المضيفون والمضيفون المشاركون بالكاميرا والميكروفون والشاشة، وينضم الباقون كحضور: يرون المنصّة ويسمعونها، ويدردشون ويتفاعلون ويرفعون أيديهم ويطرحون الأسئلة، ولا ينشرون شيئًا حتى يدعوهم مضيف للتحدّث. يفرض خادم الوسائط ذلك — فتصريح الحاضر لا يمنحه حق النشر — فيصمد حتى أمام تطبيق معدَّل.

إنشاء ندوة

ts
const room = await deewan.rooms.create({
  name: "Product launch",
  settings: { type: "webinar", access: "link" },
});

// Presenters join as hosts; everyone else as participants (the audience).
const host = await deewan.rooms.createJoinLink(room.id, { name: "Sara Ahmed", role: "host" });
const seat = await deewan.rooms.createJoinLink(room.id, { name: "Omar Saleh" });
curl
curl https://deewan.io/api/v1/rooms \
  -H "Authorization: Bearer $DEEWAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Product launch","settings":{"type":"webinar","access":"link"}}'

دعوة أحد للتحدّث

يفعل المضيفون ذلك عادةً من قائمة المشاركين، حيث يظهر بجانب اليد المرفوعة زر «دعوة للتحدّث». ويمكن لخادمك فعله أيضًا بمعرّف اتصال المشارك من GET /rooms/{room_id}/participants.

ts
await deewan.rooms.inviteToSpeak(room.id, identity);   // they may turn on mic and camera
await deewan.rooms.moveToAudience(room.id, identity);  // back to watching

الأسئلة والأجوبة

يطرح الحضور الأسئلة في لوحة الأسئلة ويصوّتون لما يريدون إجابته، ويحدّدها المضيفون كمُجابة أو يخفونها. تنتقل الأسئلة مشفّرة تمامًا بين الطرفين داخل الاجتماع مثل المحادثة، ولا تُخزَّن: من ينضم لاحقًا يتسلّم القائمة الحالية من متصفح أحد المضيفين.

  • حتى 500 شخص في الندوة الواحدة؛ والاجتماعات العادية حتى 300.
  • التشفير التام بالوضع الصارم والتسجيل والترجمة النصية والاستطلاعات تعمل كأي غرفة.
  • الغرف الفرعية المفتوحة من ندوة اجتماعات عادية، فيمكن لكل من فيها التحدّث.
  • الفوترة كأي اجتماع عبر الواجهة البرمجية: لكل دقيقة مشارك.

الأحداث

اشترك في participant.stage_changed لمعرفة لحظة بدء أحدهم التحدّث أو توقفه عنه — مثلًا لتشغيل شريط معلومات على بث منفصل.