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

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

کد خطای استاندارد یکپارچگی

public annotation StandardIntegrityErrorCode

کدهای خطا برای API استاندارد یکپارچگی.

خلاصه

ثابت‌ها
`static final int`	`API_NOT_AVAILABLE = -1` API استاندارد یکپارچگی در دسترس نیست.
`static final int`	`APP_NOT_INSTALLED = -5` برنامه تماس نصب نشده است.
`static final int`	`APP_UID_MISMATCH = -7` شناسه کاربری (UID) برنامه‌ی فراخوانی‌کننده با شناسه‌ی کاربری (User ID) موجود در Package Manager مطابقت ندارد.
`static final int`	`CANNOT_BIND_TO_SERVICE = -9` اتصال به سرویس در فروشگاه Play ناموفق بود.
`static final int`	`CLIENT_TRANSIENT_ERROR = -18` یک خطای گذرا در دستگاه کلاینت رخ داده است.
`static final int`	`CLOUD_PROJECT_NUMBER_IS_INVALID = -16` شماره پروژه ابری ارائه شده نامعتبر است.
`static final int`	`GOOGLE_SERVER_UNAVAILABLE = -12` خطای ناشناخته داخلی سرور گوگل.
`static final int`	`INTEGRITY_TOKEN_PROVIDER_INVALID = -19` `StandardIntegrityTokenProvider` نامعتبر است (مثلاً قدیمی است).
`static final int`	`INTERNAL_ERROR = -100` خطای داخلی ناشناخته.
`static final int`	`NETWORK_ERROR = -3` هیچ شبکه‌ی در دسترسی یافت نمی‌شود.
`static final int`	`NO_ERROR = 0`
`static final int`	`PLAY_SERVICES_NOT_FOUND = -6` خدمات Play در دسترس نیست یا نسخه آن خیلی قدیمی است.
`static final int`	`PLAY_SERVICES_VERSION_OUTDATED = -15` سرویس‌های Play باید به‌روزرسانی شوند.
`static final int`	`PLAY_STORE_NOT_FOUND = -2` هیچ برنامه فروشگاه Play در دستگاه یافت نمی‌شود یا نسخه رسمی آن نصب نشده است.
`static final int`	`PLAY_STORE_VERSION_OUTDATED = -14` فروشگاه Play باید به‌روزرسانی شود.
`static final int`	`REQUEST_HASH_TOO_LONG = -17` هش درخواست ارائه شده خیلی طولانی است.
`static final int`	`TOO_MANY_REQUESTS = -8` برنامه‌ی فراخوانی درخواست‌های زیادی به API ارسال کرده و دچار اختلال شده است، یا برنامه‌ی شما از سهمیه‌ی درخواست روزانه‌ی خود فراتر رفته است.

ثابت‌ها

API_NOT_AVAILABLE

public static final int API_NOT_AVAILABLE = -1

API استاندارد یکپارچگی در دسترس نیست.

API استاندارد Integrity فعال نیست، یا ممکن است نسخه فروشگاه Play قدیمی باشد.

اقدامات توصیه شده:

مطمئن شوید که برای استفاده از API استاندارد یکپارچگی (Standard Integrity API) در لیست مجاز قرار دارید.
مطمئن شوید که Integrity API در کنسول گوگل پلی فعال شده است.
از کاربر بخواهید که فروشگاه Play را به‌روزرسانی کند.

برنامه نصب نشده است

public static final int APP_NOT_INSTALLED = -5

برنامه تماس نصب نشده است.

مشکلی پیش آمده (احتمالاً یک حمله). قابل پیگیری نیست.

عدم تطابق APP_UID

public static final int APP_UID_MISMATCH = -7

شناسه کاربری (UID) برنامه‌ی فراخوانی‌کننده با شناسه‌ی کاربری (User ID) موجود در Package Manager مطابقت ندارد.

مشکلی پیش آمده (احتمالاً یک حمله). قابل پیگیری نیست.

نمی‌توان به سرویس متصل شد

public static final int CANNOT_BIND_TO_SERVICE = -9

اتصال به سرویس در فروشگاه Play ناموفق بود. این می‌تواند به دلیل نصب نسخه قدیمی فروشگاه Play روی دستگاه یا پر بودن بیش از حد حافظه دستگاه باشد.

از کاربر بخواهید که فروشگاه Play را به‌روزرسانی کند.

با یک عقب‌نشینی نمایی دوباره امتحان کنید.

خطای گذرای کلاینت

public static final int CLIENT_TRANSIENT_ERROR = -18

یک خطای گذرا در دستگاه کلاینت رخ داده است.

با یک عقب‌نشینی نمایی دوباره امتحان کنید.

اگر خطا پس از چند تلاش مجدد همچنان ادامه داشت، باید فرض کنید که بررسی‌های یکپارچگی دستگاه با شکست مواجه شده است و بر این اساس اقدام کنید.

CLOUD_PROJECT_NUMBER_IS_INVALID

public static final int CLOUD_PROJECT_NUMBER_IS_INVALID = -16

شماره پروژه ابری ارائه شده نامعتبر است.

برای پروژه ابری که Play Integrity API در آن فعال است، از شماره پروژه ابری که در بخش اطلاعات پروژه در کنسول ابری گوگل شما موجود است، استفاده کنید.

سرور گوگل غیرقابل دسترس

public static final int GOOGLE_SERVER_UNAVAILABLE = -12

خطای ناشناخته داخلی سرور گوگل.

با یک عقب‌نشینی نمایی دوباره امتحان کنید. اگر به‌طور مداوم شکست خورد، ثبت اشکال را در نظر بگیرید.

INTEGRITY_TOKEN_PROVIDER_INVALID

public static final int INTEGRITY_TOKEN_PROVIDER_INVALID = -19

StandardIntegrityTokenProvider نامعتبر است (مثلاً قدیمی است).

این خطا فقط برای StandardIntegrityTokenProvider#request(StandardIntegrityTokenRequest) قابل بازگشت است.

با فراخوانی StandardIntegrityManager#prepareIntegrityToken(PrepareIntegrityTokenRequest) یک ارائه‌دهنده توکن یکپارچگی جدید درخواست کنید.

خطای داخلی

public static final int INTERNAL_ERROR = -100

خطای داخلی ناشناخته.

با یک عقب‌نشینی نمایی دوباره امتحان کنید. اگر به‌طور مداوم شکست خورد، ثبت اشکال را در نظر بگیرید.

خطای شبکه

public static final int NETWORK_ERROR = -3

هیچ شبکه‌ی در دسترسی یافت نمی‌شود.

اقدامات توصیه شده:

از کاربر بخواهید اتصال شبکه خود را بررسی و فعال کند.
برای یک تجربه کاربری هدایت‌شده که به کاربر در برقراری اتصال به شبکه کمک می‌کند، می‌توانید کادر محاوره‌ای GET_INTEGRITY یا GET_STRONG_INTEGRITY را نمایش دهید.

خیر_خطا

public static final int NO_ERROR = 0

خدمات_بازی_یافت_نشد

public static final int PLAY_SERVICES_NOT_FOUND = -6

خدمات Play در دسترس نیست یا نسخه آن خیلی قدیمی است.

اقدامات توصیه شده:

از کاربر بخواهید سرویس‌های Play را نصب یا به‌روزرسانی کند.
برای یک تجربه کاربری هدایت‌شده که به کاربر در فعال‌سازی، نصب یا به‌روزرسانی سرویس‌های Play کمک می‌کند، می‌توانید کادر محاوره‌ای GET_INTEGRITY یا GET_STRONG_INTEGRITY را نمایش دهید.

نسخه_خدمات_بازی_خارج_از_تاریخ

public static final int PLAY_SERVICES_VERSION_OUTDATED = -15

سرویس‌های Play باید به‌روزرسانی شوند.

اقدامات توصیه شده:

از کاربر بخواهید که سرویس‌های گوگل پلی را به‌روزرسانی کند.
برای یک تجربه کاربری هدایت‌شده که به کاربر در به‌روزرسانی سرویس‌های Play کمک می‌کند، می‌توانید کادر محاوره‌ای GET_INTEGRITY یا GET_STRONG_INTEGRITY را نمایش دهید.

فروشگاه_بازیافت_نشد

public static final int PLAY_STORE_NOT_FOUND = -2

هیچ برنامه فروشگاه Play در دستگاه یافت نمی‌شود یا نسخه رسمی آن نصب نشده است.

از کاربر بخواهید که نسخه رسمی و جدید Play Store را نصب کند.

نسخه_فروشگاه_بازی_خارج_از_تاریخ

public static final int PLAY_STORE_VERSION_OUTDATED = -14

فروشگاه Play باید به‌روزرسانی شود.

از کاربر بخواهید که فروشگاه گوگل پلی را به‌روزرسانی کند.

درخواست_هش_خیلی_طولانی

public static final int REQUEST_HASH_TOO_LONG = -17

هش درخواست ارائه شده بسیار طولانی است. طول هش درخواست باید کمتر از ۵۰۰ بایت باشد.

با یک هش درخواست کوتاه‌تر دوباره امتحان کنید.

درخواست‌های خیلی زیاد

public static final int TOO_MANY_REQUESTS = -8

برنامه‌ی فراخوانی درخواست‌های زیادی به API ارسال کرده و دچار اختلال شده است، یا برنامه‌ی شما از سهمیه‌ی درخواست روزانه‌ی خود فراتر رفته است.

با یک عقب‌نشینی نمایی دوباره امتحان کنید. اگر به سقف درخواست روزانه خود رسیده‌اید، درخواست افزایش سهمیه درخواست روزانه خود را بدهید.