Android 4.0.3 के एपीआई

एपीआई लेवल: 15

Android 4.0.3 (ICE_CREAM_SANDWICH_MR1), Android 4.0 (ICE_CREAM_SANDWICH) प्लैटफ़ॉर्म फ़ैमिली की एक इंक्रीमेंटल रिलीज़ है. इस रिलीज़ में, उपयोगकर्ताओं और डेवलपर के लिए नई सुविधाएं, एपीआई में बदलाव, और गड़बड़ियां ठीक करने की सुविधा शामिल है.

डेवलपर के लिए, Android 4.0.3 प्लैटफ़ॉर्म, Android SDK के लिए डाउनलोड किए जा सकने वाले कॉम्पोनेंट के तौर पर उपलब्ध है. डाउनलोड किए जा सकने वाले प्लैटफ़ॉर्म में, Android लाइब्रेरी और सिस्टम इमेज के साथ-साथ, एम्युलेटर स्किन का सेट वगैरह शामिल होता है. Android 4.0.3 के लिए ऐप्लिकेशन डेवलप करने या टेस्ट करने के लिए, Android SDK मैनेजर का इस्तेमाल करके, प्लैटफ़ॉर्म को अपने एसडीके में डाउनलोड करें.

एपीआई के बारे में खास जानकारी

यहां दिए गए सेक्शन में, Android 4.0.3 में उपलब्ध नए एपीआई के बारे में तकनीकी जानकारी दी गई है.

संपर्क सूची में सोशल स्ट्रीम एपीआई

स्टेटस अपडेट और चेक-इन जैसी सोशल स्ट्रीम का डेटा इस्तेमाल करने वाले ऐप्लिकेशन, अब उस डेटा को उपयोगकर्ता के हर संपर्क के साथ सिंक कर सकते हैं. इससे, स्ट्रीम में मौजूद आइटम के साथ-साथ हर आइटम की फ़ोटो भी उपलब्ध कराई जा सकती हैं.

डेटाबेस टेबल में किसी संपर्क की सोशल स्ट्रीम होती है. इसे android.provider.ContactsContract.StreamItems से तय किया जाता है. इसका यूआरआई, उस ContactsContract.RawContacts डायरेक्ट्री में नेस्ट किया जाता है जिससे स्ट्रीम आइटम जुड़े होते हैं. हर सोशल स्ट्रीम टेबल में, हर स्ट्रीम आइटम के मेटाडेटा के लिए कई कॉलम होते हैं. जैसे, सोर्स (अवतार) को दिखाने वाला आइकॉन, आइटम के लिए लेबल, मुख्य टेक्स्ट कॉन्टेंट, आइटम के बारे में टिप्पणियां (जैसे, अन्य लोगों के जवाब) वगैरह. किसी स्ट्रीम से जुड़ी फ़ोटो, दूसरी टेबल में सेव की जाती हैं. इसे android.provider.ContactsContract.StreamItemPhotos से तय किया जाता है. यह android.provider.ContactsContract.StreamItems यूआरआई की सब-डायरेक्ट्री के तौर पर उपलब्ध होता है.

ज़्यादा जानकारी के लिए, android.provider.ContactsContract.StreamItems और android.provider.ContactsContract.StreamItemPhotos देखें.

किसी संपर्क के लिए सोशल स्ट्रीम आइटम को पढ़ने या लिखने के लिए, ऐप्लिकेशन को उपयोगकर्ता से अनुमति मांगनी होगी. इसके लिए, उसे अपनी मेनिफ़ेस्ट फ़ाइलों में <uses-permission android:name="android.permission.READ_SOCIAL_STREAM"> और/या <uses-permission android:name="android.permission.WRITE_SOCIAL_STREAM"> का एलान करना होगा.

कैलेंडर की सेवा देने वाली कंपनी

  • Calendar Provider में कलर टेबल दिखाने के लिए, क्लास CalendarContract.Colors को जोड़ता है. यह क्लास, किसी खाते के लिए उपलब्ध रंगों को ऐक्सेस करने के लिए फ़ील्ड उपलब्ध कराती है. रंगों को COLOR_KEY से रेफ़र किया जाता है. यह किसी खाते के नाम/टाइप के लिए यूनीक होना चाहिए. इन वैल्यू को सिर्फ़ सिंक अडैप्टर से अपडेट किया जा सकता है.
  • इसमें ALLOWED_AVAILABILITY और ALLOWED_ATTENDEE_TYPES को जोड़ा गया है, ताकि एक्सचेंज/सिंक करने की सुविधा का इस्तेमाल किया जा सके.
  • मेहमानों के लिए TYPE_RESOURCE (जैसे, कॉन्फ़्रेंस रूम) और AVAILABILITY_TENTATIVE जोड़ता है. साथ ही, इवेंट के लिए EVENT_COLOR_KEY जोड़ता है.

होम स्क्रीन विजेट

Android 4.0 से, होम स्क्रीन विजेट में अब पैडिंग शामिल नहीं होनी चाहिए. इसके बजाय, सिस्टम अब मौजूदा स्क्रीन की विशेषताओं के आधार पर, हर विजेट के लिए अपने-आप पैडिंग जोड़ता है. इससे ग्रिड में विजेट ज़्यादा एक जैसे और एक समान दिखते हैं. होम स्क्रीन विजेट को होस्ट करने वाले ऐप्लिकेशन की मदद करने के लिए, प्लैटफ़ॉर्म एक नया तरीका getDefaultPaddingForWidget() उपलब्ध कराता है. ऐप्लिकेशन, सिस्टम के तय किए गए पैडिंग को पाने के लिए इस तरीके को कॉल कर सकते हैं. साथ ही, विजेट को असाइन किए जाने वाले सेल की संख्या का हिसाब लगाते समय, इसका इस्तेमाल कर सकते हैं.

स्पेलिंग की जांच करना

  • स्पेल-चेकर सेवाओं को ऐक्सेस करने वाले ऐप्लिकेशन के लिए, एक नया cancel() तरीका, किसी सेशन में स्पेल-चेकर के बाकी बचे और चल रहे टास्क को रद्द कर देता है.
  • स्पेल-चेकर सेवाओं के लिए, सुझावों का एक नया फ़्लैग, RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS, सेवाओं को ज़्यादा भरोसेमंद सुझावों को कम भरोसेमंद सुझावों से अलग करने की सुविधा देता है. उदाहरण के लिए, अगर कोई शब्द उपयोगकर्ता डिक्शनरी में नहीं है, लेकिन उसके लिए सुझाव मौजूद हैं, तो स्पेल-चेकर फ़्लैग सेट कर सकता है. इसके अलावा, अगर कोई शब्द डिक्शनरी में नहीं है और उसके लिए ऐसे सुझाव मौजूद हैं जो शायद काम के न हों, तो स्पेल-चेकर फ़्लैग सेट नहीं कर सकता.

    स्पेल-चेकर से कनेक्ट किए गए ऐप्लिकेशन, RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS फ़्लैग का इस्तेमाल, सुझाव के अन्य एट्रिब्यूट के साथ-साथ getSuggestionsAttributes() और getSuggestionsCount() तरीकों के साथ कर सकते हैं. इससे यह तय किया जा सकता है कि इनपुट किए गए शब्दों को टाइपो के तौर पर मार्क करना है या नहीं और सुझाव देने हैं या नहीं.

  • टेक्स्ट स्पैन के लिए एक नई FLAG_AUTO_CORRECTION स्टाइल से पता चलता है कि उपयोगकर्ता जो शब्द/टेक्स्ट टाइप कर रहा है या लिख रहा है उसमें अपने-आप सुधार होने की सुविधा लागू होने वाली है. इस तरह के सुझाव को अलग तरह से रेंडर किया जाता है, ताकि यह पता चल सके कि शब्दों में सुधार की सुविधा चालू है.

ब्लूटूथ

नए सार्वजनिक तरीके fetchUuidsWithSdp() और getUuids() की मदद से, ऐप्लिकेशन यह तय कर सकते हैं कि रिमोट डिवाइस पर कौनसी सुविधाएं (यूयूआईडी) काम करती हैं. fetchUuidsWithSdp() के मामले में, सिस्टम रिमोट डिवाइस पर डिवाइस और सेवाओं की अपने-आप पहचान करता है, ताकि काम करने वाले यूयूआईडी मिल सकें. इसके बाद, नतीजे को ACTION_UUID इंटेंट में ब्रॉडकास्ट करता है.

यूज़र इंटरफ़ेस (यूआई) टूलकिट

नए तरीके setUserVisibleHint() और getUserVisibleHint() की मदद से, फ़्रैगमेंट को यह हिंट सेट करने की अनुमति मिलती है कि वह फ़िलहाल उपयोगकर्ता को दिख रहा है या नहीं. सिस्टम, उपयोगकर्ता को न दिखने वाले फ़्रैगमेंट को तब तक शुरू नहीं करता, जब तक दिखने वाले फ़्रैगमेंट के लोडर नहीं चल जाते. डिफ़ॉल्ट रूप से, विज़िबिलिटी हिंट "true" पर सेट होता है.

ग्राफ़िक

सुलभता

  • RemoteViews के क्लाइंट अब setContentDescription() तरीके का इस्तेमाल करके, इनफ़्लेटेड लेआउट में किसी भी व्यू के कॉन्टेंट की जानकारी सेट कर सकते हैं और उसे देख सकते हैं.
  • getMaxScrollX(), getMaxScrollY(), setMaxScrollX(), और setMaxScrollY() तरीकों की मदद से, ऐप्लिकेशन किसी AccessibilityRecord ऑब्जेक्ट के लिए, स्क्रोल करने का ज़्यादा से ज़्यादा ऑफ़सेट सेट कर सकते हैं और उसे हासिल कर सकते हैं.
  • टच-एक्सप्लोरेशन मोड चालू होने पर, एक नई सुरक्षित सेटिंग ACCESSIBILITY_SPEAK_PASSWORD यह बताती है कि उपयोगकर्ता ने आईएमई से, पासवर्ड फ़ील्ड में डाले गए टेक्स्ट को बोलने का अनुरोध किया है या नहीं. भले ही, हेडसेट का इस्तेमाल न किया जा रहा हो. डिफ़ॉल्ट रूप से, पासवर्ड का टेक्स्ट तब तक नहीं बोला जाता, जब तक हेडसेट का इस्तेमाल न किया जा रहा हो.

लिखे गए शब्दों को सुनने की सुविधा

  • नेटवर्क टीटीएस की सुविधा के बारे में क्वेरी करने और उसे चालू करने के लिए, नया तरीका getFeatures() जोड़ा गया.
  • एक नई लिसनर क्लास, UtteranceProgressListener जोड़ता है. इंजन, स्पीच-सिंथेसिस की गड़बड़ियों की सूचना पाने के लिए, इस क्लास में रजिस्टर कर सकते हैं.

डेटाबेस

  • CrossProcessCursorWrapper की नई क्लास की मदद से, कॉन्टेंट देने वाले लोग या कंपनियां, क्रॉस-प्रोसेस क्वेरी के नतीजे ज़्यादा बेहतर तरीके से दिखा सकती हैं. नई क्लास, कर्सर को रैप करने के लिए एक उपयोगी बिल्डिंग ब्लॉक है. इसे प्रोसेस के लिए रिमोट तरीके से भेजा जाएगा. यह सामान्य Cursor ऑब्जेक्ट को CrossProcessCursor ऑब्जेक्ट में भी बदल सकता है.

    CrossProcessCursorWrapper क्लास, परफ़ॉर्मेंस से जुड़ी उन सामान्य समस्याओं और गड़बड़ियों को ठीक करती है जो कॉन्टेंट देने वाले ऐप्लिकेशन को लागू करते समय आती हैं.

  • CursorWindow(java.lang.String) कंस्ट्रक्टर अब इनपुट के तौर पर नाम की स्ट्रिंग लेता है. सिस्टम अब लोकल और रिमोट कर्सर विंडो के बीच अंतर नहीं करता है. इसलिए, CursorWindow(boolean) अब काम नहीं करता.

उद्देश्य

डिवाइस पर मौजूद सामान्य तरह के ऐप्लिकेशन को टारगेट करने के लिए, नई कैटगरी जोड़ता है. जैसे, CATEGORY_APP_BROWSER, CATEGORY_APP_CALENDAR, CATEGORY_APP_MAPS वगैरह.

कैमरा

  • MediaMetadataRetriever, नया कॉन्सटैंट METADATA_KEY_LOCATION जोड़ता है, ताकि ऐप्लिकेशन किसी इमेज या वीडियो की जगह की जानकारी को ऐक्सेस कर सकें.
  • CamcorderProfile, QVGA (320x240) रिज़ॉल्यूशन वाली प्रोफ़ाइलें जोड़ता है. क्वालिटी लेवल को QUALITY_QVGA और QUALITY_TIME_LAPSE_QVGA कॉन्सटेंट से दिखाया जाता है.
  • नए तरीके setVideoStabilization(), getVideoStabilization(), और isVideoStabilizationSupported() की मदद से, Camera के लिए वीडियो स्टेबलाइज़ेशन की सुविधा को देखा और मैनेज किया जा सकता है.

अनुमतियां

ये नई अनुमतियां हैं:

  • android.Manifest.permission#READ_SOCIAL_STREAM और android.Manifest.permission#WRITE_SOCIAL_STREAM: ये अनुमतियां, सिंक अडैप्टर को शेयर की गई संपर्क सूची में मौजूद किसी संपर्क के सोशल स्ट्रीम डेटा को पढ़ने और उसमें बदलाव करने की अनुमति देती हैं.

Android 4.0.3 (एपीआई लेवल 15) में एपीआई से जुड़े सभी बदलावों की पूरी जानकारी के लिए, एपीआई में हुए बदलाव की रिपोर्ट देखें.

एपीआई लेवल

Android 4.0.3 एपीआई को एक पूर्णांक आइडेंटिफ़ायर—15—असाइन किया गया है, जो सिस्टम में ही सेव होता है. इस आइडेंटिफ़ायर को "एपीआई लेवल" कहा जाता है. इसकी मदद से, सिस्टम यह सही तरीके से तय कर पाता है कि कोई ऐप्लिकेशन, सिस्टम के साथ काम करता है या नहीं. सिस्टम, ऐप्लिकेशन को इंस्टॉल करने से पहले यह तय करता है.

अपने ऐप्लिकेशन में Android 4.0.3 में उपलब्ध कराए गए एपीआई इस्तेमाल करने के लिए, आपको ऐप्लिकेशन को ऐसे Android प्लैटफ़ॉर्म के लिए कंपाइल करना होगा जो एपीआई लेवल 15 या इसके बाद के वर्शन के साथ काम करता हो. अपनी ज़रूरतों के हिसाब से, आपको <uses-sdk> एलिमेंट में android:minSdkVersion="15" एट्रिब्यूट भी जोड़ना पड़ सकता है.

ज़्यादा जानकारी के लिए, एपीआई लेवल दस्तावेज़ देखें.