Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ab Android 14 können Nutzer mit den APIs zum Erfassen von Inhalten für Notizen einen Screenshot direkt über die Standard-App zum Erstellen von Notizen erstellen. Mit diesen APIs können Nutzer Notizen im Multitasking-Modus erstellen, indem sie gewünschte Inhalte auf dem Display ausschneiden und in eine Notiz einfügen.
Die APIs zum Erfassen von Inhalten für Notizen sind speziell für Apps mit der Rolle NOTES konzipiert. Unter Android 14 wird die Berechtigung LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE verwendet, um sicherzustellen, dass nur Apps mit der Rolle NOTES die APIs zum Erfassen von Inhalten für Notizen verwenden können. Apps müssen prüfen, ob sie die Berechtigung haben, bevor sie die APIs aufrufen. OEMs können Nutzern erlauben, ihre Standard-Notizen-App festzulegen, indem sie die Rolle NOTES aktivieren.
Weitere Informationen zu den APIs für die Erfassung von Inhalten für Notizen:
OEM-Anpassung für die Funktion „Inhalte für Notizen erfassen“
Mit der Rolle NOTES können Nutzer eine geeignete Notizen-App als Standard-Notizen-App auswählen. Ein OEM kann die Verfügbarkeit der Rolle NOTES auf einem Gerät durch Festlegen von config_enableDefaultNotes steuern. Der Wert von config_enableDefaultNotes ist standardmäßig auf false festgelegt.
Wenn die Rolle NOTES aktiviert ist, muss der OEM die APIs „Capture Content for Notes“ unterstützen, indem er die erforderlichen Anpassungen und Systemintegrationen für Notizen bereitstellt. OEMs können die Standardimplementierung von AOSP anpassen oder ihre eigene Implementierung bereitstellen, indem sie config_screenshotAppClipsServiceComponent oder config_screenshotAppClipsActivityComponent überschreiben.
Eine Standardimplementierung für die Systemintegration für Notizen finden Sie im Paket notetask.
Für die Implementierung der APIs zum Erfassen von Inhalten für Notizen sind Änderungen an der System-UI erforderlich. OEMs können die Benutzeroberfläche anpassen, um einen Screenshot auszulösen und zu bearbeiten, und die Implementierung in der Android-System-UI bereitstellen. Als Beispiel für eine benutzerdefinierte Integration durch OEMs kann die System-UI eine App für NOTES-Rolleninhaber über einen Sperrbildschirm-Kurzbefehl starten, z. B. eine Schaltfläche oder ein Symbol auf dem Sperrbildschirm oder eine Eingabestift-Geste. Ebenso kann die System-UI auf dem Startbildschirm die App des NOTES-Nutzers über eine Eingabegeste mit dem Eingabestift in einem Multitaskingfenstermodus starten, z. B. in einem Blasenfenster oder einem schwebenden Fenster.
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[],[],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."]]
