تسجيل المحتوى في الملاحظات

بدءًا من Android 14، تتيح واجهات برمجة التطبيقات Capture Content for Notes للمستخدمين أخذ لقطة شاشة مباشرةً من خلال تطبيق تدوين الملاحظات التلقائي. وباستخدام هذه الواجهات، يمكن للمستخدمين الاستفادة من تجربة تدوين ملاحظات متعددة المهام من خلال قص المحتوى المفضّل على الشاشة ولصقه في ملاحظة.

تم تصميم واجهات برمجة التطبيقات Capture Content for Notes خصيصًا للتطبيقات التي لديها الدور NOTES. يستخدم نظام التشغيل Android 14 الإذن LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE لضمان أنّ التطبيقات التي لديها دور NOTES فقط هي التي يمكنها استخدام واجهات برمجة التطبيقات "التقاط المحتوى" في تطبيق "الملاحظات". يجب أن تتحقّق التطبيقات من توفّر الإذن قبل استدعاء واجهات برمجة التطبيقات. يمكن لمصنّعي المعدات الأصلية السماح للمستخدمين بضبط تطبيق تدوين الملاحظات التلقائي من خلال تفعيل دور NOTES.

يمكنك الاطّلاع على ما يلي للحصول على مزيد من المعلومات حول واجهات برمجة التطبيقات Capture Content for Notes:

• Intent#ACTION_LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE

• Intent#EXTRA_CAPTURE_CONTENT_FOR_NOTE_STATUS_CODE

• android.permission.LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE

• StatusBarManager#canLaunchCaptureContentActivityForNote

تخصيص "التقاط المحتوى للملاحظات" من قِبل المصنّع الأصلي للجهاز

يتيح دور NOTES للمستخدمين اختيار تطبيق مؤهّل لتدوين الملاحظات ليكون تطبيق الملاحظات التلقائي. ويمكن لمصنّع المعدات الأصلية التحكّم في مدى توفّر دور NOTES على الجهاز من خلال ضبط config_enableDefaultNotes. يتم ضبط قيمة config_enableDefaultNotes على false تلقائيًا.

في حال تفعيل دور NOTES، على الشركة المصنّعة للجهاز الأصلي توفير دعم لواجهات برمجة التطبيقات Capture Content for Notes من خلال تقديم التخصيصات وعمليات الدمج اللازمة لنظام تدوين الملاحظات. يمكن لمصنّعي المعدات الأصلية اختيار تخصيص عملية التنفيذ التلقائية في مشروع AOSP أو تقديم عملية التنفيذ الخاصة بهم من خلال إلغاء config_screenshotAppClipsServiceComponent أو config_screenshotAppClipsActivityComponent. راجِع حزمة notetask للحصول على تنفيذ تلقائي لعملية دمج نظام تدوين الملاحظات.

يجب إجراء تغييرات في واجهة مستخدم النظام لتنفيذ واجهات برمجة التطبيقات الخاصة بميزة "التقاط المحتوى للملاحظات". يمكن لمصنّعي المعدات الأصلية تخصيص واجهة المستخدم لتفعيل لقطة الشاشة وتعديلها، وتوفير عملية التنفيذ في واجهة مستخدم نظام التشغيل Android. كمثال على عملية الدمج المخصّصة من قِبل الشركة المصنّعة للجهاز الأصلي، يمكن لواجهة مستخدم النظام تشغيل تطبيق يؤدي دور NOTES على شاشة القفل باستخدام اختصار على شاشة القفل، مثل زر أو رمز على شاشة القفل أو إيماءة تستند إلى قلم الشاشة. وبالمثل، يمكن لواجهة مستخدم النظام على الشاشة الرئيسية تشغيل تطبيق حامل الدور NOTES في وضع نافذة لتنفيذ مهام متعددة، مثل نافذة فقاعة أو نافذة عائمة، وذلك باستخدام إيماءة تستند إلى القلم.

.

التحقّق من صحة المحتوى الذي تم التقاطه في "الملاحظات"

للاطّلاع على اختبار CTS-Verifier، راجِع اختبار "التقاط المحتوى للملاحظات".