social_live_one_on_one_call 1.0.0

SDK for video/audio Calls

social_live_one_on_one_call (SDK)

Version 1.0.0

---

Installation

• Add 'social_live_one_on_one_call' in pubspec.yaml

  or

  flutter pub add social_live_one_on_one_call
  

• Import library

import 'package:social_live_one_on_one_call/social_live_one_on_one_call.dart';   

NOTE: 'social_live_one_on_one_call' required dart 3.4.0 and later, please upgrade your dart as needed.

*** IMPORTANT ***

• On Android, add following permission (if not available) in 'android/app/src/main/AndroidManifest.xml'

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"/>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_CONNECTED_DEVICE"/>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE"/>

• To maintain audio call when app go background, please start foreground service using package 'flutter_foreground_service'

void main() {
  runApp(MyApp());
  startForegroundService();
}

void startForegroundService() async {
  ForegroundService().start();
  debugPrint("Started service");
}

• On iOS

  • open Info.plist on iOS Project, then add following description for microphone and camera feature (if not available)

      <string>Use camera for Video Call.</string>
      <key>NSMicrophoneUsageDescription</key>
      <string>Use microphone for Voice Call.</string>
      <key>UIApplicationSupportsIndirectInputEvents</key>
  

  • open Podfile of Pods project, then add following script to add camera and microphone configurations

  post_install do |installer|
      installer.pods_project.targets.each do |target|
          flutter_additional_ios_build_settings(target)
          target.build_configurations.each do |config|
              # You can remove unused permissions here
              # e.g. when you don't need camera permission,
                  just add 'PERMISSION_CAMERA=0'
  
              config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
                  '$(inherited)',
  
                  ## dart: PermissionGroup.camera
                  'PERMISSION_CAMERA=1',
  
                  ## dart: PermissionGroup.microphone
                  'PERMISSION_MICROPHONE=1',
              ]
          end
      end
  end
  

• And to let call run in background, you need to set background mode to Voice over IP

Flow

Step 1: Obtain Authentication token

• To use the SDK, you need an authentication token and an AppID.

  • To get AppID, please contact us.
  • To get Authentication Token, please read this documentation Authentication Flow.
  • The example simulate a simple flow to obtain authentication via phone number regsiter.

  final phoneToken = await NetworkUtils().createToken(number: myNumber, appId: appId);
  

• After you got AppID and Authentication Token, the CallSDK is ready to use now.

Step 2: Start SDK

• Start the SDK with AppID and token from previous step.

void startSDK({
    required String appId,
    required String token,
    required Function(CallEvent eventName, Map<String,dynamic>? data) callEvent,
    Function(bool)? completion})

• The callEvent will emit call-related event, for example when call 'connecting', 'connected', 'ended'. The 'CallEvent.audio' will emit when audio route change, for example when user plugin headphone or turn on/off speaker. Based on these events, you can update your Call UI appropriately. The 'CallEvent.notify' is just for demo, it used for notify when someone call-in.

enum CallEvent {
  connecting,
  connected,
  ended,
  audio,

  // For testing call flow only, remove on distribute this library
  notify,
}

Step 3: Call Feature (Make, Cancel, Accept, Decline, End)

MAKE CALL

• To make call, you need to get a CallID. Please read this documentation Call Flow
• The example also simulate flow to get CallId via phone number, just enter your number and the number you want to call.

final newCallId = await NetworkUtils().createCall(appId: appId, callerNumber: registeredPhoneNumber, calleeNumber: calleeNumber);

• After you get CallId, just call 'startCall'

void startCall({required String callId, Function()? completion})

CANCEL CALL

• To Cancel the call on caller-side (before callee accept call), just call cancelCall

CallSDK().cancelCall();

ACCEPT CALL

• On the Callee-side, you need to implement mechanism to notify Callee client about the callId, so that they can join the call and start communicate. The example use the CallEvent.notify to get notification and callId.

if (event == CallEvent.notify) {
    if (data != null) {
    final inputCallId = BaseEntity.stringValue(data, "call_id");
    if (inputCallId != null) {
        handleReceiveCall(callId: inputCallId);
    }
}

void handleReceiveCall({required String callId}) async {
    goToCallScreen(newRole: "callee", inputCallId: callId);
}

• To accept call on Callee, just call receiveCall

void receiveCall({required String callId, Function()? completion})

• Within seconds, both caller and callee will connect and the you can start talking.

DECLINE CALL

• To Decline the call on Callee-side, just call declineCall

CallSDK().declineCall();

END CALL

• To stop the on-going call, just call terminateCall. Below code check the current call status and decide which action to do.

final callReady = CallSDK().isCallConnected();
if (callReady) {
    CallSDK().terminateCall(true);
} else {
    CallSDK().cancelCall();
}
_closeCallView();

Step 4: Stop SDK

• When not used anymore especially when logout, you can stop CallSDK

await CallSDK().stopSDK(completion: () {
}