new file mode 100644

@@ -0,0 +1,10 @@

+*.iml

+.gradle

+/local.properties

+/.idea/workspace.xml

+/.idea/libraries

+.DS_Store

+/build

+/captures

+.externalNativeBuild

+*.apk

\ No newline at end of file

new file mode 100644

Binary files /dev/null and b/.idea/caches/build_file_checksums.ser differ

new file mode 100644

@@ -0,0 +1,29 @@

+<component name="ProjectCodeStyleConfiguration">

+  <code_scheme name="Project" version="173">

+    <Objective-C-extensions>

+      <file>

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Import" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Macro" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Typedef" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Enum" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Constant" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Global" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Struct" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="FunctionPredecl" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Function" />

+      </file>

+      <class>

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Property" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="Synthesize" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="InitMethod" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="StaticMethod" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="InstanceMethod" />

+        <option name="com.jetbrains.cidr.lang.util.OCDeclarationKind" value="DeallocMethod" />

+      </class>

+      <extensions>

+        <pair source="cpp" header="h" fileNamingConvention="NONE" />

+        <pair source="c" header="h" fileNamingConvention="NONE" />

+      </extensions>

+    </Objective-C-extensions>

+  </code_scheme>

+</component>

\ No newline at end of file

new file mode 100644

@@ -0,0 +1,6 @@

+<?xml version="1.0" encoding="UTF-8"?>

+<project version="4">

+  <component name="Encoding">

+    <file url="PROJECT" charset="UTF-8" />

+  </component>

+</project>

\ No newline at end of file

new file mode 100644

@@ -0,0 +1,18 @@

+<?xml version="1.0" encoding="UTF-8"?>

+<project version="4">

+  <component name="GradleSettings">

+    <option name="linkedExternalProjectsSettings">

+      <GradleProjectSettings>

+        <option name="distributionType" value="DEFAULT_WRAPPED" />

+        <option name="externalProjectPath" value="$PROJECT_DIR$" />

+        <option name="modules">

+          <set>

+            <option value="$PROJECT_DIR$" />

+            <option value="$PROJECT_DIR$/app" />

+          </set>

+        </option>

+        <option name="resolveModulePerSourceSet" value="false" />

+      </GradleProjectSettings>

+    </option>

+  </component>

+</project>

\ No newline at end of file

new file mode 100644

@@ -0,0 +1,34 @@

+<?xml version="1.0" encoding="UTF-8"?>

+<project version="4">

+  <component name="NullableNotNullManager">

+    <option name="myDefaultNullable" value="android.support.annotation.Nullable" />

+    <option name="myDefaultNotNull" value="android.support.annotation.NonNull" />

+    <option name="myNullables">

+      <value>

+        <list size="5">

+          <item index="0" class="java.lang.String" itemvalue="org.jetbrains.annotations.Nullable" />

+          <item index="1" class="java.lang.String" itemvalue="javax.annotation.Nullable" />

+          <item index="2" class="java.lang.String" itemvalue="javax.annotation.CheckForNull" />

+          <item index="3" class="java.lang.String" itemvalue="edu.umd.cs.findbugs.annotations.Nullable" />

+          <item index="4" class="java.lang.String" itemvalue="android.support.annotation.Nullable" />

+        </list>

+      </value>

+    </option>

+    <option name="myNotNulls">

+      <value>

+        <list size="4">

+          <item index="0" class="java.lang.String" itemvalue="org.jetbrains.annotations.NotNull" />

+          <item index="1" class="java.lang.String" itemvalue="javax.annotation.Nonnull" />

+          <item index="2" class="java.lang.String" itemvalue="edu.umd.cs.findbugs.annotations.NonNull" />

+          <item index="3" class="java.lang.String" itemvalue="android.support.annotation.NonNull" />

+        </list>

+      </value>

+    </option>

+  </component>

+  <component name="ProjectRootManager" version="2" languageLevel="JDK_1_8" default="true" project-jdk-name="1.8" project-jdk-type="JavaSDK">

+    <output url="file://$PROJECT_DIR$/build/classes" />

+  </component>

+  <component name="ProjectType">

+    <option name="id" value="Android" />

+  </component>

+</project>

\ No newline at end of file

new file mode 100644

@@ -0,0 +1,9 @@

+<?xml version="1.0" encoding="UTF-8"?>

+<project version="4">

+  <component name="ProjectModuleManager">

+    <modules>

+      <module fileurl="file://$PROJECT_DIR$/app/app.iml" filepath="$PROJECT_DIR$/app/app.iml" />

+      <module fileurl="file://$PROJECT_DIR$/mcop-test-gui-GIT.iml" filepath="$PROJECT_DIR$/mcop-test-gui-GIT.iml" />

+    </modules>

+  </component>

+</project>

\ No newline at end of file

new file mode 100644

@@ -0,0 +1,12 @@

+<?xml version="1.0" encoding="UTF-8"?>

+<project version="4">

+  <component name="RunConfigurationProducerService">

+    <option name="ignoredProducers">

+      <set>

+        <option value="org.jetbrains.plugins.gradle.execution.test.runner.AllInPackageGradleConfigurationProducer" />

+        <option value="org.jetbrains.plugins.gradle.execution.test.runner.TestClassGradleConfigurationProducer" />

+        <option value="org.jetbrains.plugins.gradle.execution.test.runner.TestMethodGradleConfigurationProducer" />

+      </set>

+    </option>

+  </component>

+</project>

\ No newline at end of file

new file mode 100644

@@ -0,0 +1,6 @@

+<?xml version="1.0" encoding="UTF-8"?>

+<project version="4">

+  <component name="VcsDirectoryMappings">

+    <mapping directory="$PROJECT_DIR$" vcs="Git" />

+  </component>

+</project>

\ No newline at end of file

new file mode 100644

@@ -0,0 +1,10 @@

+<p align="center"><a href="https://mcopenplatform.org" target="_blank" rel="noopener noreferrer"><img src="https://demo.mcopenplatform.org/gitlist/mcop/MCOP-MCPTT-Client.git/raw/master/images/logoMCOP_MD_w400px.png" alt="MCOP logo"></a></p>

+

+# MCOP MCPTT Client

The **MCOP MCPTT Client** comprises different elements connected by Android’s binder mechanism including the **MCPTT Client GUI**, the **MCOP SDK** (responsible of MCPTT protocols) and **low level plugins** to access SIM card, eMBMS, connectivity and configuration-oam to be deployed to get access to Mission Critical capabilities.

+

+Check [**MCOP MCPTT Client Installation**](https://demo.mcopenplatform.org/gitlist/mcop/MCOP-MCPTT-Client.git/blob/master/docs/MCOP_MCPTT_Client_Installation.md) for instructions.

+

+License terms are defined in the [Licensing](https://demo.mcopenplatform.org/gitlist/mcop/MCOP-MCPTT-Client.git/blob/master/docs/Licensing.md) and [Doubango](https://demo.mcopenplatform.org/gitlist/mcop/MCOP-MCPTT-Client.git/blob/master/docs/Licensing_Doubango.md) files. 

* For testing purposes, the [**MCOP Demo Platform**](https://demo.mcopenplatform.org/) is also available. Check the [**profiles**](https://demo.mcopenplatform.org/gitlist/mcop/MCOP-MCPTT-Client.git/blob/master/docs/Profiles.md) documentation for information on how to request access to our platform and configure the application.

+

+* Refer to [**MCOP SDK** Installation](https://demo.mcopenplatform.org/gitlist/mcop/MCOP-SDK.git/blob/master/docs/MCOP_SDK_Installation.md) for detailed **MCOP SDK** installation and testing steps. The [MCOP MCPTT App Development](https://demo.mcopenplatform.org/gitlist/mcop/MCOP-MCPTT-Client.git/blob/master/docs/MCOP_App_developing_steps.md) guide provides more info on app development using the MCOP SDK.

This application uses [Doubango Framework](https://www.doubango.org/).
Refer to [Doubango IMSDroid README](https://demo.mcopenplatform.org/gitlist/mcop/MCOP-MCPTT-Client.git/blob/master/docs/imsdroid_README.md) for additional IMS/SIP compatibility statements.

+

**Copyright (C) 2018, University of the Basque Country (UPV/EHU)**

For more information, please visit [MCOP - Resources](https://www.mcopenplatform.org/mcop_resources/) or [MCOP webpage](https://www.mcopenplatform.org).

new file mode 100644

@@ -0,0 +1 @@

+/build

new file mode 100644

@@ -0,0 +1,48 @@

+apply plugin: 'com.android.application'

+

+android {

+    compileSdkVersion 26

+    defaultConfig {

+        applicationId "org.test.client.mcopclient"

+        minSdkVersion 22

+        targetSdkVersion 26

+        versionCode 1

+        versionName "1.0"

+        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

+    }

+    /**

+     * This

+     */

+    packagingOptions{

+        doNotStrip "*/armeabi/*.so"

+        doNotStrip "*/armeabi-v7a/*.so"

+        doNotStrip "*/x86/*.so"

+    }

+

+    buildTypes {

+        release {

+            minifyEnabled false

+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'

+            buildConfigField "boolean", "LOG_SHOW", "true"

+        }

+        debug {

+            minifyEnabled false

+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'

+            buildConfigField "boolean", "LOG_SHOW", "true"

+        }

+    }

+}

+

+dependencies {

+    implementation fileTree(dir: 'libs', include: ['*.jar'])

+    testImplementation 'junit:junit:4.12'

+    androidTestImplementation 'com.android.support.test:runner:1.0.1'

+    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'

+    compile 'com.android.support.constraint:constraint-layout:1.0.2'

+    compile 'com.android.support:support-annotations:' + rootProject.supportLibVersion

+    compile 'com.android.support:appcompat-v7:' + rootProject.supportLibVersion

+    compile 'com.android.support:design:' + rootProject.supportLibVersion

+    compile 'com.android.support:cardview-v7:' + rootProject.supportLibVersion

+    compile 'com.android.support:support-v4:' + rootProject.supportLibVersion

+    compile 'com.android.support:recyclerview-v7:' + rootProject.supportLibVersion

+}

new file mode 100644

@@ -0,0 +1,21 @@

+# Add project specific ProGuard rules here.

+# You can control the set of applied configuration files using the

+# proguardFiles setting in build.gradle.

+#

+# For more details, see

+#   http://developer.android.com/guide/developing/tools/proguard.html

+

+# If your project uses WebView with JS, uncomment the following

+# and specify the fully qualified class name to the JavaScript interface

+# class:

+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {

+#   public *;

+#}

+

+# Uncomment this to preserve the line number information for

+# debugging stack traces.

+#-keepattributes SourceFile,LineNumberTable

+

+# If you keep the line number information, uncomment this to

+# hide the original source file name.

+#-renamesourcefileattribute SourceFile

new file mode 100644

@@ -0,0 +1,26 @@

+package org.test.client.mcopclient;

+

+import android.content.Context;

+import android.support.test.InstrumentationRegistry;

+import android.support.test.runner.AndroidJUnit4;

+

+import org.junit.Test;

+import org.junit.runner.RunWith;

+

+import static org.junit.Assert.*;

+

+/**

+ * Instrumented test, which will execute on an Android device.

+ *

+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>

+ */

+@RunWith(AndroidJUnit4.class)

+public class ExampleInstrumentedTest {

+    @Test

+    public void useAppContext() throws Exception {

+        // Context of the app under test.

+        Context appContext = InstrumentationRegistry.getTargetContext();

+

+        assertEquals("org.test.client.mcopclient", appContext.getPackageName());

+    }

+}

new file mode 100644

@@ -0,0 +1,46 @@

+<manifest xmlns:android="http://schemas.android.com/apk/res/android"

+    package="org.test.client.mcopclient">

+

+    <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" />

+

+    <!-- Location permission -->

+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

+

+    <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>

+

+</manifest>

new file mode 100644

@@ -0,0 +1,40 @@

+/*

+*  Copyright (C) 2018 Eduardo Zarate Lasurtegui

+*  Copyright (C) 2018, University of the Basque Country (UPV/EHU)

+*

+* Contact for licensing options: <licensing-mcpttclient(at)mcopenplatform(dot)com>

+*

+* This file is part of MCOP MCPTT Client

+*

+* This is free software: you can redistribute it and/or modify it under the terms of

+* the GNU General Public License as published by the Free Software Foundation, either version 3

+* of the License, or (at your option) any later version.

+*

+* This is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;

+* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

+* See the GNU General Public License for more details.

+*

+* You should have received a copy of the GNU General Public License along

+* with this program; if not, write to the Free Software Foundation, Inc.,

+* 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

+*/

+package org.mcopenplatform.muoapi;

+

+/**

+* AIDL definition {@link https://developer.android.com/guide/components/aidl.html}

+* Used as a callback for MCOP SDK server-client communication, and for MCPTT (Mission Critical Push to Talk) Services.

+* @author Eduardo Zarate Lasurtegui

+* @version 0.1

+*/

+interface IMCOPCallback {

+    /**

+     *

+     * Callback to be listened to by the client. It provides active events, responses to methods

+     * executed by the client, asynchronous events from the MCPTT system, and errors produced.

+     *

+     * @return

+     * @see org.mcopenplatform.muoapi.ConstantsMCOP.ActionsCallBack org.mcopenplatform.muoapi.ConstantsMCOP.ActionsCallBack (Types of actions that each of the callback events can have)

+     * @param actionList Intent list. Each component in the list contains an event.

+    */

+    void handleOnEvent(in List<Intent> actionList);

+}

\ No newline at end of file

new file mode 100644

@@ -0,0 +1,162 @@

+/*

+ *  Copyright (C) 2018 Eduardo Zarate Lasurtegui

+ *  Copyright (C) 2018, University of the Basque Country (UPV/EHU)

+ *

+ * Contact for licensing options: <licensing-mcpttclient(at)mcopenplatform(dot)com>

+ *

+ * This file is part of MCOP MCPTT Client

+ *

+ * This is free software: you can redistribute it and/or modify it under the terms of

+ * the GNU General Public License as published by the Free Software Foundation, either version 3

+ * of the License, or (at your option) any later version.

+ *

+ * This is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;

+ * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

+ * See the GNU General Public License for more details.

+ *

+ * You should have received a copy of the GNU General Public License along

+ * with this program; if not, write to the Free Software Foundation, Inc.,

+ * 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

+ */

+package org.mcopenplatform.muoapi;

+

+import org.mcopenplatform.muoapi.IMCOPCallback;

+

+/**

+ * AIDL definition {@link https://developer.android.com/guide/components/aidl.html}

+ * Used as a callback for MCOP SDK server-client communication, and for MCPTT (Mission Critical Push to Talk) Services.

+ * @author Eduardo Zarate Lasurtegui

+ * @version 0.1

+ */

+interface IMCOPsdk {

+    /**

+     * Allows to synchronously get the capabilities from the different MCPTT SDK plugins.

+     * @return Returns an structure with all the capabilities.

+     * @throws android.os.RemoteException

+     */

+    String getMCOPCapabilities();

+

+

+    boolean loginMCOP();

+

+    /**

+     * This method starts the MCPTT System unLogin procedure.

+     * No input parameters.

+     * In case of re-execution it restarts the unlogin procedure.

+     *

+     * @return  Indicates if the unLogin procedure can be started.

+     * @see org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestExtras org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestExtras (Definition of all the asynchronous response values of this method)

+     * @see org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestExtras org.mcopenplatform.muoapi.ConstantsMCOP.LoginEventExtras (Definition of all the asynchronous response values of this method and the errors)

+     *

+     */

+     boolean unLoginMCOP();

+

+     /**

+     * Once the authentication procedure has been carried out against a third party,

+     * this method must be called to continue with the Login process started

+     * with loginMCOP() method, defined in this AIDL.

+     *

+     * Before making the call to this method, the client must use the "request uri", obtained in the callback "org.mcopenplatform.muoapi.ConstantsMCOP.ActionsCallBack.authorizationRequestEvent",

+     * to authenticate against a third party, so that the SDK can verify the authentication with the "url" input parameter.

+     *

+     * @return  Indicates if the Login procedure can be started.

+     * @see org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestExtras org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestExtras (Definition of all the asynchronous response values of this method and the errors)

+     * @see org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestExtras org.mcopenplatform.muoapi.ConstantsMCOP.LoginEventExtras (Definition of all the asynchronous response values of this method and the errors)

+     * @param url. String with URL format where the parameters are indicated so that the SDK can authenticate the user.

+     */

+    boolean authorizeUser(String url);

+

+    /**

+     *

+     * Method to make MCPTT type calls. Allowed call types are limited.

+     * MCPTT services that a call can contain are listed in {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallTypeEnum}

+     *

+     * @return Indicates whether the make call procedure could be started. In case of invalid MCPTT session, FALSE is returned.

+     * @see org.mcopenplatform.muoapi.ConstantsMCOP.CallTypeEnum org.mcopenplatform.muoapi.ConstantsMCOP.CallTypeEnum (Definition of the MCPTT Services a call may contain)

+     * @see org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras (Definition of the different asynchronous responses this method can have through the callback)

+     * @param userID. String to identify the MCOP system user or group to call. If no identity is indicated, the selected contact will be called.

+     * @param callType. Integer that contains a series of FLAGs indicating the services for the new MCPTT session.

+     */

+    boolean makeCall(String userID, int callType);

+

+    /**

+     * Hang up an incoming, established or initiated MCPTT session.

+     * @param sessionID. Identifier of the specific MCPTT session where the specific action is carried out.

+     * @return Indicates whether the desired operation can be started.

+     * @throws android.os.RemoteException

+     */

+    boolean hangUpCall(String sessionID);

+

+    /**

+     * Accept an incoming MCPTT sesion.

+     * @param sessionID. Identifier of the specific MCPTT session where the specific action is carried out.

+     * @return Indicates whether the desired operation can be started.

+     * @throws android.os.RemoteException

+     */

+    boolean acceptCall(String sessionID);

+

+    /**

+     * Update the emergency state of a particular session.

+     * @param sessionID. Identifier of the specific MCPTT session to be updated.

+     * @param emergencyType. New emergency state of the session. It must be type {@link org.mcopenplatform.muoapi.ConstantsMCOP.EmergencyTypeEnum}

+     * @return Indicates whether the desired operation can be started.

+     * @see org.mcopenplatform.muoapi.ConstantsMCOP.EmergencyTypeEnum

+     * @throws android.os.RemoteException

+     */

+    boolean updateEmergencyState(String sessionID, int emergencyType);

+

+    /**

+     * Perform floor control operations over MCPTT sessions.

+     * @param sessionID Identifier of the specific MCPTT session where the specific action is carried out.

+     * @param requestType Type of action to be performed. It must be type {@link org.mcopenplatform.muoapi.ConstantsMCOP.FloorControlEventExtras.FloorControlOperationTypeEnum}

+     * @param UserID To be used in Video sessions, indicating the specific user to receive video from.

+     * @return Indicates whether the desired operation can be started.

+     * @throws android.os.RemoteException

+     */

+    boolean floorControlOperation(String sessionID, int requestType, String UserID);

+

+    /**

+     * Requests group information to the SDK,

+     * generating a type {@link org.mcopenplatform.muoapi.ConstantsMCOP.ActionsCallBack#groupInfoEvent} event callback.

+     * @return Indicates whether the desired operation can be started.

+     * @throws android.os.RemoteException

+     */

+    boolean updateGroupsInfo();

+

+    /**

+     * Requests group affiliation information to the SDK,

+     * generating a type {@link org.mcopenplatform.muoapi.ConstantsMCOP.ActionsCallBack#groupAffiliationEvent} event callback.

+     * @return Indicates whether the desired operation can be started.

+     * @throws android.os.RemoteException

+     */

+    boolean updateGroupsAffiliation();

+

+    /**

+     * Perform a group affiliation operation.

+     * @param groupMcpttId. Unequivocally identifies the group on which the operation is carried out. The group list will be received in the event {@link ConstantsMCOP.ActionsCallBack#groupAffiliationEvent}

+     * @param affiliationOperation. Operation to perform on the indicated group. Allowed actions: {@link org.mcopenplatform.muoapi.ConstantsMCOP.GroupAffiliationEventExtras.AffiliationOperationTypeEnum}.

+     * @return Indicates whether the desired operation can be started.

+     * @See org.mcopenplatform.muoapi.ConstantsMCOP.GroupAffiliationEventExtras

+     * @throws android.os.RemoteException

+     */

+    boolean groupAffiliationOperation(String groupMcpttId, int affiliationOperation);

+

+    /**

+     * Select default contact (user or group).

+     * @param groupID. Unequivocal identifier of the MCPTT group defined for default MCPTT sessions.

+     * @return Indicates whether the desired operation can be started.

+     * @See org.mcopenplatform.muoapi.ConstantsMCOP.SelectedContactChangeEventExtras

+     * @throws android.os.RemoteException

+     */

+    boolean changeSelectedContact(String groupID);

+

+     /**

+     * Register the callback defined by AIDL so that the SDK can send asynchronous events to the user.

+     * @param mcopCallBack. Callback where the different events are sent.

+     * @return Indicates whether the desired operation can be started.

+     * @see org.mcopenplatform.muoapi.ConstantsMCOP.ActionsCallBack

+     * @throws android.os.RemoteException

+     */

+    boolean registerCallback(IMCOPCallback mcopCallBack);

+}

+

new file mode 100644

Binary files /dev/null and b/app/src/main/ic_launcher-web.png differ

new file mode 100644

@@ -0,0 +1,1267 @@

+/*

+ *

+ *  Copyright (C) 2018 Eduardo Zarate Lasurtegui

+ *   Copyright (C) 2018, University of the Basque Country (UPV/EHU)

+ *

+ *  Contact for licensing options: <licensing-mcpttclient(at)mcopenplatform(dot)com>

+ *

+ *  This file is part of MCOP MCPTT Client

+ *

+ *  This is free software: you can redistribute it and/or modify it under the terms of

+ *  the GNU General Public License as published by the Free Software Foundation, either version 3

+ *  of the License, or (at your option) any later version.

+ *

+ *  This is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;

+ *  without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

+ *  See the GNU General Public License for more details.

+ *

+ *  You should have received a copy of the GNU General Public License along

+ *  with this program; if not, write to the Free Software Foundation, Inc.,

+ *  59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

+ */

+

+package org.test.client.mcopclient;

+

+

+import java.util.ArrayList;

+import java.util.HashMap;

+import java.util.List;

+import java.util.Map;

+

+/**

+ * MCOP MCPTT SDK

+ * Constants used on AIDLs

+ * @author Eduardo Zarate Lasurtegui

+ * @version 0.1

+ */

+public class ConstantsMCOP {

+

+    public static final int NO_ERROR=0;

+

+

+

+    /**

+     *

+     * Access keys to the values of event types {@link org.mcopenplatform.muoapi.ConstantsMCOP.ActionsCallBack#unLoginEvent}

+     * <p>This class contains all the answers to the actions of methods {@link IMCOPsdk#unLoginMCOP()} </p>

+     *

+     */

+    public static class UnLoginEventExtras{

+        /**

+         * <h2>Access key to the response to method {@link IMCOPsdk#unLoginMCOP()}}:</h2>

+         * <p>Response: boolean, indicates whether the unlogin procedure was successful or not.</p>

+         */

+        public static final String SUCCESS="org.mcopenplatform.muoapi.ConstantsMCOP.UnLoginEventExtras"+".SUCCESS";

+

+        /**

+         * <h2>Access key to the error codes of the login and authentication methods.</h2>

+         * <p>Response: Integer indicating the error code.</p>

+         * <p>Values:</p>

+         * <p>  205 It is not possible to unregister because the customer is not registered right now</p>

+         * <p>  207 There was an error in the unregistration process</p>

+         * <p>0 means no errors.</p>

+         * <p></p>

+         */

+        public static final String ERROR_CODE="org.mcopenplatform.muoapi.ConstantsMCOP.UnLoginEventExtras"+".ERROR_CODE";

+        /**

+         * <h2>Access key to error string for the login and authentication methods.</h2>

+         * <p>Resputa: String describing the error.</p>

+         */

+        public static final String ERROR_STRING="org.mcopenplatform.muoapi.ConstantsMCOP.UnLoginEventExtras"+".ERROR_STRING";

+    }

+

+    /**

+     *

+     * Access keys to the values of event types {@link org.mcopenplatform.muoapi.ConstantsMCOP.ActionsCallBack#loginEvent}

+     * <p>This class contains all the answers to the actions of methods {@link IMCOPsdk#loginMCOP()} and {@link IMCOPsdk#authorizeUser(String)} ()}</p>

+     *

+     */

+    public static class LoginEventExtras{

+        /**

+         * <h2>Access key to the response to method {@link IMCOPsdk#authorizeUser(String)}:</h2>

+         * <p>Response: boolean, indicates whether the login procedure was successful or not.</p>

+         */

+        public static final String SUCCESS="org.mcopenplatform.muoapi.ConstantsMCOP.LoginEventExtras"+".SUCCESS";

+        /**

+         * <h2>Access key to the MCPTT ID of the client once authenticated.</h2>

+         * <p>Response: String with URI format that unequivocally identifies the user in the MCPTT system.</p>

+         */

+        public static final String MCPTT_ID="org.mcopenplatform.muoapi.ConstantsMCOP.LoginEventExtras"+".MCPTT_ID";

+        /**

+         * <h2>Access key to the DISPLAY NAME of the client once authenticated.</h2>

+         * <p>Response: String that identifies the user with a human-readable alias, more pleasant than a MCPTT identifier.</p>

+         */

+        public static final String DISPLAY_NAME="org.mcopenplatform.muoapi.ConstantsMCOP.LoginEventExtras"+".DISPLAY_NAME";

+        /**

+         * <h2>Access key to the error codes of the login and authentication methods.</h2>

+         * <p>Response: Integer indicating the error code.</p>

+         * <p>Values:</p>

+         * <p>0 means no errors.</p>

+         * <p>1XX: xMS Errors:</p>

+         * <p>  101 Unknown GMS address</p>

+         * <p>  102 Unknown CMS address</p>

+         * <p>  103 Unknown KMS address</p>

+         * <p>  104 Incorrect answer from GMS</p>

+         * <p>  105 Incorrect answer from CMS</p>

+         * <p>  106 Incorrect answer from KMS</p>

+         * <p>  107 There was error with CMS</p>

+         * <p>2XX: IMS or SIM Authentication Errors:</p>

+         * <p>  201 IMS registration error</p>

+         * <p>  202 IMS authentication error</p>

+         * <p>  203 Synchronization error between SIM and IMS</p>

+         * <p>  204 SIM access error</p>

+         * <p>  205 It is not possible to register because the customer is registered right now</p>

+         * <p>  206 the URL for the authentication is not valid</p>

+         * <p>  207 There was an error in the registration process</p>

+         * <p>  208 Error in the authentication process</p>

+         * <p>3XX: IDMS Errors:</p>

+         */

+        public static final String ERROR_CODE="org.mcopenplatform.muoapi.ConstantsMCOP.LoginEventExtras"+".ERROR_CODE";

+        /**

+         * <h2>Access key to error string for the login and authentication methods.</h2>

+         * <p>Resputa: String describing the error.</p>

+         */

+        public static final String ERROR_STRING="org.mcopenplatform.muoapi.ConstantsMCOP.LoginEventExtras"+".ERROR_STRING";

+    }

+

+    /**

+     *

+     * <h1>Keys to access the values of authentication events by methods:</h1>

+     * <h2>     {@link IMCOPsdk#loginMCOP()}</h2>

+     * <h2>     {@link IMCOPsdk#authorizeUser(String)}</h2>

+     */

+    public static class AuthorizationRequestExtras{

+        /**

+         * <h2>Access key to the uri to request the user authentication to a third party.</h2>

+         * <p>This data is received once the call to the method {@link IMCOPsdk#loginMCOP()} is made.</p>

+         * <p>Response: URI format string</p>

+         */

+        public static final String REQUEST_URI="org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestActions"+".REQUEST_URI";

+        /**

+         * <h2>Access key to the uri answered by the third party authentication agent.</h2>

+         * <h3>Indicates when the third party authentication ends, and the method {@link IMCOPsdk#authorizeUser(String)} can be called with the authentication response.</h3>

+         * <p>This data is received once the call to the method {@link IMCOPsdk#loginMCOP()} is made.</p>

+         * <p>Response: URI format string</p>

+         */

+        public static final String REDIRECT_URI="org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestActions"+".REDIRECT_URI";

+        /**

+         * <h2>Access key to authentication error codes.</h2>

+         * <p>Response: Integer indicating the error code.</p>

+         * <p>Values:</p>

+         * <p></p>

+         * <p>0 indicates no errors</p>

+         */

+        public static final String ERROR_CODE="org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestActions"+".ERROR_CODE";

+        /**

+         * <h2>Access key to error codes string.</h2>

+         */

+        public static final String ERROR_STRING="org.mcopenplatform.muoapi.ConstantsMCOP.AuthorizationRequestActions"+".ERROR_STRING";

+    }

+

+

+    /**

+     *

+     * <h1>Access key to the values of all the configuration events of all the MCPTT services.</h1>

+     *

+     */

+    public static class ConfigurationUpdateEventExtras{

+

+        /**

+         * <h2>Access key to the organization that the user belongs to.</h2>

+         * <p>This data will be received once logged into the system.</p>

+         * <p>Response: String.</p>

+         */

+        public static final String ORGANIZATION="org.mcopenplatform.muoapi.ConstantsMCOP.LoginSuccessExtras"+".ORGANIZATION";

+

+        /**

+         * <h2>Access key to default emergency contact identifier that must be called in case of an emergency call with no destination specified.</h2>

+         * <p>This data will be received once logged in and each time the system changes the value or the user manually changes it with the method {@link IMCOPsdk#changeSelectedContact}</p>

+         * <p>Response: String with UserID format</p>

+         */

+        public static final String DEFAULT_EMERGERCY_CONTACT="org.mcopenplatform.muoapi.ConstantsMCOP.LoginSuccessExtras"+".DEFAULT_EMERGERCY_CONTACT";

+

+        /**

+         * <h2>Access key to ParticipantType, indicating the position of the user in the organization. Not defined in the 3GPP.</h2>

+         * <p>This data will be received once logged into the system or whenever the user receives a new configuration.</p>

+         * <p>Response: String.</p>

+         */

+        public static final String PARTICIPANT_TYPE="org.mcopenplatform.muoapi.ConstantsMCOP.LoginSuccessExtras"+".PARTICIPANT_TYPE";

+

+        /**

+         * <h2>Access key to the list of user granted permissions.</h2>

+         * <p>This data will be received once logged into the system or whenever the user receives a new configuration.</p>

+         * <p>Response: Integer with values of all the FLAGs that identify user allowed services</p>

+         * <p>Values: Sum of {@link AllowTypeEnum}</p>

+         * <p>  private_call (Private calls allowed) {@link AllowTypeEnum#private_call}</p>

+         * <p>  emergency_group_call (Emergency group calls allowed) {@link AllowTypeEnum#emergency_group_call}</p>

+         * <p>  emergency_private_call (Private emergency calls allowed){@link AllowTypeEnum#emergency_private_call}</p>

+         * <p>  imminent_peril_call (Imminent peril calls allowed){@link AllowTypeEnum#imminent_peril_call}</p>

+         * <p>  activate_emergency_alert (Alert calls allowed){@link AllowTypeEnum#activate_emergency_alert}</p>

+         * <p>NOTE: The absence of permissions in this list indicates that it is not allowed to make such type of calls, and any attempt will give an error in {@link CallEventExtras#ERROR_CODE}.</p>

+         */

+

+        public static final String ALLOWS_LIST="org.mcopenplatform.muoapi.ConstantsMCOP.ConfigurationUpdateEventExtras"+".ALLOWS_LIST";

+

+

+        /**

+         * <h2>Access key to configuration error codes.</h2>

+         * <p>Response: Integer indicating the error code.</p>

+         * <p>Values:</p>

+         *<p>Code	Explanatory text	Description</p>

+         *<p>101	It has been impossible to obtain authentication data</p>

+         * <p>0 means no errors</p>

+         */

+        public static final String ERROR_CODE="org.mcopenplatform.muoapi.ConstantsMCOP.ConfigurationUpdateEventExtras"+".ERROR_CODE";

+        /**

+         * <h2>Access key to the string of error codes</h2>

+         */

+        public static final String ERROR_STRING="org.mcopenplatform.muoapi.ConstantsMCOP.ConfigurationUpdateEventExtras"+".ERROR_STRING";

+

+        /**

+         * <h2>Type of permissions that the user obtains when receiving the data from key {@link ConfigurationUpdateEventExtras#ALLOWS_LIST}</h2>

+         */

+        public enum AllowTypeEnum {

+            none(0x00),

+            private_call (0x01),

+            emergency_group_call (0x01 << 1),

+            emergency_private_call (0x01 << 2),

+            imminent_peril_call (0x01 << 3),

+            activate_emergency_alert (0x01 << 4);

+            private int code;

+

+            AllowTypeEnum(int code) {

+                this.code = code;

+            }

+

+

+            public int getValue() {

+                return code;

+            }

+

+            public static List<AllowTypeEnum> getListAllowType(int num){

+                ArrayList<AllowTypeEnum> allowTypeEnums=new ArrayList<>();

+                for (ConstantsMCOP.ConfigurationUpdateEventExtras.AllowTypeEnum allowTypeEnum : ConstantsMCOP.ConfigurationUpdateEventExtras.AllowTypeEnum.values())

+                    if((num & allowTypeEnum.getValue())==allowTypeEnum.getValue())

+                        allowTypeEnums.add(allowTypeEnum);

+

+                return allowTypeEnums;

+            }

+

+            public static int getValue(List<AllowTypeEnum> allowTypeEnums){

+                int value=none.getValue();

+                for (ConstantsMCOP.ConfigurationUpdateEventExtras.AllowTypeEnum allowTypeEnum : allowTypeEnums)

+                    if(allowTypeEnum!=null)

+                        value+=allowTypeEnum.getValue();

+

+                return value;

+            }

+

+

+        }

+

+    }

+

+    /**

+     *

+     * Access keys to the values of type {@link org.mcopenplatform.muoapi.ConstantsMCOP.ActionsCallBack#callEvent} events.

+     *

+     */

+    public static class CallEventExtras{

+

+        /**

+         * <h2>Access key to event type:</h2>

+         * <p>Integer type values</p>

+         * <p>Possible event types:</p>

+         * <p>     INCOMING    (Incoming call of any MCPTT type) {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras.CallEventEventTypeEnum#INCOMING}</p>

+         * <p>     RINGING     (Destination of the call is ringing) {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras.CallEventEventTypeEnum#RINGING}</p>

+         * <p>     INPROGRESS  (MCPTT call in progress) {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras.CallEventEventTypeEnum#INPROGRESS}</p>

+         * <p>     CONNECTED   (Established call) {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras.CallEventEventTypeEnum#CONNECTED}</p>

+         * <p>     ERROR       (Any error in MCPTT calls) {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras.CallEventEventTypeEnum#ERROR}</p>

+         * <p>     UPDATE       (Any Change in Call) {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras.CallEventEventTypeEnum#UPDATE}</p>

+         */

+        public static final String EVENT_TYPE="org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras"+".EVENT_TYPE";

+

+

+        /**

+         *  <h2>Access key to MCPTT call session ID. This identifier is unique for each call.</h2>

+         *  <p>Present in all types of events {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras.CallEventEventTypeEnum}</p>

+         */

+        public static final String SESSION_ID="org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras"+".SESSION_ID";

+

+        /**

+         *  <h2>Access key to MCPTT call type.</h2>

+         *  <p>Present in event type {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras.CallEventEventTypeEnum#INCOMING} and {@link org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras.CallEventEventTypeEnum#UPDATE}</p>

+         */

+        public static final String CALL_TYPE="org.mcopenplatform.muoapi.ConstantsMCOP.CallEventExtras"+".CALL_TYPE";