Voice Agent

عملاء 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ملاحظات
الويب، Reactlivekit-client، @livekit/components-reactتعمل مكونات Agents UI مثل شريط التحكم ومُصوِّر الصوت ونص المحادثة كما هي.
iOS وmacOSLiveKit Swift SDKأضف NSMicrophoneUsageDescription إلى Info.plist.
AndroidLiveKit Android SDKاطلب الإذن RECORD_AUDIO قبل الاتصال.
Flutterlivekit_clientاطلب إذن الميكروفون على المنصتين.
React Native@livekit/react-nativeيحتاج بنية تطوير (development build)، لا Expo Go.

الصوت ووضع الوكيل والنصوص المنسوخة والرسائل المكتوبة مدمجة في LiveKit. أما أدوات العميل والتحذيرات وسبب الإنهاء وتحديث السياق فتستخدم الإشارات الموضحة في دون SDK.

في هذه الصفحة