التقاط المحتوى للملاحظات ، والتقاط المحتوى للملاحظات

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

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

راجع ما يلي للحصول على مزيد من المعلومات حول Capture Content for Notes APIs:

• 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

تخصيص OEM لالتقاط المحتوى للملاحظات

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

إذا تم تمكين دور NOTES ، فيجب أن يدعم OEM محتوى الالتقاط لواجهات برمجة تطبيقات Notes من خلال توفير التخصيصات الضرورية وعمليات تكامل تدوين ملاحظات النظام. يمكن لمصنعي المعدات الأصلية اختيار تخصيص تطبيق AOSP الافتراضي ، أو توفير التنفيذ الخاص بهم عن طريق تجاوز config_screenshotAppClipsServiceComponent أو config_screenshotAppClipsActivityComponent . ارجع إلى حزمة notetask للتعرف على التنفيذ الافتراضي لتكامل تدوين ملاحظات النظام.

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

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

التحقق من صحة محتوى الالتقاط للملاحظات

بالنسبة لاختبار CTS-Verifier، راجع اختبار التقاط المحتوى لاختبار Notes .

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