API ของ Android 2.3

ระดับ API: 9

สำหรับนักพัฒนาซอฟต์แวร์ แพลตฟอร์ม Android 2.3 (GINGERBREAD) พร้อมให้ใช้งานเป็นคอมโพเนนต์ที่ดาวน์โหลดได้สำหรับ Android SDK แพลตฟอร์มที่ดาวน์โหลดได้ประกอบด้วยไลบรารีและอิมเมจระบบ Android รวมถึงชุดสกินโปรแกรมจำลองและอื่นๆ หากต้องการเริ่มพัฒนาหรือทดสอบกับ Android 2.3 ให้ใช้เครื่องมือจัดการ Android SDK เพื่อดาวน์โหลดแพลตฟอร์มลงใน SDK

ภาพรวมของ API

ส่วนด้านล่างนี้จะแสดงภาพรวมทางเทคนิคของสิ่งใหม่ๆ สำหรับนักพัฒนาซอฟต์แวร์ในเวอร์ชัน 2.3 รวมถึงฟีเจอร์ใหม่และการเปลี่ยนแปลงใน API เฟรมเวิร์กตั้งแต่เวอร์ชันก่อนหน้า

VoIP ที่ใช้ SIP

ตอนนี้แพลตฟอร์มมีสแต็กโปรโตคอล SIP และ API เฟรมเวิร์กที่ช่วยให้นักพัฒนาซอฟต์แวร์สร้างแอปพลิเคชันโทรศัพท์ผ่านอินเทอร์เน็ตได้ เมื่อใช้ API แอปพลิเคชันจะสามารถนำเสนอฟีเจอร์การโทรด้วยเสียงได้โดยไม่ต้องจัดการเซสชัน การสื่อสารระดับการรับส่ง หรือเสียง เนื่องจาก SIP API และบริการของแพลตฟอร์มจะจัดการสิ่งเหล่านี้อย่างโปร่งใส

SIP API พร้อมใช้งานในแพ็กเกจ android.net.sip คลาสหลักคือ SipManager ซึ่งแอปพลิเคชันใช้เพื่อตั้งค่าและจัดการโปรไฟล์ SIP จากนั้นเริ่มการโทรด้วยเสียงและรับสายโทรด้วยเสียง เมื่อสร้างการโทรด้วยเสียงแล้ว แอปพลิเคชันจะปิดเสียงการโทร เปิดโหมดลำโพง ส่งเสียงสัญญาณ DTMF และอื่นๆ ได้ นอกจากนี้ แอปพลิเคชันยังใช้ SipManager เพื่อสร้างการเชื่อมต่อ SIP ทั่วไปได้ด้วย

สแต็กและบริการ SIP พื้นฐานของแพลตฟอร์มจะพร้อมใช้งานในอุปกรณ์ตามดุลยพินิจของผู้ผลิตและผู้ให้บริการที่เกี่ยวข้อง ด้วยเหตุนี้ แอปพลิเคชันจึงควรใช้เมธอด isApiSupported() เพื่อตรวจสอบว่ามีการรองรับ SIP หรือไม่ ก่อนที่จะแสดงฟังก์ชันการโทรให้ผู้ใช้เห็น

หากต้องการใช้ SIP API แอปพลิเคชันต้องขอสิทธิ์จากผู้ใช้โดยประกาศ <uses-permission android:name="android.permission.INTERNET"> และ <uses-permission android:name="android.permission.USE_SIP"> ในไฟล์ Manifest

นอกจากนี้ นักพัฒนาแอปยังขอการกรองใน Google Play ได้ เพื่อให้ผู้ใช้ที่อุปกรณ์ไม่มีสแต็กและบริการ SIP ของแพลตฟอร์มไม่สามารถค้นพบแอปพลิเคชันของตนได้ หากต้องการขอการกรอง ให้เพิ่ม <uses-feature android:name="android.software.sip" android:required="true"> และ <uses-feature android:name="android.software.sip.voip"> ลงในไฟล์ Manifest ของแอปพลิเคชัน

ดูข้อมูลเพิ่มเติมได้ที่คู่มือนักพัฒนาซอฟต์แวร์ SIP

Near Field Communication (NFC)

Android 2.3 มีสแต็ก NFC และ API เฟรมเวิร์กที่ช่วยให้นักพัฒนาซอฟต์แวร์อ่านแท็ก NDEF ที่ค้นพบเมื่อผู้ใช้แตะอุปกรณ์ที่เปิดใช้ NFC เพื่อแท็กองค์ประกอบที่ฝังในสติกเกอร์ โปสเตอร์อัจฉริยะ และแม้แต่อุปกรณ์อื่นๆ

แพลตฟอร์มนี้ให้บริการ NFC พื้นฐานที่ทำงานร่วมกับฮาร์ดแวร์ของอุปกรณ์เพื่อค้นหาแท็กเมื่ออยู่ในระยะ เมื่อค้นพบแท็ก แพลตฟอร์มจะแจ้งเตือนแอปพลิเคชันโดยการประกาศ Intent โดยเพิ่มข้อความ NDEF ของแท็กลงใน Intent เป็นข้อมูลเพิ่มเติม แอปพลิเคชันสามารถสร้างตัวกรอง Intent เพื่อจดจำและจัดการแท็กและข้อความที่กำหนดเป้าหมายได้ ตัวอย่างเช่น หลังจากได้รับแท็กตาม Intent แล้ว แอปพลิเคชันจะดึงข้อความ NDEF, จัดเก็บข้อความ, แจ้งเตือนผู้ใช้ หรือจัดการข้อความด้วยวิธีอื่นๆ

NFC API พร้อมใช้งานในแพ็กเกจ android.nfc คลาสหลักมีดังนี้

  • NfcAdapter ซึ่งแสดงถึงฮาร์ดแวร์ NFC ในอุปกรณ์
  • NdefMessage ซึ่งแสดงข้อความข้อมูล NDEF ซึ่งเป็นรูปแบบมาตรฐานที่ "ระเบียน" ที่มีข้อมูลจะส่งระหว่างอุปกรณ์และแท็ก แอปพลิเคชันสามารถรับข้อความเหล่านี้จาก Intent ACTION_TAG_DISCOVERED รายการ
  • NdefRecord ซึ่งส่งใน NdefMessage ซึ่งอธิบายประเภทของข้อมูลที่แชร์และมีข้อมูลนั้นอยู่ด้วย

การสื่อสาร NFC อาศัยเทคโนโลยีไร้สายในฮาร์ดแวร์ของอุปกรณ์ ดังนั้นการรองรับฟีเจอร์ NFC ของแพลตฟอร์มในอุปกรณ์ที่เฉพาะเจาะจงจึงขึ้นอยู่กับผู้ผลิตอุปกรณ์นั้นๆ หากต้องการตรวจสอบการรองรับ NFC ในอุปกรณ์ปัจจุบัน แอปพลิเคชันสามารถเรียกใช้ isEnabled() เพื่อค้นหา NfcAdapter อย่างไรก็ตาม NFC API จะแสดงอยู่เสมอ ไม่ว่าฮาร์ดแวร์ที่เกี่ยวข้องจะรองรับหรือไม่ก็ตาม

หากต้องการใช้ NFC API แอปพลิเคชันต้องขอสิทธิ์จากผู้ใช้โดยประกาศ <uses-permission android:name="android.permission.NFC"> ในไฟล์ Manifest

นอกจากนี้ นักพัฒนาแอปยังขอให้กรองใน Google Play ได้ เพื่อให้ผู้ใช้ที่อุปกรณ์ไม่รองรับ NFC ไม่สามารถค้นพบแอปพลิเคชันของตนได้ หากต้องการขอการกรอง ให้เพิ่ม <uses-feature android:name="android.hardware.nfc" android:required="true"> ลงในไฟล์ Manifest ของแอปพลิเคชัน

หากต้องการดูตัวอย่างแอปพลิเคชันที่ใช้ NFC API โปรดดู NFCDemo

เครื่องวัดการหมุนและเซ็นเซอร์อื่นๆ

Android 2.3 เพิ่มการรองรับแพลตฟอร์มและ API สำหรับการอ่านเซ็นเซอร์ประเภทใหม่ๆ หลายประเภท ได้แก่ เครื่องวัดการหมุน เวกเตอร์การหมุน ความเร่งเชิงเส้น แรงโน้มถ่วง และบารอมิเตอร์ นักพัฒนาแอปสามารถใช้ค่าที่อ่านได้จากเซ็นเซอร์ใหม่เพื่อสร้างแอปพลิเคชันที่ตอบสนองต่อการเปลี่ยนแปลงตำแหน่งและการเคลื่อนไหวของอุปกรณ์ได้อย่างรวดเร็วและราบรื่น Sensor API จะรายงานการเปลี่ยนแปลงของเครื่องวัดการหมุนและเซ็นเซอร์อื่นๆ ไปยังแอปพลิเคชันที่สนใจ ไม่ว่าจะทำงานในเฟรมเวิร์กแอปพลิเคชันหรือในโค้ดแบบเนทีฟก็ตาม

โปรดทราบว่าชุดเซ็นเซอร์ฮาร์ดแวร์ที่เฉพาะเจาะจงซึ่งมีอยู่ในอุปกรณ์หนึ่งๆ จะแตกต่างกันไปตามดุลยพินิจของผู้ผลิตอุปกรณ์

นักพัฒนาแอปสามารถขอการกรองใน Google Play เพื่อให้ผู้ใช้ที่อุปกรณ์ไม่มีเซ็นเซอร์เครื่องวัดการหมุนไม่สามารถค้นพบแอปพลิเคชันของตนได้ โดยเพิ่ม <uses-feature android:name="android.hardware.sensor.gyroscope" android:required="true"> ลงในไฟล์ Manifest ของแอปพลิเคชัน

ดูรายละเอียด API ได้ที่ Sensor

รองรับกล้องหลายตัว

ตอนนี้แอปพลิเคชันสามารถใช้กล้องที่มีอยู่ในอุปกรณ์เพื่อจับภาพหรือวิดีโอได้แล้ว Camera ช่วยให้แอปพลิเคชันค้นหาจำนวนกล้องที่พร้อมใช้งานและลักษณะเฉพาะของกล้องแต่ละตัวได้

  • คลาส Camera.CameraInfo ใหม่จะจัดเก็บลักษณะตำแหน่งของกล้อง (การวางแนว กล้องหน้าหรือกล้องหลัง)
  • เมธอด getNumberOfCameras() และ getCameraInfo() ใหม่ในคลาส Camera ช่วยให้แอปพลิเคชันค้นหากล้องที่พร้อมใช้งานและเปิดกล้องที่ต้องการได้
  • เมธอด get() ใหม่ช่วยให้แอปพลิเคชันดึงข้อมูล CamcorderProfile สำหรับกล้องที่เฉพาะเจาะจงได้
  • getJpegEncodingQualityParameter() ใหม่ช่วยให้แอปพลิเคชันได้รับระดับคุณภาพการจับภาพนิ่งสำหรับกล้องที่เฉพาะเจาะจง

หากต้องการดูโค้ดตัวอย่างสำหรับการเข้าถึงกล้องหน้า ให้ดู CameraPreview.java ในแอปพลิเคชันตัวอย่าง ApiDemos

นอกจากนี้ Camera API ยังเพิ่มสิ่งต่อไปนี้ด้วย

  • พารามิเตอร์ใหม่สำหรับกล้อง ซึ่งรวมถึงระยะโฟกัส โหมดโฟกัส และ FPS สูงสุด/ต่ำสุดของตัวอย่าง getFocusDistances(), getPreviewFpsRange() และ getSupportedPreviewFpsRange() ใหม่สำหรับการรับพารามิเตอร์กล้อง รวมถึง setPreviewFpsRange() สำหรับการตั้งค่าอัตราเฟรมตัวอย่าง

เอฟเฟกต์เสียงที่มิกซ์ได้

เฟรมเวิร์กสื่อของแพลตฟอร์มเพิ่มการรองรับเอฟเฟกต์เสียงใหม่ต่อแทร็กหรือทั่วโลก ซึ่งรวมถึงการเพิ่มเสียงเบส การจำลองเสียงหูฟัง การปรับอีควอไลเซอร์ และเสียงก้อง

  • แพ็กเกจ android.media.audiofx ใหม่มี API สำหรับเข้าถึงเอฟเฟกต์เสียง
  • AudioEffect ใหม่คือคลาสพื้นฐานสำหรับควบคุมเอฟเฟกต์เสียงที่เฟรมเวิร์กเสียงของ Android มีให้
  • รหัสเซสชันเสียงใหม่ที่ช่วยให้แอปพลิเคชันเชื่อมโยงชุดเอฟเฟกต์เสียงกับอินสแตนซ์ของ AudioTrack หรือ MediaPlayer
  • เครื่องมือสร้างคลาส AudioTrack ใหม่ที่ช่วยให้คุณสร้าง AudioTrack ด้วยรหัสเซสชันที่เฉพาะเจาะจงได้ เมธอด attachAuxEffect(), getAudioSessionId() และ setAuxEffectSendLevel() ใหม่
  • เมธอดและประเภทที่รองรับใหม่ของ attachAuxEffect(), getAudioSessionId(), setAudioSessionId(int) และ setAuxEffectSendLevel()

หากต้องการดูโค้ดตัวอย่างสำหรับเอฟเฟกต์เสียง โปรดดู AudioFxDemo.java ในแอปพลิเคชันตัวอย่าง ApiDemos

นอกจากนี้ เฟรมเวิร์กสื่อยังเพิ่มสิ่งต่อไปนี้ด้วย

  • การรองรับใหม่สำหรับแท็กระดับความสูงในข้อมูลเมตา EXIF สำหรับไฟล์ JPEG เมธอดใหม่ เมธอด getAltitude() เพื่อดึงค่าของแท็กระดับความสูง EXIF
  • เมธอด setOrientationHint() ใหม่ช่วยให้แอปพลิเคชันแจ้ง MediaRecorder เกี่ยวกับการวางแนวระหว่างการจับภาพวิดีโอได้

ตัวจัดการการดาวน์โหลด

แพลตฟอร์มนี้มีบริการระบบ DownloadManager ใหม่ที่จัดการการดาวน์โหลด HTTP ที่ใช้เวลานาน แอปพลิเคชันสามารถขอให้ดาวน์โหลด URI ไปยังไฟล์ปลายทางที่เฉพาะเจาะจงได้ DownloadManager จะดำเนินการดาวน์โหลดในเบื้องหลัง โดยจะจัดการการโต้ตอบ HTTP และลองดาวน์โหลดอีกครั้งหลังจากที่ดำเนินการไม่สำเร็จหรือเมื่อมีการเปลี่ยนแปลงการเชื่อมต่อและการรีบูตระบบ

  • แอปพลิเคชันจะรับอินสแตนซ์ของคลาส DownloadManager ได้โดยการเรียกใช้ getSystemService(String) และส่ง DOWNLOAD_SERVICE แอปพลิเคชันที่ขอการดาวน์โหลดผ่าน API นี้ควรลงทะเบียน Broadcast Receiver สำหรับ ACTION_NOTIFICATION_CLICKED เพื่อจัดการอย่างเหมาะสมเมื่อผู้ใช้คลิกการดาวน์โหลดที่กำลังทำงานอยู่ในการแจ้งเตือนหรือจาก UI การดาวน์โหลด
  • คลาส DownloadManager.Request ช่วยให้แอปพลิเคชันระบุข้อมูลทั้งหมดที่จำเป็นในการขอการดาวน์โหลดใหม่ เช่น URI คำขอและปลายทางการดาวน์โหลด URI คำขอเป็นพารามิเตอร์เดียวที่จำเป็น โปรดทราบว่าปลายทางการดาวน์โหลดเริ่มต้นคือวอลุ่มที่แชร์ซึ่งระบบจะลบไฟล์ของคุณได้หากต้องการเรียกคืนพื้นที่สำหรับการใช้งานระบบ สำหรับการเก็บข้อมูลถาวรของการดาวน์โหลด ให้ระบุปลายทางการดาวน์โหลดในพื้นที่เก็บข้อมูลภายนอก (ดู setDestinationUri(Uri))
  • คลาส DownloadManager.Query มีเมธอดที่ช่วยให้แอปพลิเคชันค้นหาและกรองการดาวน์โหลดที่ทำงานอยู่ได้

StrictMode

แพลตฟอร์มนี้มีเครื่องมือใหม่ของระบบที่เรียกว่า StrictMode เพื่อช่วยนักพัฒนาแอปตรวจสอบและปรับปรุงประสิทธิภาพของแอปพลิเคชัน เมื่อนำไปใช้ในแอปพลิเคชัน StrictMode จะตรวจจับและแจ้งให้นักพัฒนาแอปทราบถึงกิจกรรมในดิสก์หรือกิจกรรมเครือข่ายที่เกิดขึ้นโดยไม่ตั้งใจซึ่งอาจทำให้ประสิทธิภาพของแอปพลิเคชันลดลง เช่น กิจกรรมที่เกิดขึ้นในเทรดหลักของแอปพลิเคชัน (ซึ่งเป็นที่ที่รับการดำเนินการ UI และมีการแสดงภาพเคลื่อนไหวด้วย) นักพัฒนาแอปสามารถประเมินปัญหาการใช้งานเครือข่ายและดิสก์ที่เกิดขึ้นใน StrictMode และแก้ไขได้หากจำเป็น ซึ่งจะช่วยให้เทรดหลักตอบสนองได้ดีขึ้นและป้องกันไม่ให้กล่องโต้ตอบ ANR แสดงต่อผู้ใช้

  • StrictMode เป็นคลาสหลักและเป็นจุดผสานรวมหลักกับระบบและ VM คลาสนี้มีเมธอดที่อำนวยความสะดวกในการจัดการนโยบายเทรดและ VM ที่ใช้กับอินสแตนซ์
  • StrictMode.ThreadPolicy และ StrictMode.VmPolicy จะเก็บนโยบายที่คุณกำหนดและใช้กับชุดข้อความและอินสแตนซ์ VM

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ StrictMode เพื่อเพิ่มประสิทธิภาพแอปพลิเคชันได้ที่เอกสารประกอบเกี่ยวกับคลาสและโค้ดตัวอย่างที่ android.os.StrictMode

เฟรมเวิร์ก UI

  • การรองรับการเลื่อนเกิน
    • การรองรับใหม่สำหรับการเลื่อนเกินขอบเขตในมุมมองและวิดเจ็ต ใน Views แอปพลิเคชันสามารถเปิด/ปิดการเลื่อนเกินขอบเขตสำหรับมุมมองที่กำหนด ตั้งค่าโหมดการเลื่อนเกินขอบเขต ควบคุมระยะการเลื่อนเกินขอบเขต และจัดการผลลัพธ์ของการเลื่อนเกินขอบเขต
    • ในวิดเจ็ต แอปพลิเคชันสามารถควบคุมลักษณะการเลื่อนเกิน เช่น ภาพเคลื่อนไหว การเด้งกลับ และระยะการเลื่อนเกิน ดูข้อมูลเพิ่มเติมได้ที่ android.view.View และ android.widget.OverScroller
    • นอกจากนี้ ViewConfiguration ยังมีเมธอด getScaledOverflingDistance() และ getScaledOverscrollDistance() ด้วย
    • แอตทริบิวต์ overScrollMode, overScrollFooter และ overScrollHeader ใหม่สำหรับองค์ประกอบ <ListView> เพื่อควบคุมลักษณะการทำงานของการเลื่อนเกินขอบเขต
  • การรองรับการกรองการแตะ
    • การรองรับใหม่สำหรับการกรองการสัมผัส ซึ่งช่วยให้แอปพลิเคชันปรับปรุงความปลอดภัยของมุมมองที่ให้สิทธิ์เข้าถึงฟังก์ชันการทำงานที่ละเอียดอ่อนได้ ตัวอย่างเช่น การกรองการแตะเหมาะสำหรับการรักษาความปลอดภัยของการดำเนินการของผู้ใช้ เช่น การให้สิทธิ์ตามคำขอสิทธิ์ การซื้อ หรือการคลิกโฆษณา โปรดดูรายละเอียดที่เอกสารประกอบของคลาส View
    • แอตทริบิวต์ filterTouchesWhenObscured ใหม่สำหรับองค์ประกอบมุมมอง ซึ่งจะประกาศว่าจะกรองการแตะเมื่อหน้าต่างของมุมมองถูกบดบังด้วยหน้าต่างอื่นที่มองเห็นได้หรือไม่ เมื่อตั้งค่าเป็น "true" มุมมองจะไม่ได้รับการแตะเมื่อใดก็ตามที่ข้อความโทสต์ กล่องโต้ตอบ หรือหน้าต่างอื่นๆ ปรากฏเหนือหน้าต่างของมุมมอง โปรดดูรายละเอียดที่หัวข้อดูเอกสารประกอบด้านความปลอดภัย

    หากต้องการดูโค้ดตัวอย่างสำหรับการกรองการแตะ ให้ดูที่ SecureView.java ในแอปพลิเคชันตัวอย่าง ApiDemos

  • การจัดการกิจกรรมที่ปรับปรุงแล้ว
    • คลาสพื้นฐานใหม่สำหรับเหตุการณ์อินพุต InputEvent คลาสนี้มีเมธอดที่ช่วยให้แอปพลิเคชันระบุความหมายของเหตุการณ์ได้ เช่น โดยการค้นหา InputDevice ที่เป็นต้นทางของเหตุการณ์ KeyEvent และ MotionEvent เป็นคลาสย่อยของ InputEvent
    • คลาสพื้นฐานใหม่สำหรับอุปกรณ์อินพุต InputDevice คลาสจะจัดเก็บข้อมูลเกี่ยวกับความสามารถของอุปกรณ์อินพุตหนึ่งๆ และมีเมธอดที่ช่วยให้แอปพลิเคชันกำหนดวิธีตีความเหตุการณ์จากอุปกรณ์อินพุตได้
  • เหตุการณ์การเคลื่อนไหวที่ได้รับการปรับปรุง
    • API MotionEvent ได้รับการขยายให้รวมข้อมูล "รหัสตัวชี้" ซึ่งช่วยให้แอปพลิเคชันติดตามนิ้วแต่ละนิ้วขณะที่เลื่อนขึ้นและลงได้ คลาสนี้จะเพิ่มเมธอดต่างๆ ที่ช่วยให้แอปพลิเคชันทำงานกับเหตุการณ์การเคลื่อนไหวได้อย่างมีประสิทธิภาพ
    • ตอนนี้ระบบอินพุตมีตรรกะในการสร้างเหตุการณ์การเคลื่อนไหวด้วยข้อมูลรหัสตัวชี้ใหม่ โดยสังเคราะห์ตัวระบุเมื่อมีการกดตัวชี้ใหม่ ระบบจะติดตามรหัสตัวชี้หลายรายการแยกกันระหว่างเหตุการณ์การเคลื่อนไหว และตรวจสอบความต่อเนื่องที่เหมาะสมของตัวชี้โดยประเมินระยะห่างระหว่างชุดตัวชี้ชุดสุดท้ายและชุดถัดไป
  • การควบคุมการเลือกข้อความ
    • เมธอด setComposingRegion ใหม่ช่วยให้แอปพลิเคชันทำเครื่องหมายบริเวณข้อความเป็นข้อความที่กำลังเขียนได้ โดยคงการจัดรูปแบบปัจจุบันไว้ เมธอด getSelectedText จะแสดงข้อความที่เลือกกลับไปยังแอปพลิเคชัน วิธีการดังกล่าวมีให้บริการในBaseInputConnection InputConnection และInputConnectionWrapper
    • แอตทริบิวต์ textSelectHandle, textSelectHandleLeft, textSelectHandleRight และ textSelectHandleWindowStyle ใหม่สำหรับ <TextView> เพื่ออ้างอิงออบเจ็กต์ที่ถอดแบบได้ซึ่งจะใช้เพื่อแสดง Anchor การเลือกข้อความและสไตล์สำหรับหน้าต่างที่มีอยู่
  • ส่วนควบคุมกิจกรรม
  • รูปแบบข้อความและไอคอนการแจ้งเตือน

หน้าจอขนาดใหญ่พิเศษ

ตอนนี้แพลตฟอร์มรองรับหน้าจอขนาดใหญ่พิเศษ เช่น หน้าจอที่อาจพบในอุปกรณ์แท็บเล็ต นักพัฒนาแอปสามารถระบุว่าแอปพลิเคชันของตนออกแบบมาเพื่อรองรับหน้าจอขนาดใหญ่พิเศษได้โดยเพิ่มองค์ประกอบ <supports screens ... android:xlargeScreens="true"> ลงในไฟล์ Manifest แอปพลิเคชันสามารถใช้ตัวระบุทรัพยากรใหม่ xlarge เพื่อติดแท็กทรัพยากรที่เจาะจงสำหรับหน้าจอขนาดใหญ่พิเศษ ดูรายละเอียดเกี่ยวกับวิธีรองรับหน้าจอขนาดใหญ่พิเศษและขนาดอื่นๆ ได้ที่การรองรับหน้าจอหลายขนาด

กราฟิก

  • เพิ่มเมธอด OpenGL ES 2.0 ที่เหลือ glDrawElements() และ glVertexAttribPointer() ในคลาส android.opengl.GLES20
  • เพิ่มการรองรับรูปแบบพิกเซล YV12 ซึ่งเป็นรูปแบบ YCrCb 4:2:0 แบบระนาบ

ผู้ให้บริการเนื้อหา

  • คลาสผู้ให้บริการ AlarmClock ใหม่สำหรับการตั้งปลุกหรือจัดการการปลุก ผู้ให้บริการมี Intent ACTION_SET_ALARM การดำเนินการและข้อมูลเพิ่มเติมที่ใช้เพื่อเริ่มกิจกรรมเพื่อตั้งการปลุกใหม่ใน แอปพลิเคชันนาฬิกาปลุก แอปพลิเคชันที่ต้องการรับ Intent SET_ALARM ควรสร้างกิจกรรมที่ต้องใช้สิทธิ์ SET_ALARM แอปพลิเคชันที่ต้องการสร้างการปลุกใหม่ควรใช้ Context.startActivity() เพื่อให้ผู้ใช้มีตัวเลือกในการเลือกแอปพลิเคชันนาฬิกาปลุกที่จะใช้
  • MediaStore รองรับการดำเนินการ Intent ใหม่ PLAY_FROM_SEARCH ซึ่งช่วยให้แอปพลิเคชันค้นหาสื่อเพลงและเล่นเนื้อหาจากผลการค้นหาโดยอัตโนมัติเมื่อเป็นไปได้ ตัวอย่างเช่น แอปพลิเคชันอาจเริ่ม Intent นี้อันเป็นผลมาจากคำสั่งการจดจำเสียงพูดเพื่อฟังเพลง
  • นอกจากนี้ MediaStore ยังเพิ่มแฟล็ก MEDIA_IGNORE_FILENAME ใหม่ที่บอกให้เครื่องสแกนสื่อละเว้นสื่อในไดเรกทอรีที่มีอยู่และไดเรกทอรีย่อยด้วย นักพัฒนาแอปสามารถใช้ไฟล์นี้เพื่อหลีกเลี่ยงไม่ให้กราฟิกปรากฏในแกลเลอรี และป้องกันไม่ให้เสียงและเพลงของแอปพลิเคชันปรากฏในแอปเพลงได้เช่นกัน
  • ผู้ให้บริการ Settings เพิ่มการดำเนินการใหม่ของกิจกรรม APPLICATION_DETAILS_SETTINGS และ MANAGE_ALL_APPLICATIONS_SETTINGS ซึ่งช่วยให้แอปพลิเคชันแสดงหน้าจอรายละเอียดสำหรับแอปพลิเคชันที่เฉพาะเจาะจงหรือแสดงหน้าจอจัดการแอปพลิเคชันได้
  • ผู้ให้บริการ ContactsContract จะเพิ่มประเภทข้อมูล ContactsContract.CommonDataKinds.SipAddress เพื่อจัดเก็บที่อยู่ SIP (โทรศัพท์ผ่านอินเทอร์เน็ต) ของรายชื่อติดต่อ

ตำแหน่ง

  • ตอนนี้ LocationManager จะติดตามคำขอของแอปพลิเคชันที่ส่งผลให้เกิด Wake Lock หรือ Wi-Fi Lock ตาม WorkSource ซึ่งเป็นคลาสที่จัดการโดยระบบที่ระบุแอปพลิเคชัน

    LocationManager จะติดตามไคลเอ็นต์ทั้งหมดที่ขอการอัปเดตเป็นระยะ และแจ้งให้ผู้ให้บริการทราบเกี่ยวกับไคลเอ็นต์เหล่านั้นเป็นพารามิเตอร์ WorkSource เมื่อตั้งค่าเวลาอัปเดตขั้นต่ำ ผู้ให้บริการตำแหน่งเครือข่ายใช้ WorkSource เพื่อติดตามการล็อกการทำงานและการล็อก Wi-Fi ที่แอปพลิเคชันเริ่มต้น และเพิ่มลงในรายงานการใช้งานแบตเตอรี่ของแอปพลิเคชันในส่วนจัดการแอปพลิเคชัน

  • LocationManager เพิ่มเมธอดใหม่หลายรายการที่ช่วยให้กิจกรรมลงทะเบียนเพื่อรับการอัปเดตตำแหน่งเป็นระยะหรือครั้งเดียวตามเกณฑ์ที่ระบุ (ดูด้านล่าง)
  • คลาส Criteria ใหม่ช่วยให้แอปพลิเคชันระบุชุดเกณฑ์สำหรับการเลือกผู้ให้บริการตำแหน่งได้ เช่น อาจมีการจัดเรียงผู้ให้บริการตามความแม่นยำ การใช้พลังงาน ความสามารถในการรายงานระดับความสูง ความเร็ว ทิศทาง และค่าใช้จ่าย

พื้นที่เก็บข้อมูล

  • Android 2.3 เพิ่ม StorageManager ใหม่ที่รองรับไฟล์ OBB (Opaque Binary Blob) แม้ว่าการรองรับแพลตฟอร์มสำหรับ OBB จะพร้อมใช้งานใน Android 2.3 แต่เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ในการสร้างและจัดการไฟล์ OBB จะไม่พร้อมใช้งานจนกว่าจะถึงต้นปี 2011
  • แพลตฟอร์ม Android 2.3 เพิ่มการรองรับอย่างเป็นทางการสำหรับอุปกรณ์ที่ไม่มีการ์ด SD (แม้ว่าจะมีพาร์ติชันการ์ด SD เสมือนเมื่อไม่มีการ์ด SD จริงก็ตาม) เมธอดอำนวยความสะดวก isExternalStorageRemovable() ช่วยให้แอปพลิเคชันระบุได้ว่ามีการ์ด SD จริงอยู่หรือไม่

ผู้จัดการแพ็กเกจ

  • ค่าคงที่ใหม่สำหรับการประกาศฟีเจอร์ฮาร์ดแวร์และซอฟต์แวร์ ดูรายการในส่วนค่าคงที่ของฟีเจอร์ใหม่ด้านล่าง
  • PackageInfo เพิ่มช่อง firstInstallTime และ lastUpdateTime ใหม่ที่จัดเก็บเวลาของการติดตั้งแพ็กเกจและการอัปเดตครั้งล่าสุด
  • เมธอด getProviderInfo() ใหม่สำหรับการดึงข้อมูลทั้งหมดที่ทราบเกี่ยวกับคลาส Content Provider ที่เฉพาะเจาะจง

โทรศัพท์

  • TelephonyManager เพิ่มค่าคงที่ NETWORK_TYPE_EVDO_B สำหรับการระบุประเภทเครือข่าย CDMA EVDO Rev B
  • เมธอด getPsc() ใหม่จะแสดงรหัสการสแครมเบิลหลักของเซลล์ที่ให้บริการในเครือข่าย UMTS

การเข้าถึงวงจรกิจกรรมและหน้าต่างแบบเนทีฟ

Android 2.3 แสดงชุด API ที่หลากหลายแก่แอปพลิเคชันที่ใช้โค้ดแบบเนทีฟ คลาสเฟรมเวิร์กที่แอปพลิเคชันดังกล่าวสนใจ ได้แก่

  • NativeActivity เป็นคลาสกิจกรรมประเภทใหม่ที่มีการใช้ Lifecycle Callback ในโค้ดแบบเนทีฟโดยตรง NativeActivity และโค้ดแบบเนทีฟที่เกี่ยวข้องจะทำงานในระบบเช่นเดียวกับกิจกรรมอื่นๆ โดยเฉพาะอย่างยิ่งจะทำงานในกระบวนการของระบบของแอปพลิเคชัน Android และดำเนินการในเธรด UI หลักของแอปพลิเคชัน และจะได้รับ Lifecycle Callback เดียวกันกับกิจกรรมอื่นๆ
  • คลาส InputQueue และอินเทอร์เฟซ Callback ใหม่ช่วยให้โค้ดแบบเนทีฟจัดการการจัดคิวเหตุการณ์ได้
  • อินเทอร์เฟซ SurfaceHolder.Callback2 ใหม่ช่วยให้โค้ดแบบเนทีฟจัดการ SurfaceHolder ได้
  • เมธอด takeInputQueue และ takeSurface() ใหม่ใน Window ช่วยให้โค้ดแบบเนทีฟจัดการเหตุการณ์และแพลตฟอร์มได้

ดูข้อมูลทั้งหมดเกี่ยวกับการทำงานกับโค้ดแบบเนทีฟหรือดาวน์โหลด NDK ได้ที่หน้า Android NDK

รันไทม์ Dalvik

องค์ประกอบและแอตทริบิวต์ใหม่ของไฟล์ Manifest

  • แอตทริบิวต์ xlargeScreens ใหม่สำหรับองค์ประกอบ <supports-screens> เพื่อระบุว่าแอปพลิเคชันรองรับรูปแบบของอุปกรณ์ที่มีหน้าจอขนาดใหญ่พิเศษหรือไม่ ดูรายละเอียดได้ที่หัวข้อการรองรับหลายหน้าจอ
  • ค่าใหม่สำหรับแอตทริบิวต์ android:screenOrientation ขององค์ประกอบ <activity>:
    • "reverseLandscape" — กิจกรรมต้องการให้หน้าจออยู่ในแนวนอน โดยหมุนไปในทิศทางตรงกันข้ามกับแนวนอนปกติ
    • "reversePortrait" — กิจกรรมต้องการให้หน้าจออยู่ในแนวตั้ง โดยหมุนไปในทิศทางตรงกันข้ามกับแนวตั้งปกติ
    • "sensorLandscape" — กิจกรรมต้องการให้หน้าจออยู่ในแนวนอน แต่สามารถใช้เซ็นเซอร์เพื่อเปลี่ยนทิศทางที่หน้าจอหันไปได้
    • "sensorPortrait" — กิจกรรมต้องการให้หน้าจออยู่ในแนวตั้ง แต่สามารถใช้เซ็นเซอร์เพื่อเปลี่ยนทิศทางที่หน้าจอหันไปได้
    • "fullSensor" — การวางแนวจะกำหนดโดยเซ็นเซอร์การวางแนวทางกายภาพ: จอแสดงผลจะหมุนตามวิธีที่ผู้ใช้เคลื่อนย้ายอุปกรณ์ ซึ่งจะอนุญาตให้หมุนได้ทั้ง 4 แบบ ไม่ว่าอุปกรณ์จะทำอะไรตามปกติก็ตาม (เช่น อุปกรณ์บางอย่างจะไม่ใช้การหมุน 180 องศาตามปกติ)

สิทธิ์ใหม่

  • com.android.permission.SET_ALARM — อนุญาตให้แอปพลิเคชันประกาศ Intent เพื่อตั้งปลุกให้ผู้ใช้ กิจกรรมที่จัดการการดำเนินการ Intent SET_ALARM ควรต้องใช้สิทธิ์นี้
  • android.permission.USE_SIP — อนุญาตให้แอปพลิเคชันใช้ SIP API เพื่อโทรออกหรือรับสายผ่านอินเทอร์เน็ต
  • android.permission.NFC — อนุญาตให้แอปพลิเคชันใช้ NFC API เพื่ออ่านแท็ก NFC

ค่าคงที่ของฟีเจอร์ใหม่

แพลตฟอร์มนี้เพิ่มฟีเจอร์ฮาร์ดแวร์ใหม่หลายรายการที่นักพัฒนาแอปสามารถประกาศในไฟล์ Manifest ของแอปพลิเคชันว่าแอปพลิเคชันของตนต้องใช้ ซึ่งช่วยให้นักพัฒนาแอปควบคุมวิธีกรองแอปพลิเคชันของตนเมื่อเผยแพร่ใน Google Play ได้

  • android.hardware.audio.low_latency — แอปพลิเคชันใช้ไปป์ไลน์เสียงที่มีเวลาในการตอบสนองต่ำในอุปกรณ์ และไวต่อความล่าช้าหรือความหน่วงในการป้อนข้อมูลหรือเอาต์พุตเสียง
  • android.hardware.camera.front — แอปพลิเคชันใช้กล้องหน้าของอุปกรณ์
  • android.hardware.nfc — แอปพลิเคชันใช้ฟีเจอร์วิทยุ NFC ในอุปกรณ์
  • android.hardware.sensor.barometer — แอปพลิเคชันใช้เครื่องวัดความกดอากาศของอุปกรณ์
  • android.hardware.sensor.gyroscope — แอปพลิเคชันใช้เซ็นเซอร์เครื่องวัดการหมุนของอุปกรณ์
  • android.software.sip - แอปพลิเคชันใช้ SIP API ในอุปกรณ์
  • android.software.sip.voip — แอปพลิเคชันใช้บริการ VoIP ที่ใช้ SIP ในอุปกรณ์
  • android.hardware.touchscreen.multitouch.jazzhand — แอปพลิเคชันใช้ความสามารถมัลติทัชแบบหลายจุดขั้นสูงบนหน้าจออุปกรณ์เพื่อติดตามจุดต่างๆ 5 จุดขึ้นไปอย่างเป็นอิสระจากกันโดยสมบูรณ์

ดูข้อมูลทั้งหมดเกี่ยวกับวิธีประกาศฟีเจอร์และใช้ฟีเจอร์เพื่อกรองได้ในเอกสารประกอบสำหรับ <uses-feature>

รายงานความแตกต่างของ API

ดูมุมมองโดยละเอียดของการเปลี่ยนแปลง API ทั้งหมดใน Android 2.3 (ระดับ API 9) ได้ที่รายงานความแตกต่างของ API

ระดับ API

แพลตฟอร์ม Android 2.3 มี API เฟรมเวิร์กเวอร์ชันอัปเดต Android 2.3 API จะได้รับการกำหนดตัวระบุจำนวนเต็ม 9 ซึ่งจัดเก็บไว้ในระบบเอง ตัวระบุนี้เรียกว่า "ระดับ API" ซึ่งช่วยให้ระบบระบุได้อย่างถูกต้องว่าแอปพลิเคชันเข้ากันได้กับระบบหรือไม่ก่อนที่จะติดตั้งแอปพลิเคชัน

หากต้องการใช้ API ที่เปิดตัวใน Android 2.3 ในแอปพลิเคชัน คุณต้องคอมไพล์แอปพลิเคชันกับไลบรารี Android ที่มีอยู่ในแพลตฟอร์ม Android 2.3 SDK คุณอาจต้องเพิ่มแอตทริบิวต์ android:minSdkVersion="9" ลงในองค์ประกอบ <uses-sdk> ในไฟล์ Manifest ของแอปพลิเคชันด้วย ทั้งนี้ขึ้นอยู่กับความต้องการของคุณ หากแอปพลิเคชันของคุณออกแบบมาให้ทำงานบน Android 2.3 ขึ้นไปเท่านั้น การประกาศแอตทริบิวต์จะป้องกันไม่ให้ติดตั้งแอปพลิเคชันในแพลตฟอร์มเวอร์ชันก่อนหน้า

อ่านข้อมูลเพิ่มเติมได้ที่ระดับ API คืออะไร