اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
حدود الإذن بالعرض بملء الشاشة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لمنع الإعلانات غير المرغوب فيها والتصيّد الاحتيالي لبيانات الاعتماد، اعتبارًا من الإصدار Android 14،
لا يمكن منح الإذن التلقائي USE_FULL_SCREEN_INTENT
بإرسال الإشعارات بملء الشاشة إلا للتطبيقات التي
توفّر وظائف الاتصال والتنبيهات.
بالنسبة إلى جميع التطبيقات التي يتم تثبيتها على الإصدار 14 من نظام التشغيل Android، يكون إذن
USE_FULL_SCREEN_INTENT
مفعّلاً تلقائيًا. عند التثبيت، يُلغي "متجر Google Play"
إذن العرض بملء الشاشة للتطبيقات التي لا تتضمّن
وظائف الاتصال أو المنبّه.
بالنسبة إلى التطبيقات المثبّتة على الهواتف التي تعمل بالإصدار
Android 13 أو الإصدارات الأقدم، يظل إذن
USE_FULL_SCREEN_INTENT
مفعّلاً تلقائيًا.
إذن المستخدِم
باستخدام Android 14، يمكن للتطبيقات استخدام NotificationManager#canUseFullScreenIntent()
للتحقّق مما إذا كان بإمكانها إرسال إشعارات بملء الشاشة. للحصول على إذن المستخدم ل
إرسال إشعارات بملء الشاشة، تستخدم التطبيقات الرمز ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT
لبدء الإعداد إدارة الرسائل بملء الشاشة كما هو موضّح في الشكل 1:
الشكل 1: واجهة مستخدِم لتفعيل التطبيقات لإرسال رسائل بملء الشاشة
يمكنك العثور على الإعداد إدارة الرسائل بملء الشاشة في قائمة الإعدادات ضمن إذن الوصول الخاص بالتطبيقات. باستخدام واجهة المستخدم هذه، يمكن للمستخدمين إبطال هذا الإذن إذا لزم الأمر.
متطلبات المصنّع الأصلي للجهاز
في الإصدار 14 من Android، تكون أذونات الوصول إلى الخدمات المالية (FSI) مفعَّلة تلقائيًا للتطبيقات. على المصنّعين الأصليين للأجهزة تحديد التطبيقات المؤهَّلة للحصول على أذونات الوصول إلى معلومات عن المستخدمين والأجهزة. على المصنّعين الأصليّين للأجهزة
التأكّد من أنّ متاجر التطبيقات التابعة لجهات خارجية تضبط حالات المنح الأولية لتصاريح FSI
لتطبيقاتهم باستخدام
PackageInstaller.SessionParams،
وتحديدًا باستخدام المَعلمات PERMISSION_STATE_DEFAULT وPERMISSION_STATE_DENIED وPERMISSION_STATE_GRANTED.
التحقُّق
استخدِم اختبار أداة التحقّق من CTS في NotificationFullScreenIntentVerifierActivity.java،
واختبار CTS في NotificationManagerTest.java
للتحقّق من حدود FSI.
الاختبارات اليدوية
اتّبِع الخطوات التالية لاختبار حدود FSI يدويًا في تطبيقك:
- حدِّد
USE_FULL_SCREEN_INTENT
في ملف AndroidManifest.xml الخاص بتطبيقك.
- استخدِم
ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT
لإدارة الإعدادات لتفعيل ميزة FSI أو إيقافها.
- على الهاتف التجريبي، بدِّل يدويًا إذن المستخدم للاطّلاع على الإشعارات بملء الشاشة كما هو موضّح في الشكل 1.
- أرسِل إشعارًا بشأن FSI.
- تحقَّق من مظهر الإشعار بملء الشاشة في المجموعات التالية
لإذن العرض بملء الشاشة وأوضاع العرض:
|
إذن FSI
|
شاشة غير مقفلة
|
شاشة القفل
|
خارج الشاشة
|
تشغيل الشاشة دائمًا (AOD)
|
| منحها المستخدم
|
إشعار دائم (HUN) مع أزرار دائرية
|
بدء استخدام FSI
|
بدء استخدام FSI
|
بدء استخدام FSI
|
| تم رفضه من قِبل المستخدم
|
HUN مع أزرار حبوب لمدة 60 ثانية
|
تظهر شاشة HUN التي تتضمّن أزرارًا على شكل حبوب أولاً في القائمة لمدة 60 ثانية.
|
يتم تفعيل ميزة "العرض الدائم للشاشة"، وتعرض شاشة معلومات البطارية مع أزرار الحبوب لمدة 60 ثانية
|
HUN مع أزرار حبوب لمدة 60 ثانية
|
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Full-screen intent limits\n\nTo prevent ad spam and credential phishing, starting with Android 14,\nthe default [`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT)\npermission to send full-screen notifications can be granted only to apps that\nprovide calling and alarm functionalities.\n\nFor all apps being installed on Android 14, the\n[`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT)\npermission is enabled by default. Upon installation, the Google Play Store\nrevokes the full-screen intent (FSI) permission for apps that do not have\ncalling or alarm functionalities.\n\nFor apps installed on phones running versions\nAndroid 13 or lower, the\n[`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT)\npermission remains enabled by default.\n\nUser permission\n---------------\n\nWith Android 14, apps can use [`NotificationManager#canUseFullScreenIntent()`](https://developer.android.com/reference/android/app/NotificationManager#canUseFullScreenIntent())\nto check if they can send full-screen notifications. To get user permission to\nsend full-screen notifications, apps use [`ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/provider/Settings#ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT)\nto launch the **Manage full screen intents** setting as shown in Figure 1:\n\n**Figure 1.** UI for enabling apps to send full-screen intents.\n\nThe **Manage full screen intents** setting is in the **Settings** menu under\n**Special App Access**. With this UI, users can revoke this permission if needed.\n\nOEM requirements\n----------------\n\nIn Android 14, FSI permissions for apps are enabled by\ndefault. OEMs must specify which apps qualify for FSI permissions. OEMs must\nensure that third-party app stores set the initial grant states of FSI\npermissions for their apps using\n[`PackageInstaller.SessionParams`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams),\nspecifically with the [`PERMISSION_STATE_DEFAULT`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams#PERMISSION_STATE_DEFAULT), [`PERMISSION_STATE_DENIED`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams#PERMISSION_STATE_DENIED), and [`PERMISSION_STATE_GRANTED`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams#PERMISSION_STATE_GRANTED)\nparameters.\n\nValidation\n----------\n\nUse the CTS Verifier test in [`NotificationFullScreenIntentVerifierActivity.java`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/apps/CtsVerifier/src/com/android/cts/verifier/notifications/NotificationFullScreenIntentVerifierActivity.java),\nand the CTS test in [`NotificationManagerTest.java`](https://cs.android.com/android/platform/superproject/+/android-latest-release:cts/tests/app/src/android/app/cts/NotificationManagerTest.java;drc=ed156b1d4a7d91675dba1adb9191a92cf439dab0;l=148)\nto validate the FSI limits.\n\n### Manual tests\n\nFollow these steps to manually test FSI limits on your app:\n\n1. Declare [`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT) in your app's `AndroidManifest.xml` file.\n2. Use [`ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/provider/Settings#ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT) to manage settings to turn FSI on or off.\n3. On your test phone, manually toggle the user permission for full-screen notifications as shown in Figure 1.\n4. Send an FSI notification.\n5. Validate the appearance of the full-screen notification for the following combinations of FSI permission and display modes:\n\n|--------------------|----------------------------------------------------------|----------------------------------------------------------|---------------------------------------------------|-------------------------------|\n| **FSI permission** | **Unlocked screen** | **Locked screen** | **Off screen** | **Always-on display (AOD)** |\n| Granted by user | Persistent heads-up notification (HUN) with pill buttons | Launch FSI | Launch FSI | Launch FSI |\n| Denied by user | HUN with pill buttons for 60s | HUN with pill buttons shows up first in the list for 60s | AOD turns on, shows HUN with pill buttons for 60s | HUN with pill buttons for 60s |"]]
