این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

گفتگوهای اصلاح

این صفحه نحوه رسیدگی به مسائل مربوط به احکام صداقت را شرح می دهد.

پس از درخواست رمز یکپارچگی، می‌توانید یک گفتگوی Google Play را برای کاربر نمایش دهید. هنگامی که یک یا چند مشکل در حکم یکپارچگی وجود دارد یا اگر یک استثنا در طول یک درخواست Integrity API رخ داده باشد، می‌توانید گفتگو را نمایش دهید. پس از بسته شدن گفتگو، می توانید تأیید کنید که مشکل با یک درخواست توکن یکپارچگی دیگر برطرف شده است. اگر درخواست‌های استاندارد ارائه می‌کنید، باید دوباره ارائه‌دهنده توکن را گرم کنید تا یک حکم جدید دریافت کنید.

برای رفع مشکل حکم، یک گفتگوی یکپارچگی درخواست کنید

هنگامی که مشتری یک توکن یکپارچگی درخواست می کند، می توانید از روش ارائه شده در StandardIntegrityToken (API استاندارد) و IntegrityTokenResponse (API کلاسیک) استفاده کنید: showDialog(Activity activity, int integrityDialogTypeCode) .

مراحل زیر نحوه استفاده از Play Integrity API را برای نشان دادن گفتگوی اصلاح با استفاده از کد گفتگوی GET_LICENSED نشان می دهد. سایر کدهای محاوره ای که برنامه شما می تواند درخواست کند پس از این بخش فهرست شده اند.

یک توکن یکپارچگی از برنامه خود درخواست کنید و توکن را به سرور خود ارسال کنید. می توانید از درخواست استاندارد یا کلاسیک استفاده کنید.

کاتلین

// 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));

در سرور خود، رمز یکپارچگی را رمزگشایی کنید و قسمت appLicensingVerdict بررسی کنید. می تواند چیزی شبیه به این باشد:
```
// Licensing issue
{
  ...
  "accountDetails": {
      "appLicensingVerdict": "UNLICENSED"
  }
}
```

اگر توکن حاوی 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;
}

در برنامه خود، با 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.
}

گفتگو در بالای فعالیت ارائه شده نمایش داده می شود. هنگامی که کاربر گفتگو را بسته است، Task با یک کد پاسخ کامل می شود.
(اختیاری) برای نمایش هر دیالوگ بیشتر، توکن دیگری درخواست کنید. اگر درخواست‌های استاندارد ارائه می‌کنید، باید دوباره ارائه‌دهنده توکن را گرم کنید تا یک حکم جدید دریافت کنید.

برای رفع یک استثنا در سمت مشتری، یک گفتگوی یکپارچگی درخواست کنید

اگر درخواست Integrity API با یک StandardIntegrityException (API استاندارد) یا IntegrityServiceException (API کلاسیک) ناموفق باشد و استثنا قابل اصلاح باشد، می‌توانید از گفتگوهای GET_INTEGRITY یا GET_STRONG_INTEGRITY برای رفع خطا استفاده کنید.

مراحل زیر نحوه استفاده از گفتگوی GET_INTEGRITY را برای رفع یک خطای سمت کلاینت قابل اصلاح گزارش شده توسط Integrity API نشان می دهد.

بررسی کنید که استثنای بازگشتی از یک درخواست 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;
}

اگر استثنا قابل اصلاح است، با استفاده از استثنای برگشتی، گفتگوی GET_INTEGRITY را درخواست کنید. گفتگو روی فعالیت ارائه شده نمایش داده می شود و پس از بسته شدن گفتگو توسط کاربر، Task برگشتی با یک کد پاسخ تکمیل می شود.

کاتلین

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);
}

اگر کد پاسخ برگشتی نشان دهنده موفقیت آمیز باشد، درخواست بعدی برای یک توکن یکپارچگی باید بدون هیچ استثنایی موفق شود. اگر درخواست‌های استانداردی ارائه می‌کنید، باید دوباره ارائه‌دهنده توکن را گرم کنید تا یک حکم جدید دریافت کنید.

کدهای محاوره ای یکپارچگی

GET_LICENSED (نوع کد 1)

موضوع حکم

این گفتگو برای دو موضوع مناسب است:

دسترسی غیرمجاز : appLicensingVerdict: "UNLICENSED" . این به این معنی است که حساب کاربری برای برنامه شما حقی ندارد، که اگر کاربر آن را از طرفی بارگذاری کند یا آن را از یک فروشگاه برنامه متفاوت از Google Play خریداری کند، ممکن است اتفاق بیفتد.
برنامه دستکاری شده : appRecognitionVerdict: "UNRECOGNIZED_VERSION" . این بدان معنی است که باینری برنامه شما تغییر یافته است یا نسخه ای نیست که توسط Google Play شناسایی شده است.

اصلاح

می‌توانید گفتگوی GET_LICENSED را نشان دهید تا از کاربر بخواهید برنامه اصلی را از Google Play خریداری کند. این گفتگوی واحد به هر دو سناریو می پردازد:

برای یک کاربر بدون مجوز ، به آنها مجوز Play می دهد. این به کاربر امکان می‌دهد به‌روزرسانی‌های برنامه را از Google Play دریافت کند.
برای کاربری با نسخه برنامه دستکاری شده ، آنها را به نصب برنامه تغییر نیافته از Google Play راهنمایی می کند.

وقتی کاربر گفتگو را کامل کرد، بررسی‌های یکپارچگی بعدی appLicensingVerdict: "LICENSED" و appRecognitionVerdict: "PLAY_RECOGNIZED" را برمی‌گرداند.

مثال UX

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 نباشد. این ممکن است اتفاق بیفتد، برای مثال اگر بوت لودر دستگاه آنلاک باشد یا سیستم عامل اندروید بارگذاری شده آن تصویر سازنده تایید شده نباشد.
دسترسی غیرمجاز : appLicensingVerdict: "UNLICENSED" . این به این معنی است که حساب کاربری برای برنامه شما حقی ندارد، که اگر کاربر آن را از طرفی بارگذاری کند یا آن را از یک فروشگاه برنامه متفاوت از Google Play خریداری کند، ممکن است اتفاق بیفتد.
برنامه دستکاری شده : appRecognitionVerdict: "UNRECOGNIZED_VERSION" . این بدان معنی است که باینری برنامه شما تغییر یافته است یا نسخه ای نیست که توسط Google Play شناسایی شده است.
استثناهای سمت سرویس گیرنده : زمانی که یک استثنا قابل اصلاح در طول یک درخواست Integrity API رخ می دهد. استثناهای قابل اصلاح، استثناهای Integrity API با کدهای خطا مانند PLAY_SERVICES_VERSION_OUTDATED ، NETWORK_ERROR ، PLAY_SERVICES_NOT_FOUND ، و غیره هستند. می‌توانید از روش exception.isRemediable() استفاده کنید تا بررسی کنید که آیا یک استثنا توسط کادر گفتگو قابل رفع است یا خیر.

اصلاح

گفتگوی GET_INTEGRITY برای ساده کردن تجربه کاربر با مدیریت چندین مرحله اصلاح در یک جریان واحد و پیوسته طراحی شده است. این کار باعث می‌شود کاربر مجبور نباشد با چندین دیالوگ جداگانه برای رفع مشکلات مختلف تعامل داشته باشد.

هنگامی که شما گفتگو را درخواست می کنید، به طور خودکار تشخیص می دهد که کدام یک از مسائل حکم هدفمند وجود دارد و مراحل اصلاح مناسب را ارائه می دهد. این بدان معنی است که یک درخواست گفتگوی واحد می تواند چندین مشکل را به طور همزمان برطرف کند، از جمله:

یکپارچگی دستگاه : اگر مشکل یکپارچگی دستگاه شناسایی شود، کادر گفتگوی کاربر را راهنمایی می‌کند تا وضعیت امنیتی دستگاه را برای برآورده کردن الزامات یک حکم MEETS_DEVICE_INTEGRITY بهبود بخشد.
یکپارچگی برنامه : اگر مشکلاتی مانند دسترسی غیرمجاز یا دستکاری برنامه شناسایی شود، کادر گفتگوی کاربران را هدایت می‌کند تا برنامه را از فروشگاه Play خریداری کنند تا آنها را برطرف کنند.

استثناهای سمت کلاینت : گفتگوی هر گونه مشکل اساسی که باعث ایجاد یک استثناء Integrity API شده است را بررسی می کند و سعی می کند آنها را حل کند. برای مثال، ممکن است از کاربر بخواهد یک نسخه قدیمی از خدمات 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 آنها را حذف نصب کند.
یکپارچگی برنامه : اگر مشکلاتی مانند دسترسی غیرمجاز یا دستکاری برنامه شناسایی شود، کادر گفتگو از کاربر می‌خواهد برنامه را از فروشگاه Play خریداری کند تا مشکل را برطرف کند.
استثناهای سمت سرویس گیرنده : این گفتگو همچنین سعی می کند مشکلات اساسی را که باعث یک استثناء Integrity API شده است را حل کند. به عنوان مثال، ممکن است از کاربر بخواهد که خدمات Google Play را در صورت غیرفعال بودن فعال کند. استثناهای قابل اصلاح عبارتند از استثناهای Integrity API با کدهای خطا مانند PLAY_SERVICES_VERSION_OUTDATED ، NETWORK_ERROR ، یا PLAY_SERVICES_NOT_FOUND . می‌توانید از متد exception.isRemediable() استفاده کنید تا بررسی کنید که آیا خطا توسط دیالوگ قابل رفع است یا خیر.

مثال UX

**شکل 5.** گفتگوی GET_STRONG_INTEGRITY در حال به روز رسانی سرویس های Play.

قبلی

کدهای خطا را مدیریت کنید

بعدی

ابزارهای اضافی و پشتیبانی

گفتگوهای اصلاح با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

برای رفع مشکل حکم، یک گفتگوی یکپارچگی درخواست کنید

کاتلین

جاوا

وحدت

موتور غیر واقعی

بومی

کاتلین

جاوا

وحدت

موتور غیر واقعی

بومی

کاتلین

جاوا

وحدت

موتور غیر واقعی

بومی

برای رفع یک استثنا در سمت مشتری، یک گفتگوی یکپارچگی درخواست کنید

کاتلین

جاوا

کاتلین

جاوا

کدهای محاوره ای یکپارچگی

GET_LICENSED (نوع کد 1)

موضوع حکم

اصلاح

مثال UX

CLOSE_UNKNOWN_ACCESS_RISK (نوع کد 2)

موضوع حکم

اصلاح

مثال UX

CLOSE_ALL_ACCESS_RISK (نوع کد 3)

موضوع حکم

اصلاح

مثال UX

GET_INTEGRITY (نوع کد 4)

موضوع حکم

اصلاح

مثال UX

GET_STRONG_INTEGRITY (نوع کد 5)

موضوع حکم

اصلاح

مثال UX

گفتگوهای اصلاح