नोट के लिए कॉन्टेंट कैप्चर करें

Android 14 से, नोट के लिए कॉन्टेंट कैप्चर करने वाले एपीआई की मदद से, उपयोगकर्ता सीधे नोट लेने वाले डिफ़ॉल्ट ऐप्लिकेशन से स्क्रीनशॉट कैप्चर कर सकते हैं. इन एपीआई की मदद से, उपयोगकर्ता अपनी स्क्रीन पर पसंदीदा कॉन्टेंट को क्लिप करके, उसे नोट में चिपकाकर, नोट लेने के दौरान कई काम कर सकते हैं.

नोट के लिए कैप्चर कॉन्टेंट का एपीआई, खास तौर पर NOTES की भूमिका वाले ऐप्लिकेशन के लिए बनाया गया है. Android 14, LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE अनुमति का इस्तेमाल करके यह पक्का करता है कि सिर्फ़ NOTES भूमिका वाले ऐप्लिकेशन, 'नोट के लिए कॉन्टेंट कैप्चर करें' एपीआई का इस्तेमाल कर सकते हैं. एपीआई को कॉल करने से पहले, ऐप्लिकेशन को यह जांच करनी चाहिए कि उनके पास ऐसा करने की अनुमति है या नहीं. OEM, उपयोगकर्ताओं को नोट लेने वाला डिफ़ॉल्ट ऐप्लिकेशन सेट करने की अनुमति दे सकते हैं. इसके लिए, उन्हें 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

नोट के लिए कॉन्टेंट कैप्चर करने के लिए, OEM को पसंद के मुताबिक बनाने की सुविधा

NOTES भूमिका में, उपयोगकर्ता नोट लेने की ज़रूरी शर्तें पूरी करने वाले किसी ऐप्लिकेशन को, नोट लेने के लिए डिफ़ॉल्ट ऐप्लिकेशन के तौर पर चुन सकते हैं. ओईएम, config_enableDefaultNotes को सेट करके, किसी डिवाइस पर NOTES भूमिका की उपलब्धता को कंट्रोल कर सकता है. config_enableDefaultNotes की वैल्यू डिफ़ॉल्ट रूप से false पर सेट होती है.

अगर NOTES भूमिका चालू है, तो OEM को ज़रूरी कस्टमाइज़ेशन और नोट लेने के लिए सिस्टम के साथ इंटिग्रेशन उपलब्ध कराकर, 'नोट के लिए कॉन्टेंट कैप्चर करें' एपीआई के साथ काम करना होगा. ओईएम, डिफ़ॉल्ट एओएसपी लागू करने की सुविधा को पसंद के मुताबिक बना सकते हैं या config_screenshotAppClipsServiceComponent या config_screenshotAppClipsActivityComponent को ओवरराइड करके लागू करने की सुविधा दे सकता है. नोट लेने से जुड़ा इंटिग्रेशन लागू करने का डिफ़ॉल्ट तरीका जानने के लिए, notetask पैकेज देखें.

'नोट के लिए कॉन्टेंट कैप्चर करें' एपीआई को लागू करने के लिए, सिस्टम यूज़र इंटरफ़ेस (यूआई) में बदलाव करना ज़रूरी है. OEM, किसी स्क्रीनशॉट को ट्रिगर करने और उसमें बदलाव करने के लिए, यूज़र इंटरफ़ेस (यूआई) को अपनी पसंद के मुताबिक बना सकते हैं. साथ ही, वे Android सिस्टम के यूज़र इंटरफ़ेस (यूआई) में, इस सुविधा को लागू कर सकते हैं. OEM के हिसाब से बनाए गए इंटिग्रेशन के उदाहरण के तौर पर, सिस्टम यूज़र इंटरफ़ेस (यूआई) लॉक स्क्रीन पर मौजूद शॉर्टकट का इस्तेमाल करके, लॉक स्क्रीन पर NOTES भूमिका वाले ऐप्लिकेशन को लॉन्च कर सकता है. जैसे, लॉक स्क्रीन पर मौजूद बटन या आइकॉन या स्टाइलस पर आधारित जेस्चर. इसी तरह, होम स्क्रीन पर सिस्टम यूज़र इंटरफ़ेस (यूआई), NOTES रोल होल्डर ऐप्लिकेशन को मल्टीटास्किंग विंडो मोड में लॉन्च कर सकता है. जैसे, बबल विंडो या फ़्लोटिंग विंडो. इसके लिए, स्टाइलस का इस्तेमाल करने वाले जेस्चर का इस्तेमाल किया जा सकता है.

ध्यान दें: विंडोिंग मोड के आधार पर, OEM, नोट के लिए कैप्चर किए गए कॉन्टेंट के एपीआई की उपलब्धता पर पाबंदी लगा सकता है. उदाहरण के लिए, अगर नोट लेने वाला डिफ़ॉल्ट ऐप्लिकेशन, फ़्लोटिंग विंडो में नहीं चल रहा है, तो एपीआई CAPTURE_CONTENT_FOR_NOTE_WINDOW_MODE_UNSUPPORTED का स्टेटस कोड दिखा सकता है. ऐप्लिकेशन को यह देखना चाहिए कि स्क्रीनशॉट की सुविधा उपलब्ध है या नहीं. इसके लिए, उन्हें StatusBarManager#canLaunchCaptureContentActivityForNote को कॉल करना होगा.

नोट के लिए कैप्चर किए गए कॉन्टेंट की पुष्टि करना

सीटीएस-पुष्टि करने वाले टूल की जांच के लिए, नोट टेस्ट के लिए कॉन्टेंट कैप्चर करना देखें.

ध्यान दें: एपीआई को टेस्ट करने के लिए, OEM को हार्डवेयर की ज़रूरत पड़ सकती है. जैसे, नोट लेने की सुविधा को ट्रिगर करने के लिए स्टाइलस. यह ज़रूरत, एपीआई को लागू करने के तरीके के हिसाब से तय होती है.