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

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

تم تصميم واجهات برمجة تطبيقات التقاط المحتوى لـ Notes خصيصًا للتطبيقات التي تمتلك دور NOTES. يستخدم Android 14 إذن LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE لضمان أنّ تطبيقات حاملي الأدوار NOTES فقط هي التي يمكنها استخدام واجهات برمجة التطبيقات Capture Content for 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 لتنفيذ عملية دمج تلقائية لميزة تدوين الملاحظات في النظام.

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

ملاحظة: يمكن لمصنّع المعدّات الأصلية تقييد توفّر واجهات برمجة التطبيقات Capture Content for Notes استنادًا إلى وضع النافذة. على سبيل المثال، يمكن أن تعرض واجهة برمجة التطبيقات رمز حالة CAPTURE_CONTENT_FOR_NOTE_WINDOW_MODE_UNSUPPORTED إذا لم يكن تطبيق تدوين الملاحظات التلقائي يعمل في نافذة عائمة. يجب أن تتحقّق التطبيقات مما إذا كانت وظيفة لقطة الشاشة متاحة من خلال استدعاء StatusBarManager#canLaunchCaptureContentActivityForNote.

التحقّق من صحة محتوى التسجيل في "الملاحظات"

لاختبار CTS-Verifier، يُرجى الاطّلاع على التقاط المحتوى لاختبار Notes.

ملاحظة: استنادًا إلى عملية التنفيذ، قد تتطلّب الشركات المصنّعة للأجهزة الأصلية استخدام جهاز مثل قلم الشاشة لبدء عملية دمج ميزة تدوين الملاحظات في النظام.