Changes between SDK versions for Android
Changes between SDK versions for Android
Changes in version 3.0.0 compared to 2.2.0
Methods are now grouped by different interfaces:
For example, it was:
TrueConfSDK.getInstance().joinConf(confId); TrueConfSDK.getInstance().logout();Became:
TrueConfSDK.getConferenceManager().joinConf(confId); TrueConfSDK.getServerManager().logout();Significant changes have been made to audio management:
The methods
isSpeakerMuted,getAudioDevices, andonAudioPairChangedhave been removed.To obtain the current list of audio output devices, you need to execute the
requestAudioStatequery and implement theonAudioDeviceResponsemethod from theAudioDeviceCallbackinterface. Additionally, this callback includes theonAudioDeviceChangedandonAudioDeviceUpdatemethods.To change the default output device, you must first execute the
requestAudioStatequery and only then set the device using thesetDefaultAudioDevicemethod.In the
ConferenceFragment,IncomingCallFragment, andPlaceCallFragmentfragments, the methodsonSwitchMicAppliedandonMuteSpeakerAppliedhave been removed. Instead, you need to implement the interfaceAudioDeviceCallback.The methods
muteMicrophone,muteSpeaker, andchangeAudioDeviceshould only be used during a conference; otherwise, they will not work due to verification.
Changes in video management:
Added the
onVideoDeviceUpdatemethod to notify about changes in the camera status.In the
ConferenceFragment,IncomingCallFragment, andPlaceCallFragment, theonSwitchCameraAppliedmethod has been removed.The
muteCameramethod should only be used during a conference; otherwise, it will not work due to validation.
Paths to some important classes have been changed, such as the custom button class, as well as
TrueConfListenerandCallCast.Was:
com.trueconf.sdk.data.TCSDKExtraButton com.trueconf.sdk.interfaces.TrueConfListener com.trueconf.sdk.gui.activities.CallCastBecame:
com.trueconf.sdk.presentation.views.TCExtraButton com.trueconf.sdk.TrueConfListener com.trueconf.sdk.presentation.activities.CallCastThe
onStateChangedmethod receives the parameterFSM.State newState, which returns the new user status (userOffline,userOnline,userBusy, etc.). The list of statuses is provided in the table in the "Types. UserPresStatus" section.Some icon names for customization have been changed:
The
ic_rotateicon now replaces theic_selfie_icon. Additionally, a resize iconic_minimize_fullscreenhas been added to the self-view video.The icons
shape_circle_background_red_pressedandshape_circle_background_redare no longer used;Added the
conf_button_backicon to change the background of buttons.
See the complete list in Example 5: Interface Customization.
Libraries are built using Java 17 (previously Java 11).
Within the SDK, the OpenSSL 1.1.1w and SQLite 3.47.0 libraries have been updated.
Dragging your own video on the conference screen is supported.
The versions of some dependencies required for the SDK have been changed. The complete list is provided in the integration with Android Studio section.
Changes in version 2.2.0 compared to 1.3.3
Android SDK is now distributed through a Maven repository, accessible with a login and password provided upon request through your manager. You need to add the Maven repository in the repositories section of the Gradle file as follows:
maven { credentials { username 'username' password 'password' } url 'https://sdk.trueconf.com/maven/repository/maven-public/' }To integrate the SDK, you need to add three libraries to the dependencies section in the
.gradleconfiguration file:api 'com.trueconf:trueconfsdk:2.2.0.101@aar' api 'com.trueconf:media:2.2.0.101@aar' api 'com.trueconf:jnicore:2.2.0.101@aar'The minimum Android version is now 7.0 (minSdkVersion 24).
Connect the SDK to the project classes using the following lines:
import com.trueconf.sdk.TrueConfSDK;// to work with SDK methods import com.trueconf.sdk.TrueConfListener; // to work with SDK eventsBefore calling the
startmethod, you need to call theregisterAppmethod and pass a subclass ofApplicationto it, for example:```plaintext public class TestApp extends Application { @Override public void onCreate() { super.onCreate(); TrueConfSDK.getInstance().registerApp(this); TrueConfSDK.getInstance().start("server.name", true); ... } }You need to call the
setFallbackActivitymethod, specifying theActivityclass to return to when the call ends. For example:```java public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); TrueConfSDK.getInstance().setFallbackActivity(MainActivity.class); ... } }In the manifest file, it is no longer necessary to include the activity
com.vc.gui.activities.Call,com.vc.gui.activities.PermissionActivity, and theservice com.vc.service.ExternalSchemeHelperService.Customization options have been expanded: you can now place your own video and the video of conference participants in a separate fragment, as well as change the size and coordinates of participants' video windows. Details are described in the documentation for example 7.
Some changes in the methods, namely:
The
Contextparameter has been removed from thestartmethod;Added the
registerAppmethod, where you need to specify a subclass ofApplication.A method
setFallbackActivityhas been added, where you need to specify theActivityclass to which the system should return when the call ends.Methods for managing speakers have been added (
muteSpeaker,isSpeakerMuted,setDefaultSpeakerEnabled,getAudioDevices,getCurrentAudioDevice,setAudioDevice);onContactListUpdate- an event inTrueConfListener.UserStatusEventsCallbackthat occurs when the contact list and their statuses are loaded after the user logs into the server.A new interface has been added -
TrueConfListener.AudioDeviceCallback, which contains two methods:onAudioPairChanged(called when the output device is changed) andonAudioDeviceListChanged(called when the device list is changed);Added methods
setDefaultAudioEnabledandsetDefaultCameraEnabledto set the default state of the microphone and camera, respectively;The methods
microphoneMutedandcameraMutedhave been renamed toisMicrophoneMutedandisCameraMuted, respectively;The
trueConfSDKLogEnableflag, which enabled advanced SDK logging, has been removed (now they are always recorded). ThestartSavingLogsandstopSavingLogsmethods have also been removed since logs are automatically collected in the./files/logssubdirectory.
