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

এই পৃষ্ঠাটি বর্ণনা করে যে কীভাবে সততার রায়ের সাথে সমস্যাগুলি পরিচালনা করা যায়৷

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

একটি রায়ের সমস্যা সমাধানের জন্য একটি অখণ্ডতা ডায়ালগের অনুরোধ করুন৷

যখন ক্লায়েন্ট একটি অখণ্ডতা টোকেন অনুরোধ করে, আপনি StandardIntegrityToken (স্ট্যান্ডার্ড API) এবং IntegrityTokenResponse (ক্লাসিক API) এ দেওয়া পদ্ধতিটি ব্যবহার করতে পারেন: 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) {
      // Call showDialog with type code, the dialog will be shown on top of the
      // provided activity and complete when the dialog is closed.
      val integrityDialogResponseCode: Task<Int> =
      tokenResponse.showDialog(activity, showDialogType)
      // Handle response code, call the Integrity API again to confirm that
      // verdicts have been resolved.
    } 

    জাভা

    // Show dialog as indicated by the server
    @Nullable Integer showDialogType = yourServerResponse.integrityDialogTypeCode();
    if (showDialogType != null) {
      // Call showDialog with type code, the dialog will be shown on top of the
      // provided activity and complete when the dialog is closed.
      Task<Integer> integrityDialogResponseCode =
          tokenResponse.showDialog(activity, showDialogType);
      // Handle response code, call the Integrity API again to confirm that
      // verdicts have been resolved.
    }

    ঐক্য

    IEnumerator ShowDialogCoroutine() {
      int showDialogType = yourServerResponse.IntegrityDialogTypeCode();
    
      // Call showDialog with type code, the dialog will be shown on top of the
      // provided activity and complete when the dialog is closed.
      var showDialogTask = tokenResponse.ShowDialog(showDialogType);
    
      // Wait for PlayAsyncOperation to complete.
      yield return showDialogTask;
    
      // Handle response code, call the Integrity API again to confirm that
      // verdicts have been resolved.
    } 

    অবাস্তব ইঞ্জিন

    // .h
    void MyClass::OnShowDialogCompleted(
      EStandardIntegrityErrorCode Error,
      EIntegrityDialogResponseCode Response)
    {
      // Handle response code, call the Integrity API again to confirm that
      // verdicts have 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) {
      /// Call showDialog with type code, the dialog will be shown on top of the
      /// provided activity and complete when the dialog is closed.
      StandardIntegrityErrorCode error_code =
          IntegrityTokenResponse_showDialog(response, activity, show_dialog_type);
    
      /// Proceed to polling iff error_code == STANDARD_INTEGRITY_NO_ERROR
      if (error_code != STANDARD_INTEGRITY_NO_ERROR)
      {
          /// Remember to call the *_destroy() functions.
          return;
      }
    
      /// Use polling to wait for the async operation to complete.
      /// Note, the polling shouldn't block the thread where the IntegrityManager
      /// is running.
    
      IntegrityDialogResponseCode* response_code;
      error_code = StandardIntegrityToken_getDialogResponseCode(response, response_code);
    
      if (error_code != STANDARD_INTEGRITY_NO_ERROR)
      {
          /// Remember to call the *_destroy() functions.
          return;
      }
    
      /// Handle response code, call the Integrity API again to confirm that
      /// verdicts have been resolved.
    }
  5. ডায়ালগটি প্রদত্ত কার্যকলাপের উপরে প্রদর্শিত হয়। যখন ব্যবহারকারী ডায়ালগটি বন্ধ করে দেয়, টাস্কটি একটি প্রতিক্রিয়া কোড দিয়ে সম্পূর্ণ হয়।

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

একটি ক্লায়েন্ট পার্শ্ব ব্যতিক্রম ঠিক করতে একটি অখণ্ডতা ডায়ালগের অনুরোধ করুন৷

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

Integrity API দ্বারা রিপোর্ট করা একটি প্রতিকারযোগ্য ক্লায়েন্ট পার্শ্ব ত্রুটি ঠিক করতে আপনি কীভাবে GET_INTEGRITY ডায়ালগ ব্যবহার করতে পারেন তা নিম্নলিখিত ধাপগুলি রূপরেখা দেয়৷

  1. একটি ইন্টিগ্রিটি 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;
    }
     
  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);
    }  
  3. যদি প্রত্যাবর্তিত প্রতিক্রিয়া কোডটি একটি সাফল্যের ইঙ্গিত দেয়, তাহলে একটি অখণ্ডতা টোকেনের জন্য পরবর্তী অনুরোধটি কোনো ব্যতিক্রম ছাড়াই সফল হওয়া উচিত। আপনি যদি স্ট্যান্ডার্ড অনুরোধ করেন, তাহলে নতুন রায় পাওয়ার জন্য আপনাকে টোকেন প্রদানকারীকে আবার গরম করতে হবে।

ইন্টিগ্রিটি ডায়ালগ কোড

GET_LICENSED (টাইপ কোড 1)

রায় ইস্যু

এই ডায়ালগ দুটি সমস্যার জন্য উপযুক্ত:

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

প্রতিকার

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

  • লাইসেন্সবিহীন ব্যবহারকারীর জন্য, এটি তাদের একটি Play লাইসেন্স দেয়। এটি ব্যবহারকারীকে Google Play থেকে অ্যাপ আপডেট পেতে সক্ষম করে।
  • একটি টেম্পারড অ্যাপ সংস্করণ সহ ব্যবহারকারীর জন্য, এটি তাদের Google Play থেকে অপরিবর্তিত অ্যাপ ইনস্টল করার জন্য গাইড করে।

যখন ব্যবহারকারী ডায়ালগটি সম্পূর্ণ করে, পরবর্তী অখণ্ডতা পরীক্ষা করে রিটার্ন appLicensingVerdict: "LICENSED" এবং appRecognitionVerdict: "PLAY_RECOGNIZED"

উদাহরণ UX

চিত্র 1. GET_LICENSED প্লে ডায়ালগ।

CLOSE_UNKNOWN_ACCESS_RISK (টাইপ কোড 2)

রায় ইস্যু

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

প্রতিকার

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

উদাহরণ UX

চিত্র 2. কাছাকাছি অজানা অ্যাক্সেস ঝুঁকি জন্য ডায়ালগ.

CLOSE_ALL_ACCESS_RISK (টাইপ কোড 3)

রায় ইস্যু

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

প্রতিকার

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

উদাহরণ UX

চিত্র 3. সমস্ত অ্যাক্সেস ঝুঁকি বন্ধ করার জন্য ডায়ালগ।

GET_INTEGRITY (টাইপ কোড 4)

রায় ইস্যু

এই ডায়ালগটি নিম্নলিখিত যেকোন সমস্যার জন্য উপযুক্ত:

  • দুর্বল ডিভাইস অখণ্ডতা : যখন deviceRecognitionVerdict MEETS_DEVICE_INTEGRITY না থাকে, তখন ডিভাইসটি প্রকৃত, Play Protect প্রত্যয়িত Android-চালিত ডিভাইস নাও হতে পারে। এটি ঘটতে পারে, উদাহরণস্বরূপ যদি ডিভাইসের বুটলোডারটি আনলক করা থাকে বা এর লোড হওয়া Android OS একটি প্রত্যয়িত নির্মাতার ছবি না হয়।

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

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

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

প্রতিকার

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

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

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

উদাহরণ UX

চিত্র 4. GET_INTEGRITY ডায়ালগ নেটওয়ার্ক ত্রুটি প্রতিকারের প্রবাহ

GET_STRONG_INTEGRITY (টাইপ কোড 5)

রায় ইস্যু

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

প্রতিকার

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

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

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

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

উদাহরণ UX

চিত্র 5. GET_STRONG_INTEGRITY ডায়ালগ প্লে পরিষেবাগুলি আপডেট করছে৷