react-native-AcuMobCom

Aculab react-native sdk

Dependencies

---

This package implements Aculab webRTC services in the React Native project. The main part of the package is component class AcuMobCom. You can write a custom class that extends this and uses its state variables and methods.

Please visit the Demo App to see it being used practice.

Installation

Install the package

Instal react-native-AcuMobCom and react-native-webrtc with --save flag.

npm install --save react-native-acumobcom react-native-webrtc

Install pods for ios

npx pod-install

Manually add DTMF method for android

Open your_project/node_modules/react-native-webrtc/android/src/main/java/com/oney/WebRTCModule/WebRTCModule.java and add the method below into class WebRTCModule.

If you skip this step, the Android platform will throw an error when sendDtmf is called.

@ReactMethod
public void peerConnectionSendDTMF(String tone, int duration, int interToneGap, int objectID) {
    PeerConnection pc = getPeerConnection(objectID);
    RtpSender sender = pc.getSenders().get(0);

    if (sender != null) {
        DtmfSender dtmfSender = sender.dtmf();
        dtmfSender.insertDtmf(tone, duration, interToneGap); //Here the timers are in ms
    }
}

Add permissions

Android

yourProject/android/app/src/main/AndroidManifest.xml

add the following permissions

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

iOS

yourProject/ios/yourProject/info.plist

add the following permissions

<key>NSCameraUsageDescription</key>
<string>for video chat</string>
<key>NSMicrophoneUsageDescription</key>
<string>for chat</string>

Android SDK Version

Make sure that your minSdkVersion is 24 or higher

yourProject/android/app/gradle/build.gradle

---

Usage - Demo App

Use the package as a react native class component

import {AcuMobCom} from 'react-native-acumobcom';

class YourClassComponent extends AcuMobCom {
  
  your code ...

}

Enter registration parameters in your class component

<YourClassComponent
    webRTCAccessKey={'string'}
    webRTCToken={'string'}
    cloudRegionId={'string'}
    logLevel={number | 'string'}
    registerClientId={'string'}
/>

AcuMobCom parameters

Parameter	Type	Description
webRTCAccessKey	string	WebRTC Access Key to the cloud you are using
webRTCToken	string	WebRTC Token returned by getToken function
cloudRegionId	string	Specify the cloud region ID in format 0-2-0
logLevel	string | number	value between 0 and 6 inclusive. 0 disables logging and 6 is the most detailed logging.
registerClientId	string	Unique client ID for registration

Workflow

Every client of the Aculab WebRTC services must first obtain WebRTC Token and use it to register their client id first.

NOTE: that registration can only occur when the callState is 'idle'.

NOTE: In production the apiAccessKey should stay secret, therefore the WebRTC Token should be obtained by your server and passed to your app for registration.

Use state callState as indication of current state.

Call Client

1. set state callClientId to client ID you want to call
2. call callClient method

NOTE: In order to successfully call between clients, they must be registered under the same Aculab Cloud Username. For Example user 'Anna123' registered under Cloud Username '[e-mail]' can call 'Tom123' if 'Tom123' is registered under Cloud Username '[e-mail]'. If 'Tom123' is registered under Cloud Username '[e-mail]' the call will always fail.

Call Service

1. set state serviceName to service ID you want to call
2. call callService method

NOTE: In order to successfully call service, the user calling the service must be registered under the same Aculab Cloud Username as the service. For Example user 'Anna123' registered under Cloud Username '[e-mail]' can call inbound service 'current-time' registered under Cloud Username '[e-mail]'. If 'Anna123' would register under Cloud Username '[e-mail]' the call to the service will always fail.

• More information about inbound and outbound service can be found here.
• More information about REST and UAS API service can be found here.
• The AcuMobCom package uses aculab-webrtc interface, you can see details about the interface here.

AcuMobCom state variables

State	Allowed Values	Default value	Description
callState	'idle'	'idle'	Normal state
	'calling'		Outbound call
	'incoming call'		Inbound call
	'got media'		Connected to a service
	'ringing'		Found service/client and awaits answer
	'connecting'		Call was answered, connecting in progress
	'connected'		Peer to peer connection established
	'error'		Error state
webRTCToken	string	''	Holds WebRTC Token after registration
callClientId	string	''	Holds client ID for outbound call
serviceName	string	''	Holds service ID for outbound call
mic	boolean	false	Used for mute method and indicates local audio on/off status
outputAudio	boolean	false	Used for mute method
camera	boolean	false	Used for mute method and indicates local video on/off status
outputVideo	boolean	false	Used for mute method
localVideoMuted	boolean	false	If local video is muted this state is true
remoteVideoMuted	boolean	false	If remote video is muted this state is true
call	object	null	If not null a call is in progress
remoteStream	object	null	Holds remote stream object when a call is in progress
localStream	object	null	Holds local stream object when a call is in progress
speakerOn	boolean	false	It is not part of any method and should be used to store state of the speaker if needed.
incomingCallClientId	string	''	When inbound call, it holds client ID from incoming call

AcuMobCom Functions

Function	Returns	Description
getToken({registerClientId: string, tokenLifeTime: number, enableIncomingCall: boolean, callClientRange: string, cloudRegionId: string, cloudUsername: string, apiAccessKey: string})	string	Get WebRTC Token for registration. This should be done on server side
register()		Register the client using AcuMobCom parameters. Every client has to be registered before using any other features.
unregister()		Unregister current client
callCheck()	boolean	Returns true if a call is in progress
callClient()		Calls client stored in callClientId
callService()		Calls service stored in serviceName
stopCall()		Terminates call in progress
swapCam()		Switches between front and back camera when video call is in progress
answer()		Answers incoming call
reject()		Rejects incoming call
mute()		Mutes video/audio of the call in progress based on current states of mic, outputAudio, camera and outputVideo when the method is called.
sendDtmf(string)		Sends DTMF to service when service call is in progress. Allowed characters 0-9, *, #. Use one character per a method call.
getLocalStream()	object	Use to get local video stream
disableIncomingCalls()		Disable incoming all calls
enableIncomingCalls(webRTCToken?: string)		Refresh WebRTC Token and enable incoming calls

AcuMobCom helpers

Functions you may find handy

import {deleteSpaces, showAlert} from 'react-native-acumobcom';

Function	Returns	Description
deleteSpaces(string)	string	returns string without white spaces
showAlert(title: string, message: string)		displays alert message

AcuMobCom audio set

You can also use the built in function for switching between internal and external audio set.

import {turnOnSpeaker} from 'react-native-acumobcom';

Function	Returns	Description
turnOnSpeaker(boolean)		pass true to turn ON the external audio set or false to turn it OFF.

License

MIT

Copyright (c) 2021 Aculab

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.