جارٍ التحميل...
01 · Choose your path
مهما كان مستواك. كل مسار يُوصلك إلى تكامل إنتاجي حقيقي.
02 · Quickstart · 5 minutes
سجّل ← انسخ مفتاحك ← الصق سطراً واحداً. نشرح كل سطر أدناه.
الخطة المجانية، بدون بطاقة ائتمان. من الكونسول تحصل على مفتاح عام (pk_live_…) للمتصفحات ومفتاح سرّي (sk_live_…) لخادمك. عامل sk_ كأنه كلمة مرور قاعدة بيانات.
في كل عرض صفحة، خادمك يوقّع هوية الزائر (email + name) بـsk_، يُرسل POST إلى /api/public/v1/sdk-token، يحصل على JWT آمن للمتصفح صلاحيته ساعة. هذا ما يستخدمه المتصفح.
أضف وسم <script> بـpk_ وJWT. الزر العائم للمكالمة/المحادثة يظهر. اربط زرّك الموجود بـLIQAA.startCall(...). انتهيت.
عالق؟ التوثيق الكامل · partners@tkawen.com
03 · By framework
12 دليل رسمي. SDKs أصيلة للأطر الشهيرة، HTTP خام للباقي.
Hooks + components عبر @liqaa/react
App Router + RSC متوافق
Composition API plugin
وسم script واحد، بدون تثبيت
توقيع التوكنات على الخادم
curl + hash_hmac، مثال كامل
requests + hmac، جاهز
net/http + crypto/hmac
إضافة رسمية، نقرة وتثبيت
Liquid snippet + app proxy
أمثلة Server SDK
iOS + Android عبر WebView
04 · By use case
كل وصفة تأتي مع كود يعمل، لقطة شاشة للنتيجة، والمقايضات التي نختارها.
See it · Live
الزر يظهر بمجرد تحميل الـSDK. المستخدم ينقر. خلال أجزاء من الثانية، يُتبادل JWT موقّع، تتفاوض ICE candidates، ويتشكّل اتصال WebRTC. مشفّر من طرف لطرف.
05 · Core concepts
لا حاجة لخبرة سابقة في بنية الفيديو. نشرح كل شيء من الصفر.
معيار متصفّح للصوت/الفيديو الفوري. البروتوكول الذي يستعمله Google Meet وDiscord — وأنت الآن. نتولّى الأجزاء الصعبة: signaling، NAT traversal، simulcast.
الـ pk_live_… مفتاحك العام — آمن لإرساله للمتصفح. الـ sk_live_… مفتاحك السرّي — للخادم فقط. نفس نمط Stripe. نرفض أي طلب من المتصفح يستعمل sk_.
في كل تحميل صفحة، خادمك يوقّع هوية المستخدم بـsk_، يتبادلها بـJWT آمن للمتصفح صلاحيته ساعة. JWT محدود بالغرفة وبالوقت.
نفس زوج المستخدمين = نفس الغرفة عبر المكالمات. لا غرفة جديدة لكل مكالمة تُشوّش لوحة التحكم. Idempotent عبر external_conversation_id.
نُرسل POST لأحداث على رابطك، موقّعة بـHMAC-SHA256. أنت تتحقّق من التوقيع، ترفض الـreplay الأقدم من 5 دقائق. بدون "هل جاء هذا من LIQAA؟"
لشخصين، P2P كافٍ. لـ3+ تحتاج Selective Forwarding Unit (SFU) ليُرسل كل شخص فيديو مرّة واحدة بدلاً من N. نُشغّل LiveKit SFU عالمياً.
06 · Under the hood
موقعك يتحدّث HTTPS+JWT مع LIQAA Cloud. LIQAA يتفاوض جلسة WebRTC مع LiveKit SFU. الوسائط تتدفّق مباشرة. نحن لا نلمس البايتات.
07 · Going live
قبل أن تُبدّل pk_test_ بـpk_live_، راجع هذه القائمة.