Calls UI Kit (Flutter)

1final caps = await BaxCalls.refreshCapabilities();
2print(caps.fcmConfigured);       // project has FCM JSON?
3print(caps.apnsVoipConfigured);  // project has APNs VoIP?
4print(caps.serverPushAndroid);   // server will send FCM?
5print(caps.serverPushIosVoip);   // server will send VoIP?
6print(caps.coldStartAndroid);    // e.g. app_owned_push_only
7print(caps.coldStartIos);        // e.g. app_owned_pushkit_only

1await BaxCalls.registerPushToken(
2  fcmToken,
3  platform: BaxPushPlatform.android,
4);
5
6await BaxCalls.registerPushToken(
7  apnsToken,
8  platform: BaxPushPlatform.ios,
9);
10
11await BaxCalls.registerPushToken(
12  voipToken,
13  platform: BaxPushPlatform.iosVoip,
14);
15
16// On logout:
17await BaxCalls.unregisterPushToken(fcmToken);

1@pragma('vm:entry-point')
2Future<void> firebaseMessagingBackgroundHandler(RemoteMessage message) async {
3  // Ensure BaxCalls.initialize ran (or re-init with stored credentials).
4  final data = message.data;
5  if (data['type'] == 'bax_call_invite') {
6    await BaxCalls.showIncoming(
7      BaxIncomingCall.fromPush(Map<String, dynamic>.from(data)),
8    );
9  }
10}
11
12FirebaseMessaging.onBackgroundMessage(firebaseMessagingBackgroundHandler);
13
14FirebaseMessaging.onMessage.listen((m) async {
15  if (m.data['type'] == 'bax_call_invite') {
16    await BaxCalls.showIncoming(
17      BaxIncomingCall.fromPush(Map<String, dynamic>.from(m.data)),
18    );
19  }
20});
21
22FirebaseMessaging.instance.onTokenRefresh.listen((token) async {
23  await BaxCalls.registerPushToken(token, platform: BaxPushPlatform.android);
24});

1await BaxCalls.registerPushToken(
2  voipToken,
3  platform: BaxPushPlatform.iosVoip,
4);
5
6// Inside your PushKit callback:
7await BaxCalls.showIncoming(
8  BaxIncomingCall.fromPush(Map<String, dynamic>.from(payloadMap)),
9);

1{
2  "type": "bax_call_invite",
3  "invitationId": "inv_...",
4  "roomName": "call_...",
5  "callType": "video",
6  "fromUserId": "u1",
7  "fromName": "Ada",
8  "fromAvatarUrl": "https://...",
9  "toUserId": "u2",
10  "toUserIds": "u2,u3",
11  "isGroup": "true",
12  "message": "Join us?",
13  "expiresAt": "2026-08-25T12:00:00.000Z"
14}

1class BaxCallEvent {
2  final BaxCallEventType type;
3  final String? invitationId;
4  final String? roomName;
5  final BaxCallType? callType;
6  final BaxIncomingCall? incoming;   // callee side
7  final BaxCallInvitation? invitation; // caller side / API row
8  final bool? muted;
9  final bool? cameraEnabled;
10  final bool? onHold;
11  final Object? error;
12  final String? message;
13}

1late final StreamSubscription<BaxCallEvent> _sub;
2
3void startListening() {
4  _sub = BaxCalls.instance.events.listen((event) {
5    switch (event.type) {
6      case BaxCallEventType.incoming:
7        final from = event.incoming?.fromName ?? 'Unknown';
8        debugPrint('Incoming from $from room=${event.roomName}');
9      case BaxCallEventType.outgoing:
10        debugPrint('Outgoing id=${event.invitation?.invitationId}');
11      case BaxCallEventType.ringing:
12        setState(() => status = 'Ringing…');
13      case BaxCallEventType.accepted:
14        // Optional: prepare UI; wait for connected to join media
15        break;
16      case BaxCallEventType.connected:
17        openCallScreen(
18          roomName: event.roomName!,
19          callType: event.callType ?? BaxCallType.video,
20        );
21      case BaxCallEventType.declined:
22      case BaxCallEventType.cancelled:
23      case BaxCallEventType.missed:
24      case BaxCallEventType.timeout:
25      case BaxCallEventType.ended:
26        closeCallScreen();
27      case BaxCallEventType.muteChanged:
28        setState(() => micMuted = event.muted ?? false);
29      case BaxCallEventType.cameraChanged:
30        setState(() => camOn = event.cameraEnabled ?? true);
31      case BaxCallEventType.holdChanged:
32        setState(() => onHold = event.onHold ?? false);
33      case BaxCallEventType.error:
34        showError(event.error ?? event.message);
35    }
36  });
37}
38
39@override
40void dispose() {
41  _sub.cancel();
42  super.dispose();
43}