ضبط محتوا برای یادداشت ها

با شروع Android 14، APIهای Capture Content for Notes به کاربران اجازه می‌دهد مستقیماً از طریق برنامه پیش‌فرض یادداشت‌برداری اسکرین شات بگیرند. با استفاده از این APIها، کاربران می توانند با برش دادن محتوای دلخواه بر روی صفحه نمایش خود و چسباندن آن در یادداشت، تجربه یادداشت برداری چندوظیفه ای داشته باشند.

API های Capture Content for Notes به طور خاص برای برنامه هایی طراحی شده اند که نقش NOTES را دارند. Android 14 از مجوز LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE استفاده می‌کند تا مطمئن شود فقط برنامه‌های دارنده نقش NOTES می‌توانند از Capture Content برای Notes API استفاده کنند. برنامه‌ها قبل از تماس با APIها باید بررسی کنند که آیا مجوز دارند یا خیر. OEM ها می توانند به کاربران اجازه دهند برنامه یادداشت برداری پیش فرض خود را با فعال کردن نقش NOTES تنظیم کنند.

برای اطلاعات بیشتر در مورد Capture Content for Notes APIهای زیر را ببینید:

• 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 برای Capture Content for Notes

نقش NOTES به کاربران امکان می دهد یک برنامه یادداشت برداری واجد شرایط را به عنوان برنامه یادداشت پیش فرض انتخاب کنند. یک OEM می تواند با تنظیم config_enableDefaultNotes در دسترس بودن نقش NOTES را در دستگاه کنترل کند. مقدار config_enableDefaultNotes به طور پیش فرض روی false تنظیم شده است.

اگر نقش NOTES فعال باشد، OEM باید با ارائه سفارشی‌سازی‌های لازم و ادغام‌های یادداشت‌برداری سیستم، از Capture Content for Notes API پشتیبانی کند. OEM ها می توانند پیاده سازی پیش فرض AOSP را سفارشی کنند، یا اجرای خود را با نادیده گرفتن config_screenshotAppClipsServiceComponent یا config_screenshotAppClipsActivityComponent ارائه دهند. برای اجرای پیش‌فرض یکپارچه‌سازی یادداشت‌برداری سیستم، به بسته notetask مراجعه کنید.

برای پیاده سازی Capture Content for Notes API ها، تغییراتی در رابط کاربری سیستم لازم است. OEM ها می توانند UI را برای راه اندازی و ویرایش یک اسکرین شات سفارشی کنند و پیاده سازی را در رابط کاربری سیستم اندروید ارائه دهند. به عنوان نمونه ای از ادغام سفارشی OEM، رابط کاربری سیستم می تواند با استفاده از میانبر صفحه قفل، مانند یک دکمه یا نماد روی صفحه قفل یا یک حرکت مبتنی بر قلم، یک برنامه نگهدارنده نقش NOTES را روی صفحه قفل راه اندازی کند. به طور مشابه، در صفحه اصلی، رابط کاربری سیستم می‌تواند برنامه نگهدارنده نقش NOTES را در حالت پنجره چند وظیفه‌ای، مانند پنجره حبابی یا پنجره شناور، با یک حرکت مبتنی بر قلم راه‌اندازی کند.

توجه: یک OEM می‌تواند در دسترس بودن Capture Content برای Notes API را بر اساس حالت پنجره محدود کند. به عنوان مثال، اگر برنامه پیش‌فرض یادداشت‌برداری در یک پنجره شناور اجرا نشود، API می‌تواند کد وضعیت CAPTURE_CONTENT_FOR_NOTE_WINDOW_MODE_UNSUPPORTED را برگرداند. برنامه‌ها باید با تماس با StatusBarManager#canLaunchCaptureContentActivityForNote بررسی کنند که آیا عملکرد اسکرین‌شات در دسترس است یا خیر.

اعتبار سنجی محتوای ضبط برای یادداشت ها

برای آزمایش CTS-Verifier، به Capture Content for Notes Test مراجعه کنید.

توجه: بر اساس پیاده سازی، برای آزمایش API، OEM ها ممکن است به سخت افزاری مانند قلم نیاز داشته باشند تا سیستم یادداشت برداری را یکپارچه کند.