Flutter 

1flutter pub add socrits livekit_client permission_handler

1<!-- android/app/src/main/AndroidManifest.xml -->2<uses-permission android:name="android.permission.INTERNET"/>3<uses-permission android:name="android.permission.CAMERA"/>4<uses-permission android:name="android.permission.RECORD_AUDIO"/>5<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>6<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>78<!-- ios/Runner/Info.plist -->9<key>NSCameraUsageDescription</key><string>Video calls</string>10<key>NSMicrophoneUsageDescription</key><string>Voice calls</string>

1import 'package:socrits/socrits.dart';2import 'package:livekit_client/livekit_client.dart' as lk;34final client = Socrits(baseUrl: 'https://api.socrits.com');56// Connect the signalling socket. Your backend issues the user's session token7// (POST /v1/session with your sk_live_ key) — never embed the key in the app.8await client.connect(9  sessionEndpoint: 'https://your-backend.com/socrits/session', // returns { token }10  userId: 'alice',11  userName: 'Alice',12);13// (or, if you already have a token) await client.connect(userToken: token, userId: 'alice');

1import 'package:socrits/socrits.dart';23// 1) Give MaterialApp a navigator key so the SDK can show the ring + call UI.4final navKey = GlobalKey<NavigatorState>();5// MaterialApp(navigatorKey: navKey, home: ...)67// 2) After connect(), wire the whole call flow — ONCE.8SocritsCallUI.instance.attach(9  client: client,10  navigatorKey: navKey,11  selfName: 'Alice',12);13// That's it. Incoming calls now ring with a prebuilt screen, navigate to the14// call UI on accept, and tear down on hang-up / decline / timeout — automatically.

1// Start a call from anywhere:2SocritsCallUI.instance.call(userId: 'bob', displayName: 'Bob', mode: CallMode.video);34// …or drop a button next to a user (the ZegoSendCallInvitationButton equivalent):5SocritsCallButton(inviteeUserId: 'bob', inviteeName: 'Bob', isVideo: true)

1// Wire these once, right after connect()2client.onIncomingCall = (IncomingCall call) {3  // show your ringing screen, then accept or reject:4  // final room = await client.accept(call);5  // client.reject(call);6};7client.onCallConnected = (lk.Room room, CallMode mode) {8  // both sides are in the room now — show the call screen (see below)9};10client.onCallRejected = (callId) { /* callee declined */ };11client.onCallEnded    = (reason) { /* ring ended before connecting: timeout | cancelled */ };12client.onCallHungUp   = (callId) { /* peer hung up a LIVE call (explicit call:end) */ };1314// End a live call (tells the peer immediately, vs a silent drop):15// client.endCall(callId);1617// Offline ringing: register the device's FCM token so Socrits can push a ring18client.registerDevice(fcmToken, platform: 'android');

1// Caller: start a call. Returns a callId; the callee gets onIncomingCall.2final callId = await client.invite(3  toUserId: 'bob',4  mode: CallMode.video, // or CallMode.voice5);67// Callee: inside onIncomingCall8final room = await client.accept(call);   // joins the media room9// onCallConnected fires on BOTH sides with the connected lk.Room.

1import 'package:socrits/socrits.dart';23client.onCallConnected = (room, mode) {4  Navigator.of(context).push(MaterialPageRoute(5    builder: (_) => Scaffold(6      body: SocritsCallView(7        room: room,8        title: 'Bob',9        allowVideo: mode == CallMode.video,     // voice call → hides Video/Flip, stays audio-only10        startedAt: client.lastStartedAt,         // same duration on both sides11        initialCam: mode == CallMode.video,12        initialMic: true,13        initialSpeaker: mode == CallMode.video, // video → speaker, voice → earpiece14        onHangUp: () => Navigator.of(context).pop(),15      ),16    ),17  ));18};

1// You get the raw LiveKit Room from accept() / onCallConnected — build any UI you want.2final lk.Room room = await client.accept(call);34// controls5await room.localParticipant?.setMicrophoneEnabled(true);6await room.localParticipant?.setCameraEnabled(mode == CallMode.video);78// render remote video9final listener = room.createListener();10listener.on<lk.TrackSubscribedEvent>((e) {11  if (e.track is lk.VideoTrack) {12    setState(() => remote = e.track as lk.VideoTrack);13  }14});15// in build():  if (remote != null) lk.VideoTrackRenderer(remote!)1617// end the call18await room.disconnect();

1// socrits bundles flutter_callkit_incoming; you also need firebase_core +2// firebase_messaging for the push itself.3import 'package:firebase_messaging/firebase_messaging.dart';4import 'package:socrits/socrits.dart';56// 1) Top-level FCM background handler — runs when the app is killed/backgrounded.7@pragma('vm:entry-point')8Future<void> _bg(RemoteMessage m) async {9  await SocritsCallKit.onPushData(m.data); // raises the native full-screen ring10}1112void main() {13  FirebaseMessaging.onBackgroundMessage(_bg);14  // 2) Foreground pushes (harmless if your live socket already rang):15  FirebaseMessaging.onMessage.listen((m) => SocritsCallKit.onPushData(m.data));16  runApp(const MyApp());17}

1// 3) Route the OS Accept / Decline — register ONCE, high in the widget tree.2SocritsCallKit.appName = 'MyApp';3SocritsCallKit.listen(4  onAccept: (callId, extra) async {5    // reconnect first if the app was cold-started by the ring:6    await client.connect(userToken: await mintToken(), userId: me);7    await client.acceptCallById(callId); // joins the room → onCallConnected fires8  },9  onDecline: (callId) => client.rejectCallById(callId),10);1112// 4) After connect(), register this device's FCM token so Socrits can ring it:13client.registerDevice(14  await FirebaseMessaging.instance.getToken(),15  platform: 'android',16);

1// 1:1 or group chat rides the same connection2client.onMessage = (ChatMessage m) { /* append to the thread */ };34await client.sendMessage(toUserId: 'bob', text: 'Hey!');5final history = await client.messageHistory(conversationId, limit: 30);6final convos  = await client.conversations();7client.setTyping(conversationId, true);8client.markRead(conversationId);