Quick Start Guide¶

Get up and running with the Nexacon Flutter SDK in minutes.

1. Initialize the Client¶

import 'package:nexacon_sdk/nexacon_sdk.dart';

final client = NexaconClient(
  apiKey: 'your_api_key',
  secretKey: 'your_secret_key',
  baseUrl: 'https://nxservice.quantumvision-tech.com/api/v1.0',
);

2. Available Services¶

Once the client is initialized, all services are available via:

client.auth        // Generate NX tokens for signaling
client.calls       // P2P calls, group calls, WebRTC
client.messaging   // Send messages, manage contacts
client.devices     // Register devices for push notifications
client.rooms       // Create and manage group chat rooms
client.presence    // Check user online status

3. Real-Time Messaging¶

For real-time chat, use MessagingManager:

// Create messaging manager
final messagingManager = client.createMessagingManager();

// Listen for incoming messages
messagingManager.messageStream.listen((message) {
  print('Received: ${message['message']}');
});

// Send a message
messagingManager.sendMessage(
  to: 'recipient@example.com',
  message: 'Hello!',
);

4. Making Calls¶

For peer-to-peer audio/video calls, use CallManager:

// Generate NX token
final nxResponse = await client.auth.generateXMPPToken(
  username: '+255788811191',
);

// Create CallManager (uses global connection)
final callManager = await client.createCallManager(
  nxtoken: nxResponse['token'],
  nxid: nxResponse['jid'],
  wsUrl: nxResponse['nxws'],
  onCallStateChanged: (state) => print('State: $state'),
  onIncomingCall: (caller) => print('Incoming from: $caller'),
);

// Make a call
await callManager.initiateCall(
  to: '+255788811192',
  audio: true,
  video: true,
);

5. Next Steps¶

Click on a service in the Services menu on the left for full documentation, method signatures, parameters, and code examples.

Service	What it does
Calls Service	P2P calling, group calls, WebRTC — start here
Messaging Service	Send messages and manage contacts
Devices Service	Register devices for FCM push notifications
Rooms Service	Create and manage group chat rooms
Presence Service	Check user online status and last seen