প্রতিকার ডায়ালগ

এই পৃষ্ঠায় ইন্টিগ্রিটি ভার্ডিক্ট সংক্রান্ত সমস্যাগুলো কীভাবে সমাধান করতে হয় তা বর্ণনা করা হয়েছে।

একটি ইন্টিগ্রিটি টোকেনের জন্য অনুরোধ করার পরে, ব্যবহারকারীকে একটি গুগল প্লে ডায়ালগ দেখানোর বিকল্প থাকে। ইন্টিগ্রিটি ভারডিক্টে এক বা একাধিক সমস্যা থাকলে অথবা ইন্টিগ্রিটি এপিআই অনুরোধের সময় কোনো ব্যতিক্রম ঘটলে আপনি এই ডায়ালগটি দেখাতে পারেন। ডায়ালগটি বন্ধ হয়ে গেলে, আরেকটি ইন্টিগ্রিটি টোকেন অনুরোধের মাধ্যমে আপনি যাচাই করতে পারেন যে সমস্যাটি সমাধান হয়েছে কিনা। আপনি যদি সাধারণ অনুরোধ করেন, তবে একটি নতুন ভারডিক্ট পেতে আপনাকে টোকেন প্রোভাইডারকে আবার ওয়ার্ম আপ করতে হবে।

রায়ের সমস্যা সমাধানের জন্য একটি ইন্টিগ্রিটি ডায়ালগের অনুরোধ করুন।

যখন ক্লায়েন্ট একটি ইন্টিগ্রিটি টোকেনের জন্য অনুরোধ করে, তখন আপনি StandardIntegrityToken (স্ট্যান্ডার্ড এপিআই) এবং IntegrityTokenResponse (ক্লাসিক এপিআই)-এ প্রদত্ত পদ্ধতিটি ব্যবহার করতে পারেন: showDialog(Activity activity, int integrityDialogTypeCode) ।

নিম্নলিখিত ধাপগুলিতে বর্ণনা করা হয়েছে কিভাবে আপনি GET_LICENSED ডায়ালগ কোড ব্যবহার করে প্লে ইন্টিগ্রিটি এপিআই (Play Integrity API) এর মাধ্যমে একটি প্রতিকারমূলক ডায়ালগ দেখাতে পারেন। আপনার অ্যাপ অনুরোধ করতে পারে এমন অন্যান্য ডায়ালগ কোডগুলি এই বিভাগের পরে তালিকাভুক্ত করা হয়েছে।

1. আপনার অ্যাপ থেকে একটি ইন্টিগ্রিটি টোকেনের জন্য অনুরোধ করুন এবং টোকেনটি আপনার সার্ভারে পাঠান। আপনি স্ট্যান্ডার্ড বা ক্লাসিক অনুরোধ ব্যবহার করতে পারেন।

   কোটলিন

   // Request an integrity token
   val tokenResponse: StandardIntegrityToken = requestIntegrityToken()
   // Send token to app server and get response on what to do next
   val yourServerResponse: YourServerResponse = sendToServer(tokenResponse.token())  

   জাভা

   // Request an integrity token
   StandardIntegrityToken tokenResponse = requestIntegrityToken();
   // Send token to app server and get response on what to do next
   YourServerResponse yourServerResponse = sendToServer(tokenResponse.token());  

   ঐক্য

   // Request an integrity token
   StandardIntegrityToken tokenResponse = RequestIntegrityToken();
   // Send token to app server and get response on what to do next
   YourServerResponse yourServerResponse = sendToServer(tokenResponse.Token); 

   আনরিয়েল ইঞ্জিন

   // Request an integrity token
   StandardIntegrityToken* Response = RequestIntegrityToken();
   // Send token to app server and get response on what to do next
   YourServerResponse YourServerResponse = SendToServer(Response->Token); 

   স্থানীয়

   /// Request an integrity token
   StandardIntegrityToken* response = requestIntegrityToken();
   /// Send token to app server and get response on what to do next
   YourServerResponse yourServerResponse = sendToServer(StandardIntegrityToken_getToken(response));

2. আপনার সার্ভারে, ইন্টিগ্রিটি টোকেনটি ডিক্রিপ্ট করুন এবং appLicensingVerdict ফিল্ডটি পরীক্ষা করুন। এটি দেখতে অনেকটা এইরকম হতে পারে:

   // Licensing issue
   {
     ...
     "accountDetails": {
         "appLicensingVerdict": "UNLICENSED"
     }
   }

3. যদি টোকেনটিতে appLicensingVerdict: "UNLICENSED" থাকে, তাহলে আপনার অ্যাপ ক্লায়েন্টকে লাইসেন্সিং ডায়ালগটি দেখানোর অনুরোধ জানিয়ে উত্তর দিন:

   কোটলিন

   private fun getDialogTypeCode(integrityToken: String): Int{
     // Get licensing verdict from decrypted and verified integritytoken
     val licensingVerdict: String = getLicensingVerdictFromDecryptedToken(integrityToken)
   
     return if (licensingVerdict == "UNLICENSED") {
             1 // GET_LICENSED
         } else 0
   }

   জাভা

   private int getDialogTypeCode(String integrityToken) {
     // Get licensing verdict from decrypted and verified integrityToken
     String licensingVerdict = getLicensingVerdictFromDecryptedToken(integrityToken);
   
     if (licensingVerdict.equals("UNLICENSED")) {
       return 1; // GET_LICENSED
     }
     return 0;
   }

   ঐক্য

   private int GetDialogTypeCode(string IntegrityToken) {
     // Get licensing verdict from decrypted and verified integrityToken
     string licensingVerdict = GetLicensingVerdictFromDecryptedToken(IntegrityToken);
   
     if (licensingVerdict == "UNLICENSED") {
       return 1; // GET_LICENSED
     }
     return 0;
   } 

   আনরিয়েল ইঞ্জিন

   private int GetDialogTypeCode(FString IntegrityToken) {
     // Get licensing verdict from decrypted and verified integrityToken
     FString LicensingVerdict = GetLicensingVerdictFromDecryptedToken(IntegrityToken);
   
     if (LicensingVerdict == "UNLICENSED") {
       return 1; // GET_LICENSED
     }
     return 0;
   } 

   স্থানীয়

   private int getDialogTypeCode(string integrity_token) {
     /// Get licensing verdict from decrypted and verified integrityToken
     string licensing_verdict = getLicensingVerdictFromDecryptedToken(integrity_token);
   
     if (licensing_verdict == "UNLICENSED") {
       return 1; // GET_LICENSED
     }
     return 0;
   }

4. আপনার অ্যাপে, সার্ভার থেকে প্রাপ্ত অনুরোধকৃত কোড সহ showDialog কল করুন:

   কোটলিন

   // Show dialog as indicated by the server
   val showDialogType: Int? = yourServerResponse.integrityDialogTypeCode()
   if (showDialogType == null) {
      return
   }
   
   // Create dialog request
   val dialogRequest = StandardIntegrityDialogRequest.builder()
           .setActivity(activity)
           .setTypeCode(showDialogType)
           .setStandardIntegrityResponse(StandardIntegrityResponse.TokenResponse(token))
           .build()
   
   // Call showDialog, the dialog will be shown on top of the provided activity
   // and the task will complete when the dialog is closed.
   val result: Task<Int> = standardIntegrityManager.showDialog(dialogRequest)
   
   // Handle response code, call the Integrity API again to confirm that the
   // verdict issue has been resolved. 

   জাভা

   // Show dialog as indicated by the server
   @Nullable Integer showDialogType = yourServerResponse.integrityDialogTypeCode();
   if (showDialogType == null) {
      return;
   }
   
   // Create dialog request
   StandardIntegrityDialogRequest dialogRequest =
       StandardIntegrityDialogRequest.builder()
           .setActivity(getActivity())
           .setTypeCode(showDialogTypeCode)
           .setStandardIntegrityResponse(new StandardIntegrityResponse.TokenResponse(token))
           .build();
   
   // Call showDialog, the dialog will be shown on top of the provided activity
   // and the task will complete when the dialog is closed.
   Task<Integer> result = standardIntegrityManager.showDialog(dialogRequest);
   
   // Handle response code, call the Integrity API again to confirm that the
   // verdict issue has been resolved.

   ঐক্য

   // Initialize the V2 manager. Requires Play Integrity Unity Plugin v2.0.0 or
   // higher.
   var standardIntegrityManager = new StandardIntegrityManagerV2();
   IEnumerator ShowDialogCoroutine() {
     int showDialogType = yourServerResponse.IntegrityDialogTypeCode();
   
     PlayAsyncOperation<IntegrityDialogResponseCode, StandardIntegrityError> showDialogTask;
   
     using (var activity = UnityPlayerHelper.GetCurrentActivity())
     {
         // Create a dialog request
         var dialogRequest = new StandardIntegrityDialogRequest(tokenResponse, activity, showDialogType);
   
         // Call showDialog with the request, the dialog will be shown on top of the
         // provided activity and complete when the dialog is closed.
         showDialogTask = standardIntegrityManager.ShowDialog(dialogRequest);
     }
   
     // Wait for PlayAsyncOperation to complete.
     yield return showDialogTask;
   
     // Handle response code, call the Integrity API again to confirm that the
     // verdict issue been resolved.
   } 

   আনরিয়েল ইঞ্জিন

   // .h
   void MyClass::OnShowDialogCompleted(
     EStandardIntegrityErrorCode Error,
     EIntegrityDialogResponseCode Response)
   {
     // Handle response code, call the Integrity API again to confirm that the
     // verdict issue has been resolved.
   }
   
   // .cpp
   void MyClass::RequestIntegrityToken()
   {
     UStandardIntegrityToken* Response = ...
     int TypeCode = YourServerResponse.integrityDialogTypeCode();
   
     // Create a delegate to bind the callback function.
     FShowDialogStandardOperationCompletedDelegate Delegate;
   
     // Bind the completion handler (OnShowDialogCompleted) to the delegate.
     Delegate.BindDynamic(this, &MyClass::OnShowDialogCompleted);
   
     // Call ShowDialog with TypeCode which completes when the dialog is closed.
     Response->ShowDialog(TypeCode, Delegate);
   }

   স্থানীয়

   // Show dialog as indicated by the server
   int show_dialog_type = yourServerResponse.integrityDialogTypeCode();
   if(show_dialog_type == 0){
   return;
   }
   
   /// Create dialog request
   StandardIntegrityDialogRequest* dialog_request;
   StandardIntegrityDialogRequest_create(&dialog_request);
   StandardIntegrityDialogRequest_setTypeCode(dialog_request, show_dialog_type);
   StandardIntegrityDialogRequest_setActivity(dialog_request, activity);
   StandardIntegrityDialogRequest_setStandardIntegrityToken(dialog_request,
                                                 token_response);
   
   /// Call showDialog with the dialog request. The dialog will be shown on top
   /// of the provided activity and complete when the dialog is closed by the
   /// user.
   StandardIntegrityDialogResponse* dialog_response;
   StandardIntegrityErrorCode error_code =
     StandardIntegrityManager_showDialog(dialog_request, &dialog_response);
   
   /// Use polling to wait for the async operation to complete. Note, the polling
   /// shouldn't block the thread where the StandardIntegrityManager is running.
   IntegrityDialogResponseCode response_code = INTEGRITY_DIALOG_RESPONSE_UNKNOWN;
   while (error_code == STANDARD_INTEGRITY_NO_ERROR) {
     error_code = StandardIntegrityDialogResponse_getResponseCode(dialog_response, &response_code);
     if(response_code != INTEGRITY_DIALOG_RESPONSE_UNKNOWN){
       break;
     }
   }
   
   /// Free memory
   StandardIntegrityDialogRequest_destroy(dialog_request);
   StandardIntegrityDialogResponse_destroy(dialog_response);
   
   /// Handle response code, call the Integrity API again to confirm that the
   /// verdict issues have been resolved.

5. ডায়ালগটি প্রদত্ত অ্যাক্টিভিটির উপরে প্রদর্শিত হয়। ব্যবহারকারী ডায়ালগটি বন্ধ করলে, একটি রেসপন্স কোড সহ টাস্কটি সম্পন্ন হয়।

6. (ঐচ্ছিক) পরবর্তী যেকোনো ডায়ালগ প্রদর্শনের জন্য আরেকটি টোকেনের অনুরোধ করুন। আপনি যদি সাধারণ অনুরোধ করেন, তবে একটি নতুন রায় পেতে আপনাকে টোকেন প্রদানকারীকে পুনরায় সক্রিয় করতে হবে।

ক্লায়েন্ট সাইড এক্সেপশন ঠিক করার জন্য একটি ইন্টিগ্রিটি ডায়ালগের অনুরোধ করুন।

যদি কোনো Integrity API অনুরোধ StandardIntegrityException (Standard API) বা IntegrityServiceException (Classic API) এর কারণে ব্যর্থ হয় এবং ব্যতিক্রমটি সংশোধনযোগ্য হয়, তাহলে আপনি ত্রুটিটি ঠিক করার জন্য GET_INTEGRITY অথবা GET_STRONG_INTEGRITY ডায়ালগ ব্যবহার করতে পারেন।

নিম্নলিখিত ধাপগুলিতে বর্ণনা করা হয়েছে কিভাবে আপনি Integrity API দ্বারা রিপোর্ট করা একটি সংশোধনযোগ্য ক্লায়েন্ট-সাইড ত্রুটি সমাধান করতে GET_INTEGRITY ডায়ালগটি ব্যবহার করতে পারেন।

1. Integrity API অনুরোধ থেকে প্রাপ্ত ব্যতিক্রমটি প্রতিকারযোগ্য কিনা তা যাচাই করুন।

   কোটলিন

   private fun isExceptionRemediable(exception: ExecutionException): Boolean {
     val cause = exception.cause
     if (cause is StandardIntegrityException && cause.isRemediable) {
         return true
     }
     return false
   }

   জাভা

   private boolean isExceptionRemediable(ExecutionException exception) {
     Throwable cause = exception.getCause();
     if (cause instanceof StandardIntegrityException integrityException
   && integrityException.isRemediable()) {
         return true;
     }
     return false;
   }

   ঐক্য

   private bool IsExceptionRemediable(StandardIntegrityError error) {
     // Check if the operation resulted in a remediable error
     if (error != null && error.ErrorCode != StandardIntegrityErrorCode.NoError && error.IsRemediable) {
         return true;
     }
     return false;
   }

   স্থানীয়

   bool IsErrorRemediable(StandardIntegrityToken* token) {
     /// Check if the error associated with the token is remediable
     bool isRemediable = false;
     if(StandardIntegrityToken_getIsRemediable(response, &isRemediable) == STANDARD_INTEGRITY_NO_ERROR){
       return isRemediable;
     }
     return false;
   }

2. যদি ব্যতিক্রমটি সংশোধনযোগ্য হয়, তবে ফেরত আসা ব্যতিক্রমটি ব্যবহার করে GET_INTEGRITY ডায়ালগটির জন্য অনুরোধ করুন। ডায়ালগটি প্রদত্ত অ্যাক্টিভিটির উপরে প্রদর্শিত হবে এবং ব্যবহারকারী ডায়ালগটি বন্ধ করার পর ফেরত আসা টাস্কটি একটি রেসপন্স কোডসহ সম্পন্ন হবে।

   কোটলিন

   private fun showDialog(exception: StandardIntegrityException) {
     // Create a dialog request
     val standardIntegrityDialogRequest =
         StandardIntegrityDialogRequest.builder()
             .setActivity(activity)
             .setType(IntegrityDialogTypeCode.GET_INTEGRITY)
             .setStandardIntegrityResponse(ExceptionDetails(exception))
             .build()
   
     // Request dialog
     val responseCode: Task<Int> =
           standardIntegrityManager.showDialog(standardIntegrityDialogRequest)
   }
    

   জাভা

   private void showDialog(StandardIntegrityException exception) {
     // Create a dialog request
     StandardIntegrityDialogRequest standardIntegrityDialogRequest =
         StandardIntegrityDialogRequest.builder()
             .setActivity(this.activity)
             .setType(IntegrityDialogTypeCode.GET_INTEGRITY)
             .setStandardIntegrityResponse(new ExceptionDetails(exception))
             .build();
   
     // Request dialog
     Task<Integer> responseCode =
           standardIntegrityManager.showDialog(standardIntegrityDialogRequest);
   }  

   ঐক্য

   // Initialize the V2 manager. Requires Play Integrity Unity Plugin v2.0.0 or
   // higher.
   var standardIntegrityManager = new StandardIntegrityManagerV2();
   IEnumerator ShowDialogToFixError(StandardIntegrityError error) {
     PlayAsyncOperation<IntegrityDialogResponseCode, StandardIntegrityError> showDialogTask;
   
     using (var activity = UnityPlayerHelper.GetCurrentActivity())
     {
         // Create a dialog request using the error
         var dialogRequest = new StandardIntegrityDialogRequest(error, activity, GET_INTEGRITY_DIALOG);
   
         // Request dialog
         showDialogTask = standardIntegrityManager.ShowDialog(dialogRequest);
     }
   
     // Wait for PlayAsyncOperation to complete.
     yield return showDialogTask;
   }

   স্থানীয়

   private void showDialogToFixError(StandardIntegrityToken* token) {
     /// If the token request failed, and the underlying error is not fixable
     /// then return early
     if(isErrorRemediable(token)) {
       return;
     }
   
     /// Create dialog request
     StandardIntegrityDialogRequest* dialog_request;
     StandardIntegrityDialogRequest_create(&dialog_request);
     StandardIntegrityDialogRequest_setTypeCode(dialog_request,
                                        kGetIntegrityDialogTypeCode);
     StandardIntegrityDialogRequest_setActivity(dialog_request, activity);
     StandardIntegrityDialogRequest_setStandardIntegrityToken(dialog_request,
                                                     token_response);
   
     /// Call showDialog with the dialog request. The dialog will be shown on
     /// top of the provided activity and complete when the dialog is closed by
     /// the user.
     StandardIntegrityDialogResponse* dialog_response;
     StandardIntegrityErrorCode error_code =
         StandardIntegrityManager_showDialog(dialog_request, &dialog_response);
   
     /// Use polling to wait for the async operation to complete.
     /// Note, the polling shouldn't block the thread where the
     /// StandardIntegrityManager is running.
     IntegrityDialogResponseCode response_code = INTEGRITY_DIALOG_RESPONSE_UNKNOWN;
     while (error_code == STANDARD_INTEGRITY_NO_ERROR) {
         error_code = StandardIntegrityDialogResponse_getResponseCode(response, &response_code);
         if(response_code != INTEGRITY_DIALOG_RESPONSE_UNKNOWN){
           break;
         }
     }
   
     /// Free memory
     StandardIntegrityDialogRequest_destroy(dialog_request);
     StandardIntegrityDialogResponse_destroy(dialog_response);
   
   }

3. যদি প্রত্যাবর্তিত প্রতিক্রিয়া কোডটি সাফল্য নির্দেশ করে, তাহলে ইন্টিগ্রিটি টোকেনের জন্য পরবর্তী অনুরোধটি কোনো ব্যতিক্রম ছাড়াই সফল হওয়া উচিত। আপনি যদি সাধারণ অনুরোধ করেন, তাহলে একটি নতুন সিদ্ধান্ত পেতে আপনাকে টোকেন প্রদানকারীকে আবার সক্রিয় করতে হবে।

অখণ্ডতা ডায়ালগ কোড

GET_LICENSED (টাইপ কোড ১)

রায়ের বিষয়

এই সংলাপটি দুটি বিষয়ের জন্য উপযুক্ত:

• অননুমোদিত অ্যাক্সেস : appLicensingVerdict: "UNLICENSED" । এর অর্থ হলো, ব্যবহারকারীর অ্যাকাউন্টে আপনার অ্যাপটি ব্যবহারের অনুমতি নেই, যা ঘটতে পারে যদি ব্যবহারকারী অ্যাপটি সাইডলোড করে অথবা গুগল প্লে ছাড়া অন্য কোনো অ্যাপ স্টোর থেকে এটি সংগ্রহ করে।
• বিকৃত অ্যাপ : appRecognitionVerdict: "UNRECOGNIZED_VERSION" । এর মানে হলো, আপনার অ্যাপের বাইনারিটি পরিবর্তন করা হয়েছে অথবা এটি গুগল প্লে দ্বারা স্বীকৃত কোনো সংস্করণ নয়।

প্রতিকার

ব্যবহারকারীকে গুগল প্লে থেকে আসল অ্যাপটি সংগ্রহ করতে উৎসাহিত করার জন্য আপনি GET_LICENSED ডায়ালগটি দেখাতে পারেন। এই একটিমাত্র ডায়ালগই উভয় পরিস্থিতিকে সমাধান করে:

• লাইসেন্সবিহীন ব্যবহারকারীকে এটি একটি প্লে লাইসেন্স প্রদান করে। এর ফলে ব্যবহারকারী গুগল প্লে থেকে অ্যাপ আপডেট পেতে পারেন।
• যে ব্যবহারকারীর অ্যাপের সংস্করণটি বিকৃত বা ত্রুটিপূর্ণ , তাকে গুগল প্লে থেকে অপরিবর্তিত অ্যাপটি ইনস্টল করার জন্য নির্দেশনা দেওয়া হয়।

যখন ব্যবহারকারী ডায়ালগটি সম্পন্ন করেন, তখন পরবর্তী ইন্টিগ্রিটি চেকগুলোতে appLicensingVerdict: "LICENSED" এবং appRecognitionVerdict: "PLAY_RECOGNIZED" রিটার্ন করা হয়।

উদাহরণ ইউএক্স

CLOSE_UNKNOWN_ACCESS_RISK (টাইপ কোড ২)

রায়ের বিষয়

যখন environmentDetails.appAccessRiskVerdict.appsDetected "UNKNOWN_CAPTURING" বা "UNKNOWN_CONTROLLING" থাকে, তার মানে হলো ডিভাইসটিতে এমন অন্যান্য অ্যাপ (যা Google Play দ্বারা ইনস্টল করা হয়নি বা ডিভাইস প্রস্তুতকারক দ্বারা সিস্টেম পার্টিশনে আগে থেকে লোড করা হয়নি) চলছে, যা স্ক্রিন ক্যাপচার করতে বা ডিভাইসটিকে নিয়ন্ত্রণ করতে পারে।

প্রতিকার

আপনি CLOSE_UNKNOWN_ACCESS_RISK ডায়ালগটি দেখিয়ে ব্যবহারকারীকে সেই সমস্ত অজানা অ্যাপ বন্ধ করতে বলতে পারেন, যেগুলো স্ক্রিন ক্যাপচার করছে বা ডিভাইসটি নিয়ন্ত্রণ করছে। ব্যবহারকারী যদি Close all বোতামটি ট্যাপ করেন, তাহলে এই ধরনের সমস্ত অ্যাপ বন্ধ হয়ে যায়।

উদাহরণ ইউএক্স

সমস্ত অ্যাক্সেস ঝুঁকি বন্ধ করুন (টাইপ কোড ৩)

রায়ের বিষয়

যখন environmentDetails.appAccessRiskVerdict.appsDetected "KNOWN_CAPTURING" , "KNOWN_CONTROLLING" , "UNKNOWN_CAPTURING" বা "UNKNOWN_CONTROLLING" এর যেকোনো একটি থাকে, তার মানে হলো ডিভাইসটিতে এমন অ্যাপ চলছে যা স্ক্রিন ক্যাপচার করতে বা ডিভাইসটিকে নিয়ন্ত্রণ করতে পারে।

প্রতিকার

আপনি CLOSE_ALL_ACCESS_RISK ডায়ালগটি দেখিয়ে ব্যবহারকারীকে সেই সমস্ত অ্যাপ বন্ধ করতে বলতে পারেন, যেগুলো স্ক্রিন ক্যাপচার করছে বা ডিভাইসটি নিয়ন্ত্রণ করছে। যদি ব্যবহারকারী ' Close all বোতামটি ট্যাপ করেন, তাহলে ডিভাইসে থাকা এই ধরনের সমস্ত অ্যাপ বন্ধ হয়ে যায়।

উদাহরণ ইউএক্স

GET_INTEGRITY (টাইপ কোড ৪)

রায়ের বিষয়

এই সংলাপটি নিম্নলিখিত যেকোনো সমস্যার ক্ষেত্রে প্রযোজ্য:

• দুর্বল ডিভাইস ইন্টিগ্রিটি : যখন deviceRecognitionVerdict MEETS_DEVICE_INTEGRITY থাকে না, তখন ডিভাইসটি একটি জেনুইন এবং সার্টিফাইড অ্যান্ড্রয়েড ডিভাইস নাও হতে পারে। উদাহরণস্বরূপ, যদি ডিভাইসটির বুটলোডার আনলক করা থাকে অথবা এতে লোড করা অ্যান্ড্রয়েড ওএস কোনো সার্টিফাইড ম্যানুফ্যাকচারার ইমেজ না হয়, তাহলে এমনটা হতে পারে।

• অননুমোদিত অ্যাক্সেস : appLicensingVerdict: "UNLICENSED" । এর অর্থ হলো, ব্যবহারকারীর অ্যাকাউন্টে আপনার অ্যাপটি ব্যবহারের অনুমতি নেই, যা ঘটতে পারে যদি ব্যবহারকারী অ্যাপটি সাইডলোড করে অথবা গুগল প্লে ছাড়া অন্য কোনো অ্যাপ স্টোর থেকে এটি সংগ্রহ করে।

• বিকৃত অ্যাপ : appRecognitionVerdict: "UNRECOGNIZED_VERSION" । এর মানে হলো, আপনার অ্যাপের বাইনারিটি পরিবর্তন করা হয়েছে অথবা এটি গুগল প্লে দ্বারা স্বীকৃত কোনো সংস্করণ নয়।

• ক্লায়েন্ট সাইড এক্সেপশন : যখন একটি ইন্টিগ্রিটি এপিআই (Integrity API) অনুরোধের সময় একটি প্রতিকারযোগ্য এক্সেপশন ঘটে। প্রতিকারযোগ্য এক্সেপশন হলো ইন্টিগ্রিটি এপিআই-এর সেইসব এক্সেপশন, যেগুলোর এরর কোড হলো PLAY_SERVICES_VERSION_OUTDATED , NETWORK_ERROR , PLAY_SERVICES_NOT_FOUND ইত্যাদি। কোনো এক্সেপশন ডায়ালগের মাধ্যমে সমাধানযোগ্য কিনা তা পরীক্ষা করতে আপনি exception.isRemediable() মেথডটি ব্যবহার করতে পারেন।

প্রতিকার

GET_INTEGRITY ডায়ালগটি ব্যবহারকারীর অভিজ্ঞতাকে সহজ করার জন্য ডিজাইন করা হয়েছে, যা একটি একক ও নিরবচ্ছিন্ন প্রবাহের মধ্যে একাধিক প্রতিকারমূলক পদক্ষেপ পরিচালনা করে। এর ফলে ব্যবহারকারীকে বিভিন্ন সমস্যা সমাধানের জন্য একাধিক পৃথক ডায়ালগের সাথে ইন্টারঅ্যাক্ট করতে হয় না।

আপনি যখন ডায়ালগের অনুরোধ করেন, তখন এটি স্বয়ংক্রিয়ভাবে শনাক্ত করে যে নির্দিষ্ট রায়ের সমস্যাগুলোর মধ্যে কোনটি উপস্থিত আছে এবং উপযুক্ত প্রতিকারের পদক্ষেপ প্রদান করে। এর মানে হলো, একটিমাত্র ডায়ালগ অনুরোধের মাধ্যমে একবারে একাধিক সমস্যার সমাধান করা যায়, যার মধ্যে রয়েছে:

• ডিভাইসের অখণ্ডতা : যদি ডিভাইসের অখণ্ডতায় কোনো সমস্যা শনাক্ত করা হয়, তাহলে ডায়ালগটি ব্যবহারকারীকে ডিভাইসের নিরাপত্তা অবস্থা উন্নত করার জন্য নির্দেশনা দেবে, যাতে এটি MEETS_DEVICE_INTEGRITY রায়ের জন্য প্রয়োজনীয় শর্ত পূরণ করে।
• অ্যাপের অখণ্ডতা : অননুমোদিত অ্যাক্সেস বা অ্যাপে হস্তক্ষেপের মতো সমস্যা শনাক্ত হলে, সেগুলি সমাধানের জন্য একটি ডায়ালগ বক্স ব্যবহারকারীদের প্লে স্টোর থেকে অ্যাপটি সংগ্রহ করার নির্দেশ দেবে।

• ক্লায়েন্ট-সাইড ব্যতিক্রম : এই ডায়ালগটি Integrity API ব্যতিক্রমের পেছনের কোনো অন্তর্নিহিত সমস্যা খুঁজে বের করে এবং তা সমাধান করার চেষ্টা করে। উদাহরণস্বরূপ, এটি ব্যবহারকারীকে Google Play পরিষেবার একটি পুরোনো সংস্করণ আপডেট করার জন্য অনুরোধ করতে পারে।

উদাহরণ ইউএক্স

GET_STRONG_INTEGRITY (টাইপ কোড 5)

রায়ের বিষয়

এই ডায়ালগটি GET_INTEGRITY দ্বারা সমাধানকৃত সমস্ত সমস্যা সমাধানের জন্য ডিজাইন করা হয়েছে। এর সাথে অতিরিক্তভাবে এটি এমন সমস্যাগুলোও সমাধান করতে পারে যা কোনো ডিভাইসকে MEETS_STRONG_INTEGRITY ভার্ডিক্ট পেতে বাধা দেয় এবং Play Protect ভার্ডিক্ট সংক্রান্ত সমস্যাগুলোও সমাধান করে।

প্রতিকার

GET_STRONG_INTEGRITY ব্যবহারকারীর অভিজ্ঞতাকে সহজ করার জন্য ডিজাইন করা হয়েছে, যা একটি একক, নিরবচ্ছিন্ন প্রবাহের মধ্যে একাধিক প্রতিকারমূলক পদক্ষেপ পরিচালনা করে। এই ডায়ালগটি স্বয়ংক্রিয়ভাবে প্রযোজ্য ইন্টিগ্রিটি সমস্যাগুলো পরীক্ষা করে এবং সমাধান করে, যার মধ্যে অন্তর্ভুক্ত রয়েছে:

• ডিভাইসের অখণ্ডতা : যদি ডিভাইসের অখণ্ডতায় কোনো সমস্যা শনাক্ত করা হয়, তাহলে ডায়ালগটি ব্যবহারকারীকে ডিভাইসের নিরাপত্তা অবস্থা উন্নত করার জন্য নির্দেশনা দেবে, যাতে এটি MEETS_STRONG_INTEGRITY রায়ের জন্য প্রয়োজনীয় শর্ত পূরণ করে।

• প্লে প্রোটেক্ট স্ট্যাটাস : যদি playProtectVerdict কোনো সমস্যা নির্দেশ করে, তাহলে ডায়ালগটি ব্যবহারকারীকে তা সমাধান করার জন্য নির্দেশনা দেবে:

  • যদি প্লে প্রোটেক্ট নিষ্ক্রিয় থাকে ( playProtectVerdict == POSSIBLE_RISK ), তাহলে একটি ডায়ালগ বক্স ব্যবহারকারীকে এটি সক্রিয় করতে এবং ডিভাইসের সমস্ত অ্যাপ স্ক্যান করতে অনুরোধ করবে।
  • যদি ক্ষতিকর অ্যাপ শনাক্ত হয় ( playProtectVerdict == MEDIUM_RISK বা HIGH_RISK ), তাহলে একটি ডায়ালগ বক্স ব্যবহারকারীকে Google Play Protect ব্যবহার করে সেগুলো আনইনস্টল করার জন্য নির্দেশ দেবে।

• অ্যাপের অখণ্ডতা : অননুমোদিত অ্যাক্সেস বা অ্যাপে হস্তক্ষেপের মতো সমস্যা শনাক্ত হলে, সমস্যাটি সমাধানের জন্য একটি ডায়ালগ বক্স ব্যবহারকারীকে প্লে স্টোর থেকে অ্যাপটি সংগ্রহ করতে বলবে।

• ক্লায়েন্ট-সাইড এক্সেপশন : ডায়ালগটি Integrity API এক্সেপশনের কারণ হওয়া যেকোনো অন্তর্নিহিত সমস্যা সমাধান করারও চেষ্টা করে। উদাহরণস্বরূপ, যদি Google Play পরিষেবা নিষ্ক্রিয় পাওয়া যায়, তবে এটি ব্যবহারকারীকে তা সক্রিয় করতে অনুরোধ করতে পারে। প্রতিকারযোগ্য এক্সেপশন হলো Integrity API এক্সেপশন, যার এরর কোডগুলো হলো PLAY_SERVICES_VERSION_OUTDATED , NETWORK_ERROR , বা PLAY_SERVICES_NOT_FOUND । কোনো এরর ডায়ালগ দ্বারা সমাধানযোগ্য কিনা তা পরীক্ষা করতে আপনি exception.isRemediable() মেথডটি ব্যবহার করতে পারেন।

উদাহরণ ইউএক্স