#Added the new listener OnAppCalledListener and deprecated setOnYotiCalledListener

#YM-23299

Author: ChethanYoti

README.md

@@ -208,7 +208,7 @@ yotiSDKButton.setOnYotiButtonListener(new YotiSDKButton.OnYotiButtonClickListene
 There is also a listener that you can set to be notified when the intent has been sent to the Yoti app.
 When this happens you would probably want to restore your state.
 
-
+Attention: This listener is now deprecated.
 ```java
         yotiSDKButton.setOnYotiCalledListener(new YotiSDKButton.OnYotiCalledListener() {
             @Override
@@ -217,6 +217,16 @@ When this happens you would probably want to restore your state.
             }
         }); 
 ```
+Please use the below listener to get notified when the intent has been sent to app based on the specified theme:
+```java
+        yotiSDKButton.setOnAppCalledListener(new YotiSDKButton.OnAppCalledListener() {
+            @Override
+            public void onAppCalled() {
+                // Restore the original state
+            }
+        }); 
+```
+
 [See this code in one of our sample apps](./sample-app/src/main/java/com/yoti/mobile/android/sdk/sampleapp/MainActivity.java)
 
 You can activate a verbose mode for the SDK by using this method :

sample-app-3/src/main/java/com/yoti/mobile/android/sdk/sampleapp/MainActivity.java

@@ -126,10 +126,13 @@ public void onStartScenarioError(YotiSDKException cause) {
             launchAppUrl(appURL);
         });
 
-        yotiSDKButton.setOnYotiCalledListener(() -> {
-            // Restore the original state
-            yotiSDKButton.setVisibility(View.VISIBLE);
-            showStatus(true, R.string.result_status_openYoti);
+        mYotiSDKButton.setOnAppCalledListener(new YotiSDKButton.OnAppCalledListener() {
+            @Override
+            public void onAppCalled() {
+                // Restore the original state
+                mYotiSDKButton.setVisibility(View.VISIBLE);
+                showStatus(true, R.string.result_status_openYoti);
+            }
         });
     }
 

sample-app/src/main/java/com/yoti/mobile/android/sdk/sampleapp/MainActivity.java

@@ -57,9 +57,9 @@ public void onYotiAppNotInstalledError(YotiSDKNoYotiAppException cause) {
             }
         });
 
-        mYotiSDKButton.setOnYotiCalledListener(new YotiSDKButton.OnYotiCalledListener() {
+        mYotiSDKButton.setOnAppCalledListener(new YotiSDKButton.OnAppCalledListener() {
             @Override
-            public void onYotiCalled() {
+            public void onAppCalled() {
                 // Restore the original state
                 mYotiSDKButton.setVisibility(View.VISIBLE);
                 mProgress.setVisibility(View.GONE);

yoti-sdk/src/main/java/com/yoti/mobile/android/sdk/YotiSDKButton.java

@@ -25,6 +25,7 @@ public final class YotiSDKButton extends YotiButtonContainer {
     private OnYotiAppNotInstalledListener mOnYotiAppNotInstalledListener;
     private OnAppNotInstalledListener mOnAppNotInstalledListener;
     private OnYotiCalledListener mOnYotiCalledListener;
+    private OnAppCalledListener mOnAppCalledListener;
 
     private ResultReceiver mYotiCallResultReceiver = new ResultReceiver(new Handler()) {
         @Override
@@ -33,6 +34,10 @@ protected void onReceiveResult(int resultCode, Bundle resultData) {
             if (mOnYotiCalledListener != null) {
                 mOnYotiCalledListener.onYotiCalled();
             }
+
+            if (mOnAppCalledListener != null) {
+                mOnAppCalledListener.onAppCalled();
+            }
         }
     };
 
@@ -110,9 +115,14 @@ public void setOnAppNotInstalledListener(@Nullable OnAppNotInstalledListener lis
     }
 
     public void setOnYotiCalledListener(@Nullable OnYotiCalledListener listener) {
+        YotiSDKLogger.warning("The method 'setOnYotiCalledListener' is now deprecated. Please use 'setOnAppCalledListener' instead.");
         mOnYotiCalledListener = listener;
     }
 
+    public void setOnAppCalledListener(@Nullable OnAppCalledListener listener) {
+        mOnAppCalledListener = listener;
+    }
+
     @Override
     protected void onSdkButtonClicked() {
 
@@ -175,4 +185,8 @@ public interface OnAppNotInstalledListener {
     public interface OnYotiCalledListener {
         void onYotiCalled();
     }
+
+    public interface OnAppCalledListener {
+        void onAppCalled();
+    }
 }