Changelog
Android SDK changes
- Updated the Liveness on-device model.
- Added the Portuguese (Brazilian) locale.
- If a media hasn't been uploaded correctly, the system repeats the upload.
- Created a new method to retrieve the telemetry (logging) identifier:
getEventSessionId
. - The
login
andauth
methods are now deprecated. Use thesetAPIConnection
method instead. OzConfig.baseURL
andOzConfig.permanentAccessToken
are now deprecated.- If a user closes the screen during video capture, the appropriate error is now being handled by SDK.
- Fixed some bugs and improved the SDK work.
- Fixed errors.
- The SDK now works properly with
baseURL
set tonull
.
- The dependencies' versions have been brought into line with Kotlin version.
- Added the new analysis mode – hybrid (Liveness only). If the score received from an on-device analysis is too high, the system initiates a server-based analysis as an additional check.
- Kotlin version requirements lowered to 1.7.21.
- Improved the on-device models.
- For some phone models, fixed the fatal device error.
- The hint text width can now exceed the frame width (when using the main camera).
- Photos taken during the One Shot analysis are now being sent to the server in the original size.
- Removed the
OzAnalysisResult
class. TheonSuccess
method ofAnalysisRequest.run
now uses theRequestResult
structure instead ofList<OzAnalysisResult>.
- All exceptions are moved to the
com.ozforensics.liveness.sdk.core.exceptions
package (See changes below). - Classes related to
AnalysisRequest
are moved to thecom.ozforensics.liveness.sdk.analysis
package (See changes below). - The methods below are no longer supported:
Removed method | Replacement |
OzLivenessSDK.uploadMediaAndAnalyze | AnalysisRequest.run |
OzLivenessSDK.uploadMedia | AnalysisRequest.Builder.uploadMedia |
OzLivenessSDK.runOnDeviceBiometryAnalysis | AnalysisRequest.run |
OzLivenessSDK.runOnDeviceLivenessAnalysis | AnalysisRequest.run |
AnalysisRequest.build(): AnalysisRequest | - |
AnalysisRequest.Builder.addMedia | AnalysisRequest.Builder.uploadMedia |
AnalysisRequest.Type.HYBRID
incom.ozforensics.liveness.sdk.analysis.entity
AnalysisError
incom.ozforensics.liveness.sdk.analysis.entity
SourceMedia
incom.ozforensics.liveness.sdk.analysis.entity
ResultMedia
incom.ozforensics.liveness.sdk.analysis.entity
RequestResult
incom.ozforensics.liveness.sdk.analysis.entity
NoAnalysisException
fromcom.ozforensics.liveness.sdk.exceptions
вcom.ozforensics.liveness.sdk.core.exceptions
NoNetworkException
fromcom.ozforensics.liveness.sdk.exceptions
вcom.ozforensics.liveness.sdk.core.exceptions
TokenException
fromcom.ozforensics.liveness.sdk.exceptions
вcom.ozforensics.liveness.sdk.core.exceptions
NoMediaInAnalysisException
fromcom.ozforensics.liveness.sdk.exceptions
tocom.ozforensics.liveness.sdk.core.exceptions
EmptyMediaListException
fromcom.ozforensics.liveness.sdk.exceptions
tocom.ozforensics.liveness.sdk.core.exceptions
NoSuchMediaException
fromcom.ozforensics.liveness.sdk.exceptions
tocom.ozforensics.liveness.sdk.core.exceptions
LicenseException
fromcom.ozforensics.liveness.sdk.exceptions
tocom.ozforensics.liveness.sdk.security.exception
Analysis
fromcom.ozforensics.liveness.sdk.analysis.entity
tocom.ozforensics.liveness.sdk.core.model
AnalysisRequest
fromcom.ozforensics.liveness.sdk.analysis
tocom.ozforensics.liveness.sdk.core
AnalysisListener
fromcom.ozforensics.liveness.sdk.analysis
tocom.ozforensics.liveness.sdk.core
AnalysisStatus
fromcom.ozforensics.liveness.sdk.analysis
tocom.ozforensics.liveness.sdk.core
AnalysisRequest.Builder
fromcom.ozforensics.liveness.sdk.analysis
tocom.ozforensics.liveness.sdk.core
OzException
fromcom.ozforensics.liveness.sdk.exceptions
tocom.ozforensics.liveness.sdk.core.exceptions
OzLivenessSDK
- Removed
uploadMediaAndAnalyze
- Removed
uploadMedia
- Removed
runOnDeviceBiometryAnalysis
- Removed
runOnDeviceLivenessAnalysis
AnalysisRequest
- Removed
build(): AnalysisRequest
AnalysisRequest.Builder
- Removed
addMedia
- Removed
onSuccess(result: List<OzAnalysisResult>)
- Added
onSuccess(result: RequestResult)
- Restructured the settings screen.
- Added the center hint background customization.
- Added new face frame forms (Circle, Square).
- Added the antiscam widget and its customization. This feature allows you to alert your customers that the video recording is being conducted, for instance, for loan application purposes. The purpose of this is to safeguard against scammers who may attempt to deceive an individual into approving a fraudulent transaction.
- The
OzLivenessSDK::init
method no longer crashes if there is aStatusListener
parameter passed. - Changed the scan gesture animation.
Please note: for this version, we updated Kotlin to 1.8.20.
- Improved the SDK algorithms.
- Updated the model for the on-device analyses.
- Fixed the animation for sunglasses/mask.
- The oval size for Liveness is now smaller.
- Fixed the error with the server-based analyses while using
permanentAccessToken
for authorization.
- You can now hide the status bar and system buttons (works with 7.0.0 and higher).
OzLivenessSDK.init
now requirescontext
as the first parameter.OzAnalysisResult
now shows the server-based analyses' scores properly.- Fixed initialization issues, displaying of wrong customization settings, authorization failures on Android <7.1.1.
- Fixed crashes for Android <6.
- Fixed oval positioning for some phone models.
- Internal fixes and improvements.
- Updated security.
- Implemented some internal improvements.
- The
addMedia
method is now deprecated, please useuploadMedia
for uploading.
- Changed the way of sharing dependencies. Due to security issues, now we share two types of libraries as shown below:
sdk
is a server analysis only,full
provides both server and on-device analyses:
implementation 'com.ozforensics.liveness:full:7.0.0'
implementation 'com.ozforensics.liveness:sdk:7.0.0'
- Implemented a range of UI customization options and switched to the new design. To restore the previous settings, please refer to this article.
- Added the Spanish locale.
- Fixed the bug with freezes that had appeared on some phone models.
- SDK now captures videos in 720p.
- Synchronized the names of the analysis modes with iOS: SERVER_BASED and ON_DEVICE.
- Fixed the bug with displaying of localization settings.
- Now you can use Fragment as Liveness screen.
- Added a new field to the
Analysis
structure. Theparams
field is for any additional parameters, for instance, if you need to set extracting the best shot on server to true. The best shot algorithm chooses the most high-quality frame from a video.
- The Zoom in and Zoom out gestures are no longer supported.
- Updated the biometry model.
- Added a new simplified API – AnalysisRequest. With it, it’s easier to create a request for the media and analysis you need.
- Published the on-device module for on-device liveness and biometry analyses. To add this module to your project, use:
implementation 'com.ozforensics.liveness:on-device:6.3.4'
To launch these analyses, use
runOnDeviceBiometryAnalysis
and runOnDeviceLivenessAnalysis
methods from the OzLivenessSDK
class:val mediaList: List<OzAbstractMedia> = ...
val biometryAnalysisResult: OzAnalysisResult = OzLivenessSDK.runOnDeviceBiometryAnalysis(mediaList)
val livenessAnalysisResult: OzAnalysisResult = OzLivenessSDK.runOnDeviceLivenessAnalysis(mediaList)
- Liveness goes smoother.
- Fixed freezes on Xiaomi devices.
- Optimized image converting.
- New metadata parameter for
OzLivenessSDK.uploadMedia
and newOzLivenessSDK.uploadMediaAndAnalyze
method to pass this parameter to folders.
- Added functions for SDK initialization with LicenseSources:
LicenseSource.LicenseAssetId
andLicenseSource.LicenseFilePath
. Use theOzLivenessSDK.init
method to start initialization. - Now you can get the license info upon initialization
val licensePayload = OzLivenessSDK.getLicensePayload().
- Added the Kyrgyz locale.
- Added local analysis functions.
- You can now configure the face frame.
- Fixed version number at the Liveness screen.
- Added the main camera support.
- Added configuration from license support.
- Added the OneShot gesture.
- Added new states for
OzAnalysisResult.Resolution.
- Added the
uploadMediaAndAnalyze
method to load a bunch of media to the server at once and send them to analysis immediately. OzMedia
is renamed toOzAbstractMedia
and got subclasses for images and videos.- Fixed camera bugs for some devices.
- Access token updates automatically.
- Renamed
accessToken
topermanentAccessToken
. - Added R8 rules.
- Configuration became easier: config settings are mutable.
- Fixed the oval frame.
- Removed the unusable parameters from
AnalyseRequest
. - Removed default attempt limits.
- To customize the configuration options, the config property is added instead of baseURL, accessToken, etc. Use
OzConfig.Builder
for initialization. - Added license support. Licences should be installed as raw resources. To pass them to
OzConfig
, usesetLicenseResourceId
. - Replaced the context-dependent methods with analogs.
- Improved the image analysis.
- Removed unusable dependencies
- Fixed logging
Last modified 23d ago