> *Refer to* [*README*](../README.md) *for main instruction file*
# MCOP - MCPTT App Development
## What is MCOP?
**MCOP** (Mission Critical Open Platform) is a project that defines the first prototype of open source **MCPTT** (Mission Critical Push-To-Talk) client.
This client allows the interoperability among different vendors thanks to a multilevel API.
## Architecture
Three main modules define the architecture:
* **MCOP SDK**:
This module contains all the MCPTT logic, and allows the use of other additional modules that increase its functionality.
* **MCOP Integration Plugins**:
Additional modules or Android services with their own API, known by the MCOP SDK module, offering device specific or MCPTT network required functionalities.
* **End User Interface**:
GUI (Graphical User Interface) that uses the MCOP SDK services without having to develop the whole MCPTT logic. *(Min. level of Android SDK: API 17)*.
## App Developing Steps
* **0. MCOP SDK and AIDLs**: The SDK defines two AIDLs and one Constant class:
* **IMCOPsdk**: From Client to SDK.
* **IMCOPCallBack**: From SDK to Client.
* **ConstantsMCOP**: defines the constants to use in the AIDLs.
* **1. Configure Manifest**: Indicate the necessary permissions for the application.
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.DISABLE_KEYGUARD" />
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.PROCESS_OUTGOING_CALLS" />
<uses-permission android:name="android.permission.CALL_PHONE" />
<uses-permission android:name="android.permission.RAISED_THREAD_PRIORITY" />
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
Define the activities to be used:
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme" >
<activity android:name=".MainActivity"
android:screenOrientation="portrait">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
<queries>
</queries>
* **2. Require the explicit acceptance of some of the permissions.**
The client should explicitly accept some permissions:
* Manifest.permission.ACCESS\_FINE\_LOCATION
* Manifest.permission.READ\_PHONE\_STATE
* Manifest.permission.ACCESS\_COARSE\_LOCATION
* Manifest.permission.CAMERA
* Manifest.permission.RECORD\_AUDIO
* **3. Bind to MCOP SDK**:
In this version of MCOP SDK, it is necessary to send **“currentProfile”** to the service:
Intent serviceIntent = new Intent()
.setComponent(new ComponentName(
"org.mcopenplatform.muoapi",
"org.mcopenplatform.muoapi.MCOPsdk"));
//This is only for tresting
serviceIntent.putExtra("PROFILE_SELECT",currentProfile);
ComponentName componentName=startService(serviceIntent);
bindService(serviceIntent, mConnection, BIND_AUTO_CREATE);
Wait for the service to bind:
* Save the return value from the Service (this is the AIDL Interface to be used by the Client to communicate with the Service).
* Register the callback for asynchronous communication from the Service to the Client:
mConnection = new ServiceConnection() {
@Override
public void onServiceConnected(ComponentName className, IBinder service) {
mService = IMCOPsdk.Stub.asInterface(service);
try {
mService.registerCallback(mMCOPCallback);
} catch (RemoteException e) {
e.printStackTrace();
}
isConnect=true;
//AUTO Register
final Handler handler = new Handler();
handler.postDelayed(new Runnable() {
@Override
public void run() {
try {
if(mService!=null)
mService.authorizeUser(null);
} catch (RemoteException e) {
e.printStackTrace();
}
}
}, DEFAULT_REGISTER_DELAY);
}
* Definition of the registered callback:
* This is the point where communications from the Server to the Client will be received:
mMCOPCallback=new IMCOPCallback.Stub() {
@Override
public void handleOnEvent(final List<Intent> actionList) throws RemoteException {
runOnUiThread(new Runnable() {
@Override
public void run() {
for(Intent action:actionList){
int codeError=-1;
int eventTypeInt=-1;
String stringError=null;
String sessionID=null;
if(action!=null &&
action.getAction()!=null &&
!action.getAction().trim().isEmpty())
try {
switch (ConstantsMCOP.ActionsCallBack.fromString(action.getAction())){
...
}
}catch (Exception ex){
Log.e(TAG,"Event Action Error: "+action.getAction()+" error:"+ex.getMessage());
}
}
}
});
}
};
* **4. Perform any action in the MCOP SDK and receive the result**.
Example:
if(mService!=null)
mService.makeCall(
selGroup, //DEFAULT_GROUP,
ConstantsMCOP.CallEventExtras.CallTypeEnum.CallSubtypeAudio.getValue()|
ConstantsMCOP.CallEventExtras.CallTypeEnum.CallSubtypeWithCtrlMech.getValue()|
ConstantsMCOP.CallEventExtras.CallTypeEnum.CallSubtypePrearrangedGroup.getValue()
);