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

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

کد خطای یکپارچگی

public annotation IntegrityErrorCode

کدهای خطا برای 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 = -17` یک خطای گذرا در دستگاه کلاینت رخ داده است.
`static final int`	`CLOUD_PROJECT_NUMBER_IS_INVALID = -16` شماره پروژه ابری ارائه شده نامعتبر است.
`static final int`	`GOOGLE_SERVER_UNAVAILABLE = -12` خطای ناشناخته داخلی سرور گوگل.
`static final int`	`INTERNAL_ERROR = -100` خطای داخلی ناشناخته.
`static final int`	`NETWORK_ERROR = -3` هیچ شبکه‌ی در دسترسی یافت نمی‌شود.
`static final int`	`NONCE_IS_NOT_BASE64 = -13` Nonce به عنوان یک رشته بدون پوشش و ایمن برای وب base64 کدگذاری نشده است.
`static final int`	`NONCE_TOO_LONG = -11` طول نانس خیلی زیاد است.
`static final int`	`NONCE_TOO_SHORT = -10` طول نانس خیلی کوتاه است.
`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_ACCOUNT_NOT_FOUND = -4` هیچ حساب فروشگاه Play در دستگاه یافت نمی‌شود.
`static final int`	`PLAY_STORE_NOT_FOUND = -2` هیچ برنامه فروشگاه Play در دستگاه یافت نمی‌شود یا نسخه رسمی آن نصب نشده است.
`static final int`	`PLAY_STORE_VERSION_OUTDATED = -14` فروشگاه Play باید به‌روزرسانی شود.
`static final int`	`TOO_MANY_REQUESTS = -8` برنامه‌ی فراخوانی درخواست‌های زیادی به API ارسال کرده و دچار اختلال شده است، یا برنامه‌ی شما از سهمیه‌ی درخواست روزانه‌ی خود فراتر رفته است.

ثابت‌ها

API_NOT_AVAILABLE

public static final int API_NOT_AVAILABLE = -1

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

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

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

مطمئن شوید که 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 = -17

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

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

در نسخه ۱.۱.۰ نرم‌افزار Integrity Play Core معرفی شد (نسخه‌های قبلی توکنی با مقدار خالی برای Device Integrity Verdict برمی‌گرداندند). اگر خطا پس از چند تلاش مجدد ادامه داشت، باید فرض کنید که بررسی‌های یکپارچگی دستگاه با شکست مواجه شده است و بر اساس آن عمل کنید.

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

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

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

خطای داخلی

public static final int INTERNAL_ERROR = -100

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

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

خطای شبکه

public static final int NETWORK_ERROR = -3

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

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

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

NONCE_IS_NOT_BASE64

public static final int NONCE_IS_NOT_BASE64 = -13

Nonce به عنوان یک رشته بدون پوشش و ایمن برای وب base64 کدگذاری نشده است.

با فرمت صحیح nonce دوباره امتحان کنید.

وقت_خیلی_طولانی

public static final int NONCE_TOO_LONG = -11

طول Nonce خیلی طولانی است. Nonce قبل از کدگذاری base64 باید کمتر از ۵۰۰ بایت باشد.

با یک nonce کوتاه‌تر دوباره امتحان کنید.

وقت خیلی کوتاه

public static final int NONCE_TOO_SHORT = -10

طول نانس خیلی کوتاه است. نانس باید حداقل ۱۶ بایت (قبل از کدگذاری base64) باشد تا امنیت بهتری فراهم شود.

با یک nonce طولانی‌تر دوباره امتحان کنید.

خیر_خطا

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_ACCOUNT_NOT_FOUND = -4

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

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

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

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 TOO_MANY_REQUESTS = -8

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

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