عملاء LiveKit
انضم إلى مكالمات Voice Agent من iOS أو Android أو Flutter أو React Native أو مكونات React من LiveKit باستخدام رمز دخول الجلسة الذي يعيده خادمك الخلفي.
تعمل مكالمات Voice Agent على LiveKit. تتبع استجابة الجلسة الصيغة القياسية لنقطة نهاية رموز الدخول
في LiveKit (server_url مع participant_token)، فتستطيع أي حزمة LiveKit SDK للعملاء الانضمام،
وتعمل مكونات واجهة الوكلاء في LiveKit دون تعديل. استخدم @humain-voice/agent في
المتصفح ما لم تكن تبني على LiveKit بالفعل.
اتصل برمز الدخول
يعيد مسار خادمك الخلفي { "server_url": "…", "participant_token": "…" }، كما في
البدء السريع. اجلبه قبيل
الاتصال، ثم اتصل وشغّل الميكروفون:
import { Room } from 'livekit-client';
const { server_url, participant_token } = await fetch('/agent-session', { method: 'POST' }).then((res) => res.json());
const room = new Room();
await room.connect(server_url, participant_token);
await room.localParticipant.setMicrophoneEnabled(true);تستطيع أدوات الجلسة المساعدة في LiveKit استدعاء مسارك نيابةً عنك: وجّه TokenSource.endpoint إليه. يرسل
رمز الدخول الوكيل إلى المكالمة بالفعل، فلا تمرر اسم وكيل؛ ويمكن تجاهل أي room_config ترسله الأداة
المساعدة إلى مسارك.
المنصات
| المنصة | LiveKit SDK | ملاحظات |
|---|---|---|
| الويب، React | livekit-client، @livekit/components-react | تعمل مكونات Agents UI مثل شريط التحكم ومُصوِّر الصوت ونص المحادثة كما هي. |
| iOS وmacOS | LiveKit Swift SDK | أضف NSMicrophoneUsageDescription إلى Info.plist. |
| Android | LiveKit Android SDK | اطلب الإذن RECORD_AUDIO قبل الاتصال. |
| Flutter | livekit_client | اطلب إذن الميكروفون على المنصتين. |
| React Native | @livekit/react-native | يحتاج بنية تطوير (development build)، لا Expo Go. |
الصوت ووضع الوكيل والنصوص المنسوخة والرسائل المكتوبة مدمجة في LiveKit. أما أدوات العميل والتحذيرات وسبب الإنهاء وتحديث السياق فتستخدم الإشارات الموضحة في دون SDK.