اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بدءًا من Android 14، تتيح واجهات برمجة التطبيقات لميزة "التقاط محتوى للاستخدام في الملاحظات" للمستخدمين التقاط لقطة شاشة مباشرةً من خلال تطبيق تدوين الملاحظات التلقائي. وباستخدام واجهات برمجة التطبيقات هذه، يمكن للمستخدمين إنجاز مهام متعدّدة أثناء تدوين الملاحظات من خلال اقتصاص المحتوى المفضّل على الشاشة ولصقه في ملاحظة.
تم تصميم واجهات برمجة التطبيقات Capture Content for Notes خصيصًا للتطبيقات التي تمتلك دور
NOTES. يستخدم الإصدار
14 من Android إذن
LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE لضمان أنّه لا يمكن إلا لتطبيقات حاملي دور
NOTES استخدام واجهات برمجة التطبيقات Capture
Content for Notes. على التطبيقات التحقّق مما إذا كانت تملك الإذن قبل
استدعاء واجهات برمجة التطبيقات. يمكن لمصنّعي الأجهزة الأصليين السماح للمستخدمين بضبط تطبيق تدوين الملاحظات التلقائي من خلال
تفعيل دور NOTES.
اطّلِع على ما يلي للحصول على مزيد من المعلومات عن واجهتَي برمجة التطبيقات Capture Content for Notes:
تخصيص المصنّع الأصلي للجهاز لميزة "التقاط المحتوى" في "ملاحظات Google"
يتيح دور NOTES للمستخدمين اختيار
تطبيق تدوين ملاحظات مؤهَّل ليكون تطبيق الملاحظات التلقائي. يمكن لمصنّع الأجهزة الأصلي التحكّم في
توفّر دور NOTES على الجهاز من خلال ضبط
config_enableDefaultNotes. يتم ضبط القيمة config_enableDefaultNotes
على false تلقائيًا.
يجب إجراء تغييرات في واجهة مستخدم النظام لتنفيذ واجهات برمجة التطبيقات Capture Content لتطبيق
Notes. يمكن لمصنّعي المعدّات الأصلية تخصيص واجهة المستخدم لعرض لقطة شاشة وتعديلها، و
توفير التنفيذ في واجهة مستخدم نظام Android. على سبيل المثال، في عملية الدمج المخصّصة لجهة التصنيع
، يمكن لواجهة مستخدم النظام تشغيل تطبيق يمتلك دور NOTES على
شاشة القفل باستخدام اختصار شاشة القفل، مثل زر أو رمز على
شاشة القفل أو إيماءة مستندة إلى قلم الشاشة. وبالمثل، على الشاشة الرئيسية، يمكن لواجهة مستخدم النظام
تشغيل تطبيق "حامل الدور" NOTES في وضع
نافذة متعدّدة المهام، مثل نافذة فقاعة أو نافذة عائمة، من خلال إيماءة مستندة إلى قلم الشاشة.
التحقّق من صحة محتوى "التقاط المحتوى" في "الملاحظات"
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Capture Content for Notes\n\nStarting with Android 14, the Capture Content for Notes\nAPIs let users capture a screenshot directly through the default\nnote-taking app. With these APIs, users can have a multitasking note-taking\nexperience by clipping preferred content on their\nscreen and pasting it into a note.\n\nThe Capture Content for Notes APIs are designed specifically for apps holding the\n[`NOTES`](/docs/core/permissions/android-roles) role. Android\n14 uses the\n[`LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/core/res/AndroidManifest.xml#2571) permission to ensure that only\n`NOTES` role holder apps can use the Capture\nContent for Notes APIs. Apps must check if they have the permission before\ncalling the APIs. OEMs can let users set their default note-taking app by\nenabling the [`NOTES`](/docs/core/permissions/android-roles)\nrole.\n\nSee the following for more information about the Capture Content for Notes\nAPIs:\n\n- [`Intent#ACTION_LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE`](https://developer.android.com/reference/android/content/Intent#ACTION_LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE)\n\n- [`Intent#EXTRA_CAPTURE_CONTENT_FOR_NOTE_STATUS_CODE`](https://developer.android.com/reference/android/content/Intent#EXTRA_CAPTURE_CONTENT_FOR_NOTE_STATUS_CODE)\n\n- [`android.permission.LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE`](https://developer.android.com/reference/android/Manifest.permission#LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE)\n\n- [`StatusBarManager#canLaunchCaptureContentActivityForNote`](https://developer.android.com/reference/android/app/StatusBarManager#canLaunchCaptureContentActivityForNote(android.app.Activity))\n\nOEM customization for Capture Content for Notes\n-----------------------------------------------\n\nThe `NOTES` role lets users select an\neligible note taking app to be the default notes app. An OEM can control the\navailability of the `NOTES` role on a device by setting\n[`config_enableDefaultNotes`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/core/res/res/values/config.xml#2243). The value of `config_enableDefaultNotes` is\nset to `false` by default.\n\nIf the `NOTES` role is enabled, the OEM must support the Capture Content for\nNotes APIs by providing the necessary customizations and system note-taking\nintegrations. OEMs can choose to customize the [default AOSP\nimplementation](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/packages/SystemUI/src/com/android/systemui/screenshot/appclips), or provide their\nimplementation by overriding\n[`config_screenshotAppClipsServiceComponent`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/core/res/res/values/config.xml#3356) or [`config_screenshotAppClipsActivityComponent`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/packages/SystemUI/res/values/config.xml#466).\nRefer to the [`notetask`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/packages/SystemUI/src/com/android/systemui/notetask)\npackage for a default system note-taking integration implementation.\n\nChanges are required in System UI for implementing the Capture Content for\nNotes APIs. OEMs can customize the UI to trigger and edit a screenshot and\nprovide the implementation in the Android System UI. As an example of OEM\ncustomized integration, the System UI can launch a `NOTES` role holder app on\nthe lock screen using a lock screen shortcut, such as a button or icon on the\nlock screen or a stylus-based gesture. Similarly, on the home screen the\nSystem UI can launch the `NOTES` role holder app in a multitasking window\nmode, such as a bubble window or floating window, by a stylus-based gesture.\n| **Note:** An OEM can restrict the availability of the Capture Content for Notes APIs based on windowing mode. As an example, the API can return a status code of `CAPTURE_CONTENT_FOR_NOTE_WINDOW_MODE_UNSUPPORTED` if the default note-taking app isn't running in a floating window. Apps must check if the screenshot functionality is available by calling [`StatusBarManager#canLaunchCaptureContentActivityForNote`](https://developer.android.com/reference/android/app/StatusBarManager#canLaunchCaptureContentActivityForNote(android.app.Activity)).\n\nValidation of Capture Content for Notes\n---------------------------------------\n\nFor CTS-Verifier testing, see\n[Capture Content for Notes test](/docs/compatibility/cts/cts-verifier#content-capture-test).\n| **Note:** Based on the implementation, to test the API, OEMs might require hardware such as a stylus to trigger the system note-taking integration."]]
