ระดับ API: 14
Android 4.0 (ICE_CREAM_SANDWICH) เป็นแพลตฟอร์มรุ่นหลักที่เพิ่มฟีเจอร์ใหม่ๆ ที่หลากหลายสำหรับผู้ใช้และนักพัฒนาแอป นอกจากฟีเจอร์และ API ใหม่ทั้งหมดที่กล่าวถึงด้านล่างแล้ว Android 4.0 ยังเป็นแพลตฟอร์มที่สำคัญอีกด้วย
การเปิดตัวแพลตฟอร์มเนื่องจากมีชุด API และธีมโฮโลแกรมที่ครอบคลุมจาก Android 3.x
ไปยังหน้าจอขนาดเล็ก ในฐานะนักพัฒนาแอป ตอนนี้คุณมีแพลตฟอร์มเดียวและเฟรมเวิร์ก API แบบรวมที่ช่วยให้คุณพัฒนาและเผยแพร่แอปพลิเคชันด้วย APK เดียวซึ่งมอบประสบการณ์ของผู้ใช้ที่เพิ่มประสิทธิภาพสำหรับโทรศัพท์มือถือ แท็บเล็ต และอื่นๆ เมื่อเรียกใช้ Android เวอร์ชันเดียวกัน นั่นคือ Android 4.0 (ระดับ API 14) ขึ้นไป
สำหรับนักพัฒนาซอฟต์แวร์ แพลตฟอร์ม Android 4.0 พร้อมให้ใช้งานเป็นคอมโพเนนต์ที่ดาวน์โหลดได้สำหรับ Android SDK แพลตฟอร์มที่ดาวน์โหลดได้ประกอบด้วยไลบรารีและอิมเมจระบบ Android รวมถึงชุดสกินโปรแกรมจำลองและอื่นๆ หากต้องการเริ่มพัฒนาหรือทดสอบกับ Android 4.0 ให้ใช้เครื่องมือจัดการ Android SDK เพื่อดาวน์โหลดแพลตฟอร์มลงใน SDK
ภาพรวมของ API
ส่วนด้านล่างนี้แสดงภาพรวมทางเทคนิคของ API ใหม่ใน Android 4.0
Social API ใน Contacts Provider
API รายชื่อติดต่อที่กำหนดโดยผู้ให้บริการ ContactsContract ได้รับการขยายเพื่อรองรับฟีเจอร์ใหม่ที่มุ่งเน้นด้านโซเชียล เช่น โปรไฟล์ส่วนตัวสำหรับเจ้าของอุปกรณ์ และความสามารถของผู้ใช้ในการเชิญรายชื่อติดต่อแต่ละรายไปยังโซเชียลเน็ตเวิร์กที่ติดตั้งในอุปกรณ์
โปรไฟล์ผู้ใช้
ตอนนี้ Android มีโปรไฟล์ส่วนตัวที่แสดงถึงเจ้าของอุปกรณ์ตามที่กำหนดไว้ในตาราง ContactsContract.Profile แอปโซเชียลที่รักษาข้อมูลประจำตัวของผู้ใช้สามารถมีส่วนร่วมในข้อมูลโปรไฟล์ของผู้ใช้ได้โดยการสร้างรายการ ContactsContract.RawContacts ใหม่ภายใน ContactsContract.Profile กล่าวคือ ข้อมูลติดต่อดิบที่แสดงถึงผู้ใช้อุปกรณ์ไม่ได้อยู่ในตารางข้อมูลติดต่อดิบแบบเดิมที่กำหนดโดย ContactsContract.RawContacts Uri แต่คุณต้องเพิ่มข้อมูลติดต่อดิบของโปรไฟล์ในตารางที่ CONTENT_RAW_CONTACTS_URI แทน จากนั้นระบบจะรวบรวมข้อมูลติดต่อดิบในตารางนี้ไว้ในโปรไฟล์เดียวที่ผู้ใช้มองเห็นได้ซึ่งมีป้ายกำกับว่า "ฉัน"
การเพิ่มข้อมูลติดต่อดิบใหม่สำหรับโปรไฟล์ต้องใช้สิทธิ์ android.Manifest.permission#WRITE_PROFILE ในทำนองเดียวกัน หากต้องการอ่านจากตารางโปรไฟล์ คุณต้องขอสิทธิ์ android.Manifest.permission#READ_PROFILE อย่างไรก็ตาม แอปส่วนใหญ่ไม่จำเป็นต้องอ่านโปรไฟล์ผู้ใช้ แม้ว่าจะส่งข้อมูลไปยังโปรไฟล์ก็ตาม การอ่านโปรไฟล์ผู้ใช้เป็นสิทธิ์ที่มีความละเอียดอ่อน และคุณควรคาดหวังว่าผู้ใช้จะเคลือบแคลงใจกับแอปที่ขอสิทธิ์ดังกล่าว
ความตั้งใจในการเชิญ
การดำเนินการตาม Intent INVITE_CONTACT ช่วยให้แอปเรียกใช้การดำเนินการที่ระบุว่าผู้ใช้ต้องการเพิ่มรายชื่อติดต่อในเครือข่ายโซเชียลได้ แอปที่รับแอปจะใช้แอปเพื่อเชิญรายชื่อติดต่อที่ระบุไปยังเครือข่ายโซเชียลนั้น แอปส่วนใหญ่จะเป็นฝ่ายรับข้อมูลในการดำเนินการนี้ ตัวอย่างเช่น แอป People ในตัวจะเรียกใช้ Intent การเชิญเมื่อผู้ใช้เลือก "เพิ่มการเชื่อมต่อ" สำหรับแอปโซเชียลที่เฉพาะเจาะจงซึ่งแสดงอยู่ในข้อมูลติดต่อของบุคคลนั้น
หากต้องการให้แอปปรากฏในรายการ "เพิ่มการเชื่อมต่อ" แอปของคุณต้องมีอะแดปเตอร์การซิงค์เพื่อซิงค์ข้อมูลติดต่อจากเครือข่ายโซเชียล จากนั้นคุณต้องระบุให้ระบบทราบว่าแอปของคุณตอบสนองต่อ Intent INVITE_CONTACT โดยเพิ่มแอตทริบิวต์ inviteContactActivity ลงในไฟล์การกำหนดค่าการซิงค์ของแอป พร้อมชื่อกิจกรรมที่สมบูรณ์ซึ่งระบบควรเริ่มเมื่อส่ง Intent การเชิญ
จากนั้นกิจกรรมที่เริ่มต้นจะดึงข้อมูล URI สำหรับรายชื่อติดต่อที่เป็นปัญหาจากข้อมูลของ Intent และดำเนินการที่จำเป็นเพื่อเชิญรายชื่อติดต่อนั้นเข้าสู่เครือข่ายหรือเพิ่มบุคคลนั้นลงในการเชื่อมต่อของผู้ใช้
รูปภาพขนาดใหญ่
ตอนนี้ Android รองรับรูปภาพความละเอียดสูงสำหรับรายชื่อติดต่อแล้ว ตอนนี้ เมื่อคุณพุชรูปภาพลงในบันทึกรายชื่อติดต่อ ระบบจะประมวลผลรูปภาพเป็นทั้งภาพขนาดย่อขนาด 96x96 (เหมือนที่เคยทำก่อนหน้านี้) และ "รูปภาพที่แสดง" ขนาด 256x256 ซึ่งจัดเก็บไว้ในที่เก็บรูปภาพแบบไฟล์ใหม่ (ขนาดที่ระบบเลือกอาจแตกต่างกันไปในอนาคต) คุณสามารถเพิ่มรูปภาพขนาดใหญ่ให้กับรายชื่อติดต่อได้โดยใส่รูปภาพขนาดใหญ่ในคอลัมน์ PHOTO ปกติของแถวข้อมูล ซึ่งระบบจะประมวลผลเป็นภาพขนาดย่อและแสดงระเบียนรูปภาพที่เหมาะสม
ความคิดเห็นเกี่ยวกับการใช้งานรายชื่อติดต่อ
API ContactsContract.DataUsageFeedback ใหม่ช่วยให้คุณติดตามได้ว่าผู้ใช้ใช้วิธีการติดต่อผู้คนบางวิธีบ่อยเพียงใด เช่น ผู้ใช้ใช้หมายเลขโทรศัพท์หรืออีเมลแต่ละรายการบ่อยเพียงใด ข้อมูลนี้จะช่วยปรับปรุงการจัดอันดับวิธีติดต่อที่เชื่อมโยงกับแต่ละคน และให้คำแนะนำที่ดีขึ้นสำหรับการติดต่อแต่ละคน
ผู้ให้บริการปฏิทิน
API ปฏิทินใหม่ช่วยให้คุณอ่าน เพิ่ม แก้ไข และลบปฏิทิน กิจกรรมในปฏิทิน ผู้เข้าร่วม การช่วยเตือน และการแจ้งเตือนที่จัดเก็บไว้ในผู้ให้บริการปฏิทินได้
แอปและวิดเจ็ตต่างๆ สามารถใช้ API เหล่านี้เพื่ออ่านและแก้ไขกิจกรรมในปฏิทินได้ อย่างไรก็ตาม กรณีการใช้งานที่น่าสนใจที่สุดบางกรณีคืออะแดปเตอร์การซิงค์ที่ซิงค์ปฏิทินของผู้ใช้จากบริการปฏิทินอื่นๆ กับผู้ให้บริการปฏิทิน เพื่อให้มีตำแหน่งที่รวมกิจกรรมทั้งหมดของผู้ใช้ไว้ในที่เดียว ตัวอย่างเช่น อะแดปเตอร์การซิงค์ Google ปฏิทินจะซิงค์กิจกรรมใน Google ปฏิทินกับผู้ให้บริการปฏิทิน ซึ่งช่วยให้ดูกิจกรรมเหล่านี้ได้ด้วยแอปปฏิทินในตัวของ Android
โมเดลข้อมูลสำหรับปฏิทินและข้อมูลที่เกี่ยวข้องกับกิจกรรมในผู้ให้บริการปฏิทินจะกำหนดโดย CalendarContract ข้อมูลปฏิทินทั้งหมดของผู้ใช้จะจัดเก็บไว้ในตารางจำนวนหนึ่งซึ่งกำหนดโดยคลาสย่อยต่างๆ ของ CalendarContract ดังนี้
- ตาราง
CalendarContract.Calendarsจะเก็บข้อมูลเฉพาะของปฏิทิน แต่ละแถวในตารางนี้จะมีรายละเอียดของปฏิทินเดียว เช่น ชื่อ สี และข้อมูลการซิงค์ - ตาราง
CalendarContract.Eventsมีข้อมูลเฉพาะเหตุการณ์ แต่ละแถวในตารางนี้มีข้อมูลสำหรับกิจกรรมเดียว เช่น ชื่อกิจกรรม สถานที่ เวลาเริ่มต้น และเวลาสิ้นสุด กิจกรรมอาจเกิดขึ้นครั้งเดียวหรือเกิดซ้ำหลายครั้งก็ได้ ผู้เข้าร่วม การช่วยเตือน และพร็อพเพอร์ตี้เพิ่มเติมจะจัดเก็บไว้ในตารางแยกต่างหาก และใช้_IDของกิจกรรมเพื่อลิงก์กับกิจกรรม - ตาราง
CalendarContract.Instancesจะเก็บเวลาเริ่มต้นและสิ้นสุดของการเกิดกิจกรรม แต่ละแถวในตารางนี้แสดงถึงเหตุการณ์ที่เกิดขึ้น 1 ครั้ง สำหรับกิจกรรมที่เกิดขึ้นครั้งเดียว จะมีการแมปอินสแตนซ์กับกิจกรรมแบบหนึ่งต่อหนึ่ง สำหรับกิจกรรมที่เกิดซ้ำ ระบบจะสร้างแถวหลายแถวโดยอัตโนมัติเพื่อให้สอดคล้องกับการเกิดซ้ำหลายครั้งของกิจกรรมนั้น - ตาราง
CalendarContract.Attendeesจะเก็บข้อมูลผู้เข้าร่วมหรือแขกของกิจกรรม แต่ละแถวแสดงถึงผู้เข้าร่วมกิจกรรม 1 คน โดยจะระบุประเภทของผู้เข้าร่วมและคำตอบของบุคคลนั้นสำหรับกิจกรรม - ตาราง
CalendarContract.Remindersจะเก็บข้อมูลการแจ้งเตือน/การเตือน แต่ละแถวแสดงการแจ้งเตือน 1 รายการสำหรับเหตุการณ์ กิจกรรมหนึ่งๆ สามารถมีการช่วยเตือนได้หลายรายการ จำนวนการช่วยเตือนต่อกิจกรรมจะระบุไว้ในMAX_REMINDERSซึ่งกำหนดโดยอะแดปเตอร์การซิงค์ที่เป็นเจ้าของปฏิทินที่ระบุ การช่วยเตือนจะระบุเป็นจำนวนนาทีก่อนถึงกิจกรรมที่กำหนดเวลาไว้ และระบุวิธีการปลุก เช่น ใช้การแจ้งเตือน อีเมล หรือ SMS เพื่อช่วยเตือนผู้ใช้ - ตาราง
CalendarContract.ExtendedPropertiesมีฟิลด์ข้อมูลทึบแสงที่อะแดปเตอร์การซิงค์ใช้ ผู้ให้บริการจะไม่ดำเนินการใดๆ กับรายการในตารางนี้ ยกเว้นการลบรายการเมื่อมีการลบเหตุการณ์ที่เกี่ยวข้อง
หากต้องการเข้าถึงข้อมูลปฏิทินของผู้ใช้ด้วยผู้ให้บริการปฏิทิน แอปพลิเคชันของคุณต้องขอสิทธิ์ READ_CALENDAR (สำหรับสิทธิ์การอ่าน) และ WRITE_CALENDAR (สำหรับสิทธิ์การเขียน)
ความตั้งใจของเหตุการณ์
หากต้องการเพียงเพิ่มกิจกรรมลงในปฏิทินของผู้ใช้ คุณสามารถใช้ Intent ACTION_INSERT กับข้อมูลที่กำหนดโดย Events.CONTENT_URI เพื่อเริ่มกิจกรรมในแอปปฏิทินที่สร้างกิจกรรมใหม่ การใช้ Intent ไม่จำเป็นต้องมีสิทธิ์ใดๆ และคุณสามารถระบุรายละเอียดกิจกรรมด้วยข้อมูลเพิ่มเติมต่อไปนี้
Events.TITLE: ชื่อกิจกรรมCalendarContract.EXTRA_EVENT_BEGIN_TIME: เวลาเริ่มต้นของเหตุการณ์ในหน่วยมิลลิวินาทีจาก EpochCalendarContract.EXTRA_EVENT_END_TIME: เวลาสิ้นสุดของกิจกรรมในหน่วยมิลลิวินาทีจาก EpochEvents.EVENT_LOCATION: สถานที่จัดกิจกรรมEvents.DESCRIPTION: คำอธิบายกิจกรรมIntent.EXTRA_EMAIL: อีเมลของผู้ที่ต้องการเชิญEvents.RRULE: กฎการเกิดซ้ำ สำหรับกิจกรรมEvents.ACCESS_LEVEL: กิจกรรมเป็นแบบส่วนตัวหรือสาธารณะEvents.AVAILABILITY: ระยะเวลาของกิจกรรมนี้อนุญาตให้กำหนดเวลากิจกรรมอื่นๆ ในเวลาเดียวกันหรือไม่
ผู้ให้บริการข้อความเสียง
ผู้ให้บริการข้อความเสียงรายใหม่ช่วยให้แอปพลิเคชันเพิ่มข้อความเสียงลงในอุปกรณ์ได้ เพื่อแสดงข้อความเสียงทั้งหมดของผู้ใช้ในงานนำเสนอภาพเดียว ตัวอย่างเช่น ผู้ใช้อาจมีแหล่งที่มาของข้อความเสียงหลายแหล่ง เช่น แหล่งหนึ่งจากผู้ให้บริการโทรศัพท์ และแหล่งอื่นๆ จาก VoIP หรือบริการเสียงทางเลือกอื่นๆ แอปเหล่านี้สามารถใช้ API ของผู้ให้บริการข้อความเสียงเพื่อเพิ่มข้อความเสียงลงในอุปกรณ์ได้ จากนั้นแอปพลิเคชันโทรศัพท์ในตัวจะแสดงข้อความเสียงทั้งหมดให้ผู้ใช้เห็นในรูปแบบเดียว แม้ว่าแอปพลิเคชันโทรศัพท์ของระบบจะเป็นแอปพลิเคชันเดียวที่สามารถอ่านข้อความเสียงทั้งหมดได้ แต่แอปพลิเคชันแต่ละแอปที่ให้บริการข้อความเสียงจะสามารถอ่านข้อความเสียงที่เพิ่มลงในระบบได้ (แต่จะอ่านข้อความเสียงจากบริการอื่นๆ ไม่ได้)
เนื่องจากปัจจุบัน API ไม่อนุญาตให้แอปของบุคคลที่สามอ่านข้อความเสียงทั้งหมดจากระบบ แอปของบุคคลที่สามเพียงแอปเดียวที่ควรใช้ API ข้อความเสียงคือแอปที่มีข้อความเสียงเพื่อส่งให้ผู้ใช้
คลาส VoicemailContract จะกำหนดผู้ให้บริการเนื้อหาสำหรับผู้ให้บริการข้อความเสียง คลาสย่อย VoicemailContract.Voicemails และ VoicemailContract.Status มีตารางที่แอปสามารถแทรกข้อมูลข้อความเสียงเพื่อจัดเก็บไว้ในอุปกรณ์ได้ ดูตัวอย่างแอปผู้ให้บริการข้อความเสียงได้ที่เดโมผู้ให้บริการข้อความเสียง
มัลติมีเดีย
Android 4.0 เพิ่ม API ใหม่หลายรายการสำหรับแอปพลิเคชันที่โต้ตอบกับสื่อ เช่น รูปภาพ วิดีโอ และเพลง
เอฟเฟกต์สื่อ
เฟรมเวิร์กเอฟเฟกต์สื่อใหม่ช่วยให้คุณใช้เอฟเฟกต์ภาพที่หลากหลายกับรูปภาพและวิดีโอได้ ตัวอย่างเช่น เอฟเฟกต์รูปภาพช่วยให้คุณแก้ไขตาแดง แปลงรูปภาพเป็นโทนสีเทา ปรับความสว่าง ปรับความอิ่มตัว หมุนรูปภาพ ใช้เอฟเฟกต์ฟิชอาย และอื่นๆ อีกมากมาย ระบบจะประมวลผลเอฟเฟกต์ทั้งหมดใน GPU เพื่อให้ได้ประสิทธิภาพสูงสุด
ระบบจะใช้เอฟเฟกต์กับพื้นผิว OpenGL โดยตรงเพื่อให้ได้ประสิทธิภาพสูงสุด ดังนั้นแอปพลิเคชันของคุณจึงต้องมีบริบท OpenGL ที่ถูกต้องก่อนจึงจะใช้ API เอฟเฟกต์ได้ พื้นผิวที่คุณใช้เอฟเฟกต์อาจมาจากบิตแมป วิดีโอ หรือแม้แต่กล้อง อย่างไรก็ตาม พื้นผิวต้องเป็นไปตามข้อจำกัดบางประการดังนี้
- ต้องเชื่อมโยงกับรูปภาพพื้นผิว
GL_TEXTURE_2D - โดยต้องมีระดับ Mipmap อย่างน้อย 1 ระดับ
ออบเจ็กต์ Effect กำหนดเอฟเฟกต์สื่อรายการเดียวที่คุณใช้กับเฟรมรูปภาพได้ เวิร์กโฟลว์พื้นฐานในการสร้าง Effect มีดังนี้
- เรียกใช้
EffectContext.createWithCurrentGlContext()จากบริบท OpenGL ES 2.0 - ใช้
EffectContextที่แสดงผลเพื่อเรียกEffectContext.getFactory()ซึ่งจะแสดงผลอินสแตนซ์ของEffectFactory - เรียกใช้
createEffect()โดยส่งชื่อเอฟเฟกต์จาก @link android.media.effect.EffectFactory} เช่นEFFECT_FISHEYEหรือEFFECT_VIGNETTE
คุณสามารถปรับพารามิเตอร์ของเอฟเฟกต์ได้โดยเรียกใช้ setParameter() และส่งชื่อพารามิเตอร์และค่าพารามิเตอร์ เอฟเฟกต์แต่ละประเภทจะยอมรับพารามิเตอร์ที่แตกต่างกัน ซึ่งจะบันทึกไว้พร้อมกับชื่อเอฟเฟกต์ เช่น EFFECT_FISHEYE มีพารามิเตอร์ 1 รายการสำหรับscaleของการบิดเบือน
หากต้องการใช้เอฟเฟกต์กับพื้นผิว ให้เรียก apply() ใน Effect และส่งพื้นผิวอินพุต ความกว้างและความสูงของพื้นผิว และพื้นผิวเอาต์พุต พื้นผิวอินพุตต้องเชื่อมโยงกับรูปภาพพื้นผิว GL_TEXTURE_2D (โดยปกติจะทำได้โดยการเรียกใช้ฟังก์ชัน glTexImage2D()) คุณสามารถระบุระดับ Mipmap ได้หลายระดับ หากพื้นผิวเอาต์พุตไม่ได้เชื่อมโยงกับรูปภาพพื้นผิว ระบบจะเชื่อมโยงโดยอัตโนมัติด้วยเอฟเฟกต์เป็น GL_TEXTURE_2D และมีระดับ Mipmap 1 ระดับ (0) ซึ่งจะมีขนาดเท่ากับอินพุต
เรารับประกันว่าเอฟเฟกต์ทั้งหมดที่แสดงใน EffectFactory จะได้รับการรองรับ
อย่างไรก็ตาม อุปกรณ์บางรุ่นอาจไม่รองรับเอฟเฟกต์เพิ่มเติมบางอย่างที่พร้อมใช้งานจากไลบรารีภายนอก ดังนั้นคุณต้องตรวจสอบก่อนว่าอุปกรณ์รองรับเอฟเฟกต์ที่ต้องการจากไลบรารีภายนอกหรือไม่โดยเรียกใช้ isEffectSupported()
ไคลเอ็นต์รีโมตคอนโทรล
RemoteControlClient ใหม่ช่วยให้มีเดียเพลเยอร์เปิดใช้ตัวควบคุมการเล่นจากไคลเอ็นต์รีโมตคอนโทรล เช่น หน้าจอล็อกของอุปกรณ์ได้ นอกจากนี้ มีเดียเพลเยอร์ยังแสดงข้อมูลเกี่ยวกับสื่อที่กำลังเล่นอยู่เพื่อแสดงบนรีโมตคอนโทรลได้ด้วย เช่น ข้อมูลแทร็กและปกอัลบั้ม
หากต้องการเปิดใช้ไคลเอ็นต์รีโมตคอนโทรลสำหรับมีเดียเพลเยอร์ ให้สร้างอินสแตนซ์ RemoteControlClient ด้วยคอนสตรัคเตอร์ โดยส่ง PendingIntent ที่ออกอากาศ ACTION_MEDIA_BUTTON นอกจากนี้ Intent ต้องประกาศคอมโพเนนต์ BroadcastReceiver ที่ชัดเจนในแอปของคุณซึ่งจัดการเหตุการณ์ ACTION_MEDIA_BUTTON ด้วย
หากต้องการประกาศว่าเพลเยอร์ของคุณสามารถจัดการอินพุตตัวควบคุมสื่อใดได้บ้าง คุณต้องเรียกใช้ setTransportControlFlags() ใน RemoteControlClient โดยส่งชุดแฟล็ก FLAG_KEY_MEDIA_* เช่น FLAG_KEY_MEDIA_PREVIOUS และ FLAG_KEY_MEDIA_NEXT
จากนั้นคุณต้องลงทะเบียน RemoteControlClient โดยส่งไปยัง MediaManager.registerRemoteControlClient()
เมื่อลงทะเบียนแล้ว Broadcast Receiver ที่คุณประกาศไว้เมื่อสร้างอินสแตนซ์ RemoteControlClient จะได้รับเหตุการณ์ ACTION_MEDIA_BUTTON เมื่อมีการกดปุ่มจากรีโมตคอนโทรล Intent ที่คุณได้รับจะมี KeyEvent สำหรับแป้นสื่อที่กด ซึ่งคุณสามารถดึงข้อมูลจาก Intent ด้วย getParcelableExtra(Intent.EXTRA_KEY_EVENT)
หากต้องการแสดงข้อมูลเกี่ยวกับสื่อที่กำลังเล่นบนรีโมตคอนโทรล ให้เรียกใช้ editMetaData() และเพิ่มข้อมูลเมตาลงใน RemoteControlClient.MetadataEditor ที่แสดงผล คุณสามารถระบุบิตแมปสำหรับอาร์ตเวิร์กของสื่อ ข้อมูลตัวเลข เช่น เวลาที่ผ่านไป และข้อมูลข้อความ เช่น ชื่อแทร็ก ดูข้อมูลเกี่ยวกับคีย์ที่ใช้ได้ที่แฟล็ก METADATA_KEY_* ใน MediaMetadataRetriever
ดูตัวอย่างการใช้งานได้ที่ Random Music Player ซึ่งมีตรรกะความเข้ากันได้ที่เปิดใช้ไคลเอ็นต์รีโมตคอนโทรลในอุปกรณ์ Android 4.0 ขณะที่ยังคงรองรับอุปกรณ์ที่ใช้ Android 2.1
มีเดียเพลเยอร์
- ตอนนี้การสตรีมสื่อออนไลน์จาก
MediaPlayerต้องใช้สิทธิ์INTERNETหากคุณใช้MediaPlayerเพื่อเล่นเนื้อหาจากอินเทอร์เน็ต โปรดเพิ่มสิทธิ์INTERNETลงในไฟล์ Manifest ไม่เช่นนั้นการเล่นสื่อจะไม่ทำงานตั้งแต่ Android 4.0 เป็นต้นไป setSurface()ช่วยให้คุณกำหนดSurfaceให้ทำหน้าที่เป็นซิงก์วิดีโอได้setDataSource()ช่วยให้คุณส่งส่วนหัว HTTP เพิ่มเติมพร้อมกับคำขอได้ ซึ่งอาจเป็นประโยชน์สำหรับการไลฟ์สดผ่าน HTTP(S)- ตอนนี้การไลฟ์สดแบบ HTTP(S) จะใช้คุกกี้ HTTP ในคำขอต่างๆ
ประเภทสื่อ
Android 4.0 เพิ่มการรองรับสำหรับสิ่งต่อไปนี้
- โปรโตคอลสตรีมมิงแบบสด HTTP/HTTPS เวอร์ชัน 3
- การเข้ารหัสเสียง AAC แบบข้อมูลดิบ ADTS
- รูปภาพ WEBP
- วิดีโอ Matroska
ดูข้อมูลเพิ่มเติมได้ที่รูปแบบสื่อที่รองรับ
กล้อง
ตอนนี้คลาส Camera มี API สำหรับตรวจจับใบหน้าและควบคุมพื้นที่โฟกัสและการวัดแสงแล้ว
การตรวจจับใบหน้า
ตอนนี้แอปกล้องสามารถเพิ่มประสิทธิภาพด้วย API การตรวจจับใบหน้าของ Android ซึ่งไม่เพียงตรวจจับใบหน้าของวัตถุเท่านั้น แต่ยังตรวจจับลักษณะเฉพาะของใบหน้า เช่น ดวงตาและปากด้วย
หากต้องการตรวจจับใบหน้าในแอปพลิเคชันกล้อง คุณต้องลงทะเบียน Camera.FaceDetectionListener โดยเรียกใช้ setFaceDetectionListener() จากนั้นคุณสามารถเริ่มใช้พื้นผิวกล้องและเริ่มตรวจจับใบหน้าได้โดยเรียกใช้ startFaceDetection()
เมื่อระบบตรวจพบใบหน้าอย่างน้อย 1 ใบหน้าในฉากของกล้อง ระบบจะเรียกใช้ Callback onFaceDetection() ในการติดตั้งใช้งาน Camera.FaceDetectionListener ซึ่งรวมถึงอาร์เรย์ของออบเจ็กต์ Camera.Face
อินสแตนซ์ของคลาส Camera.Face จะให้ข้อมูลต่างๆ เกี่ยวกับการตรวจจับใบหน้า ซึ่งรวมถึงข้อมูลต่อไปนี้
Rectที่ระบุขอบเขตของใบหน้า โดยสัมพันธ์กับขอบเขตการมองเห็นปัจจุบันของกล้อง- จำนวนเต็มระหว่าง 1 ถึง 100 ซึ่งระบุระดับความมั่นใจของระบบว่าวัตถุนั้นเป็นใบหน้ามนุษย์
- รหัสที่ไม่ซ้ำกันเพื่อให้คุณติดตามใบหน้าหลายใบหน้าได้
- ออบเจ็กต์
Pointหลายรายการที่ระบุตำแหน่งของตาและปาก
หมายเหตุ: อุปกรณ์บางรุ่นอาจไม่รองรับการตรวจจับใบหน้า ดังนั้นคุณควรตรวจสอบโดยเรียกใช้ getMaxNumDetectedFaces() และตรวจสอบว่าค่าที่แสดงผลมากกว่า 0 นอกจากนี้ อุปกรณ์บางรุ่นอาจไม่รองรับการระบุตาและปาก ซึ่งในกรณีนี้ ช่องเหล่านั้นในออบเจ็กต์ Camera.Face จะเป็นค่า Null
พื้นที่โฟกัสและวัดแสง
ตอนนี้แอปกล้องสามารถควบคุมพื้นที่ที่กล้องใช้ในการโฟกัสและวัดสมดุลแสงขาวและการเปิดรับแสงอัตโนมัติได้แล้ว ทั้ง 2 ฟีเจอร์ใช้คลาส Camera.Area ใหม่เพื่อระบุขอบเขตของมุมมองปัจจุบันของกล้องที่ควรโฟกัสหรือวัดแสง อินสแตนซ์ของคลาส Camera.Area จะกำหนดขอบเขตของพื้นที่ด้วย Rect และน้ำหนักของพื้นที่ ซึ่งแสดงถึงระดับความสำคัญของพื้นที่นั้นเมื่อเทียบกับพื้นที่อื่นๆ ที่พิจารณา โดยใช้จำนวนเต็ม
ก่อนตั้งค่าพื้นที่โฟกัสหรือพื้นที่วัดแสง คุณควรเรียกใช้ getMaxNumFocusAreas() หรือ getMaxNumMeteringAreas() ก่อนตามลำดับ หากค่าเหล่านี้เป็น 0 แสดงว่าอุปกรณ์ไม่รองรับฟีเจอร์ที่เกี่ยวข้อง
หากต้องการระบุพื้นที่โฟกัสหรือพื้นที่วัดแสงที่จะใช้ ให้เรียกใช้ setFocusAreas() หรือ setMeteringAreas() แต่ละรายการจะใช้ List ของออบเจ็กต์ Camera.Area ที่ระบุพื้นที่ที่ควรพิจารณาสำหรับการโฟกัสหรือการวัดแสง ตัวอย่างเช่น คุณอาจใช้ฟีเจอร์ที่อนุญาตให้ผู้ใช้ตั้งค่าพื้นที่โฟกัสโดยแตะพื้นที่ของตัวอย่าง ซึ่งคุณจะแปลเป็นออบเจ็กต์ Camera.Area และขอให้กล้องโฟกัสที่พื้นที่นั้นของฉาก
โฟกัสหรือการรับแสงในบริเวณนั้นจะอัปเดตอย่างต่อเนื่องเมื่อฉากในบริเวณนั้นเปลี่ยนไป
โฟกัสอัตโนมัติต่อเนื่องสำหรับรูปภาพ
ตอนนี้คุณสามารถเปิดใช้การโฟกัสอัตโนมัติแบบต่อเนื่อง (CAF) เมื่อถ่ายภาพได้แล้ว หากต้องการเปิดใช้ CAF ในแอปกล้อง ให้ส่ง FOCUS_MODE_CONTINUOUS_PICTURE ไปยัง setFocusMode() เมื่อพร้อมถ่ายภาพแล้ว
ให้โทรหา autoFocus() Camera.AutoFocusCallback จะได้รับ Callback ทันทีเพื่อระบุว่าได้รับโฟกัสหรือไม่ หากต้องการกลับมาใช้ CAF อีกครั้งหลังจากได้รับการเรียกกลับ คุณต้องเรียกใช้ cancelAutoFocus()
หมายเหตุ: ระบบยังรองรับการโฟกัสอัตโนมัติแบบต่อเนื่องเมื่อจับภาพวิดีโอโดยใช้ FOCUS_MODE_CONTINUOUS_VIDEO ซึ่งเพิ่มเข้ามาในระดับ API 9
ฟีเจอร์อื่นๆ ของกล้อง
- ขณะบันทึกวิดีโอ คุณสามารถเรียกใช้
takePicture()เพื่อบันทึกรูปภาพได้โดยไม่รบกวนเซสชันวิดีโอ ก่อนดำเนินการดังกล่าว คุณควรโทรหาisVideoSnapshotSupported()เพื่อตรวจสอบว่าฮาร์ดแวร์รองรับหรือไม่ - ตอนนี้คุณสามารถล็อกการเปิดรับแสงอัตโนมัติและสมดุลแสงขาวด้วย
setAutoExposureLock()และsetAutoWhiteBalanceLock()เพื่อป้องกันไม่ให้คุณสมบัติเหล่านี้เปลี่ยนแปลงได้ - ตอนนี้คุณสามารถโทรหา
setDisplayOrientation()ขณะที่ตัวอย่างกล้องกำลังทำงานอยู่ได้แล้ว ก่อนหน้านี้ คุณจะเรียกใช้เมธอดนี้ได้ก่อนเริ่มแสดงตัวอย่างเท่านั้น แต่ตอนนี้คุณเปลี่ยนการวางแนวได้ทุกเมื่อ
Intent การออกอากาศของกล้อง
Camera.ACTION_NEW_PICTURE: ซึ่งหมายความว่าผู้ใช้ได้ถ่ายรูปใหม่ แอปกล้องในตัวจะเรียกใช้การออกอากาศนี้หลังจากถ่ายภาพ และแอปกล้องของบุคคลที่สามควรออกอากาศ Intent นี้หลังจากถ่ายภาพด้วยCamera.ACTION_NEW_VIDEO: ซึ่งบ่งบอกว่าผู้ใช้ได้จับภาพวิดีโอใหม่ แอปกล้องถ่ายรูปในตัวจะเรียกใช้การออกอากาศนี้หลังจากบันทึกวิดีโอ และแอปกล้องถ่ายรูปของบุคคลที่สามควรออกอากาศ Intent นี้หลังจากจับภาพวิดีโอด้วย
Android Beam (NDEF Push ที่มี NFC)
Android Beam เป็นฟีเจอร์ NFC ใหม่ที่ช่วยให้คุณส่งข้อความ NDEF จากอุปกรณ์เครื่องหนึ่งไปยังอีกเครื่องหนึ่งได้ (กระบวนการนี้เรียกอีกอย่างว่า "NDEF Push") การโอนข้อมูลจะเริ่มต้นเมื่ออุปกรณ์ที่ใช้ Android 2 เครื่องที่รองรับ Android Beam อยู่ใกล้กัน (ประมาณ 4 ซม.) โดยปกติแล้วจะหันด้านหลังเข้าหากัน ข้อมูลภายในข้อความ NDEF อาจมีข้อมูลใดๆ ที่คุณต้องการแชร์ระหว่างอุปกรณ์ ตัวอย่างเช่น แอป Contacts จะแชร์รายชื่อติดต่อ, YouTube จะแชร์วิดีโอ และเบราว์เซอร์จะแชร์ URL โดยใช้ Android Beam
หากต้องการส่งข้อมูลระหว่างอุปกรณ์โดยใช้ Android Beam คุณต้องสร้าง NdefMessage ที่มีข้อมูลที่ต้องการแชร์ขณะที่กิจกรรมของคุณอยู่ในเบื้องหน้า จากนั้นคุณต้องส่ง NdefMessage ไปยังระบบด้วยวิธีใดวิธีหนึ่งจาก 2 วิธีต่อไปนี้
- กำหนด
NdefMessageเดียวที่จะกดขณะอยู่ในกิจกรรม โดยทำดังนี้โทรหา
setNdefPushMessage()ได้ทุกเมื่อเพื่อตั้งค่าข้อความที่ต้องการส่ง ตัวอย่างเช่น คุณอาจเรียกใช้เมธอดนี้และส่งNdefMessageในระหว่างเมธอดonCreate()ของกิจกรรม จากนั้น เมื่อใดก็ตามที่เปิดใช้งาน Android Beam กับอุปกรณ์อื่นขณะที่กิจกรรมอยู่ในเบื้องหน้า ระบบจะส่งNdefMessageไปยังอุปกรณ์อีกเครื่องหนึ่ง - กำหนด
NdefMessageที่จะพุชในเวลาที่เริ่มต้น Android Beam ดังนี้ติดตั้งใช้งาน
NfcAdapter.CreateNdefMessageCallbackซึ่งการติดตั้งใช้งานเมธอดcreateNdefMessage()จะแสดงผลNdefMessageที่คุณต้องการส่ง จากนั้นส่งการใช้งานNfcAdapter.CreateNdefMessageCallbackไปยังsetNdefPushMessageCallback()ในกรณีนี้ เมื่อเปิดใช้งาน Android Beam กับอุปกรณ์อื่นขณะที่กิจกรรมของคุณอยู่เบื้องหน้า ระบบจะเรียกใช้
createNdefMessage()เพื่อดึงข้อมูลNdefMessageที่คุณต้องการส่ง ซึ่งจะช่วยให้คุณกำหนดNdefMessageเพื่อส่งเฉพาะเมื่อมีการเริ่มต้น Android Beam ในกรณีที่เนื้อหาของข้อความอาจแตกต่างกันไปตลอดอายุของกิจกรรม
ในกรณีที่คุณต้องการเรียกใช้โค้ดที่เฉพาะเจาะจงเมื่อระบบส่งข้อความ NDEF ไปยังอุปกรณ์อื่นเรียบร้อยแล้ว คุณสามารถใช้ NfcAdapter.OnNdefPushCompleteCallback และตั้งค่าด้วย setNdefPushCompleteCallback() จากนั้นระบบจะโทรหา onNdefPushComplete() เมื่อส่งข้อความแล้ว
ในอุปกรณ์ที่รับ ระบบจะส่งข้อความ NDEF Push ในลักษณะที่คล้ายกับแท็ก NFC ปกติ ระบบจะเรียกใช้ Intent ด้วยการดำเนินการ ACTION_NDEF_DISCOVERED เพื่อเริ่มกิจกรรม โดยตั้งค่า URL หรือประเภท MIME ตาม NdefRecord แรกใน NdefMessage สำหรับกิจกรรมที่คุณต้องการตอบสนอง คุณสามารถประกาศตัวกรอง Intent สำหรับ URL หรือประเภท MIME ที่แอปของคุณสนใจ ดูข้อมูลเพิ่มเติมเกี่ยวกับการส่งแท็กได้ในคู่มือนักพัฒนาซอฟต์แวร์ NFC
หากต้องการให้ NdefMessage มี URI ตอนนี้คุณสามารถใช้วิธีที่สะดวก createUri เพื่อสร้าง NdefRecord ใหม่โดยอิงตามสตริงหรือออบเจ็กต์ Uri ได้ หาก URI เป็นรูปแบบพิเศษที่คุณต้องการให้แอปพลิเคชันได้รับในระหว่างเหตุการณ์ Android Beam ด้วย คุณควรสร้างตัวกรอง Intent สำหรับกิจกรรมโดยใช้สคีม URI เดียวกันเพื่อรับข้อความ NDEF ที่เข้ามา
คุณควรส่ง "Android Application Record" พร้อมกับ NdefMessage เพื่อรับประกันว่าแอปพลิเคชัน Android จะจัดการข้อความ NDEF ขาเข้า แม้ว่าแอปพลิเคชันอื่นๆ จะกรองการดำเนินการตาม Intent เดียวกันก็ตาม คุณสร้างระเบียนแอปพลิเคชัน Android ได้โดยเรียกใช้ createApplicationRecord() และส่งชื่อแพ็กเกจของแอปพลิเคชัน เมื่ออุปกรณ์อีกเครื่องได้รับข้อความ NDEF ที่มีบันทึกแอปพลิเคชันและแอปพลิเคชันหลายรายการมีกิจกรรมที่จัดการ Intent ที่ระบุ ระบบจะส่งข้อความไปยังกิจกรรมในแอปพลิเคชันของคุณเสมอ (อิงตามบันทึกแอปพลิเคชันที่ตรงกัน) หากอุปกรณ์เป้าหมายไม่ได้ติดตั้งแอปพลิเคชันของคุณไว้ในปัจจุบัน ระบบจะใช้ระเบียนแอปพลิเคชัน Android เพื่อเปิด Google Play และนำผู้ใช้ไปยังแอปพลิเคชันเพื่อติดตั้ง
หากแอปพลิเคชันของคุณไม่ได้ใช้ NFC API เพื่อส่งข้อความ NDEF Push ระบบ Android จะมีลักษณะการทำงานเริ่มต้นดังนี้ เมื่อแอปพลิเคชันของคุณทำงานอยู่เบื้องหน้าในอุปกรณ์เครื่องหนึ่งและมีการเรียกใช้ Android Beam ด้วยอุปกรณ์ที่ใช้ Android อีกเครื่องหนึ่ง อุปกรณ์อีกเครื่องหนึ่งจะได้รับข้อความ NDEF ที่มีระเบียนแอปพลิเคชัน Android ซึ่งระบุแอปพลิเคชันของคุณ หากอุปกรณ์ที่รับติดตั้งแอปพลิเคชันไว้ ระบบจะเปิดแอปพลิเคชันนั้น หากไม่ได้ติดตั้งไว้ Google Play จะเปิดขึ้นและนำผู้ใช้ไปยังแอปพลิเคชันของคุณเพื่อติดตั้ง
คุณอ่านข้อมูลเพิ่มเติมเกี่ยวกับ Android Beam และฟีเจอร์ NFC อื่นๆ ได้ในคู่มือนักพัฒนาซอฟต์แวร์เรื่องข้อมูลเบื้องต้นเกี่ยวกับ NFC ดูตัวอย่างโค้ดที่ใช้ Android Beam ได้ที่เดโม Android Beam
Wi-Fi P2P
ตอนนี้ Android รองรับการเชื่อมต่อ Wi-Fi แบบเพียร์ทูเพียร์ (P2P) ระหว่างอุปกรณ์ที่ทำงานด้วยระบบ Android กับอุปกรณ์ประเภทอื่นๆ (เป็นไปตามโปรแกรมการรับรอง Wi-Fi Direct™ ของ Wi-Fi Alliance) โดยไม่ต้องใช้ฮอตสปอตหรือการเชื่อมต่ออินเทอร์เน็ต เฟรมเวิร์ก Android มีชุด Wi-Fi P2P API ที่ช่วยให้คุณค้นพบและเชื่อมต่อกับอุปกรณ์อื่นๆ เมื่ออุปกรณ์แต่ละเครื่องรองรับ Wi-Fi P2P จากนั้นสื่อสารผ่านการเชื่อมต่อที่รวดเร็วในระยะทางที่ไกลกว่าการเชื่อมต่อบลูทูธมาก
แพ็กเกจใหม่ android.net.wifi.p2p มี API ทั้งหมดสำหรับการเชื่อมต่อแบบเพียร์ทูเพียร์ด้วย Wi-Fi คลาสหลักที่คุณต้องใช้คือ WifiP2pManager ซึ่งคุณรับได้โดยการเรียกใช้ getSystemService(WIFI_P2P_SERVICE) WifiP2pManager มี API ที่ช่วยให้คุณทำสิ่งต่อไปนี้ได้
- เริ่มต้นแอปพลิเคชันสำหรับการเชื่อมต่อ P2P โดยเรียกใช้
initialize() - ค้นหาอุปกรณ์ที่อยู่ใกล้เคียงโดยเรียกใช้
discoverPeers() - เริ่มการเชื่อมต่อแบบ P2P โดยการโทรหา
connect() - และอื่นๆ
นอกจากนี้ยังจำเป็นต้องมีอินเทอร์เฟซและคลาสอื่นๆ อีกหลายรายการ เช่น
- อินเทอร์เฟซ
WifiP2pManager.ActionListenerช่วยให้คุณรับ Callback เมื่อการดำเนินการ เช่น การค้นหาเพียร์หรือการเชื่อมต่อกับเพียร์สำเร็จหรือล้มเหลว - อินเทอร์เฟซ
WifiP2pManager.PeerListListenerช่วยให้คุณได้รับข้อมูลเกี่ยวกับแอปเทียบเท่าที่ค้นพบ Callback จะให้WifiP2pDeviceListซึ่งคุณสามารถดึงข้อมูลออบเจ็กต์WifiP2pDeviceสำหรับอุปกรณ์แต่ละเครื่องภายในระยะสัญญาณและรับข้อมูล เช่น ชื่ออุปกรณ์ ที่อยู่ ประเภทอุปกรณ์ การกำหนดค่า WPS ที่อุปกรณ์รองรับ และอื่นๆ - อินเทอร์เฟซ
WifiP2pManager.GroupInfoListenerช่วยให้คุณได้รับข้อมูลเกี่ยวกับกลุ่ม P2P Callback จะแสดงออบเจ็กต์WifiP2pGroupซึ่งให้ข้อมูลกลุ่ม เช่น เจ้าของ ชื่อเครือข่าย และพาสเฟรส - อินเทอร์เฟซ
WifiP2pManager.ConnectionInfoListenerช่วยให้คุณได้รับข้อมูลเกี่ยวกับการเชื่อมต่อปัจจุบัน Callback จะแสดงออบเจ็กต์WifiP2pInfoซึ่งมีข้อมูล เช่น มีการสร้างกลุ่มหรือไม่ และใครเป็นเจ้าของกลุ่ม
หากต้องการใช้ Wi-Fi P2P API แอปของคุณต้องขอการให้สิทธิ์จากผู้ใช้ต่อไปนี้
ACCESS_WIFI_STATECHANGE_WIFI_STATEINTERNET(แม้ว่าในทางเทคนิคแล้วแอปของคุณจะไม่ได้เชื่อมต่อกับอินเทอร์เน็ต แต่การสื่อสารกับแอปเทียบเท่า Wi-Fi P2P ด้วยซ็อกเก็ต Java มาตรฐานต้องใช้สิทธิ์เข้าถึงอินเทอร์เน็ต)
ระบบ Android ยังออกอากาศการดำเนินการต่างๆ หลายรายการในระหว่างเหตุการณ์ Wi-Fi P2P บางอย่างด้วย
WIFI_P2P_CONNECTION_CHANGED_ACTION: สถานะการเชื่อมต่อ P2P มีการเปลี่ยนแปลง ซึ่งจะส่งEXTRA_WIFI_P2P_INFOพร้อมออบเจ็กต์WifiP2pInfoและEXTRA_NETWORK_INFOพร้อมออบเจ็กต์NetworkInfoWIFI_P2P_STATE_CHANGED_ACTION: สถานะ P2P เปลี่ยนระหว่างเปิดใช้และปิดใช้ โดยมีEXTRA_WIFI_STATEพร้อมด้วยWIFI_P2P_STATE_DISABLEDหรือWIFI_P2P_STATE_ENABLEDWIFI_P2P_PEERS_CHANGED_ACTION: รายการอุปกรณ์เพียร์มีการเปลี่ยนแปลงWIFI_P2P_THIS_DEVICE_CHANGED_ACTION: รายละเอียดของอุปกรณ์นี้มีการเปลี่ยนแปลง
ดูข้อมูลเพิ่มเติมในเอกสารประกอบของ WifiP2pManager นอกจากนี้ ให้ดูแอปพลิเคชันตัวอย่าง Wi-Fi P2P Demo ด้วย
อุปกรณ์เพื่อสุขภาพที่ใช้บลูทูธ
ตอนนี้ Android รองรับอุปกรณ์โปรไฟล์สุขภาพบลูทูธแล้ว คุณจึงสร้างแอปพลิเคชันที่ใช้บลูทูธเพื่อสื่อสารกับอุปกรณ์สุขภาพที่รองรับบลูทูธได้ เช่น เครื่องวัดอัตราการเต้นของหัวใจ เครื่องวัดความดันโลหิต เทอร์โมมิเตอร์ และเครื่องชั่งน้ำหนัก
เช่นเดียวกับอุปกรณ์ชุดหูฟังและโปรไฟล์ A2DP ทั่วไป คุณต้องเรียกใช้ getProfileProxy() ด้วย BluetoothProfile.ServiceListener และประเภทโปรไฟล์ HEALTH เพื่อสร้างการเชื่อมต่อกับออบเจ็กต์พร็อกซีโปรไฟล์
เมื่อได้รับพร็อกซีโปรไฟล์สุขภาพ (ออบเจ็กต์ BluetoothHealth) แล้ว การเชื่อมต่อและการสื่อสารกับอุปกรณ์สุขภาพที่จับคู่จะเกี่ยวข้องกับคลาสบลูทูธใหม่ต่อไปนี้
BluetoothHealthCallback: คุณต้องขยายคลาสนี้และใช้เมธอด Callback เพื่อรับข้อมูลอัปเดตเกี่ยวกับการเปลี่ยนแปลงสถานะการลงทะเบียนของแอปพลิเคชันและสถานะช่องสัญญาณบลูทูธBluetoothHealthAppConfiguration: ในระหว่างการเรียกกลับไปยังBluetoothHealthCallbackคุณจะได้รับอินสแตนซ์ของออบเจ็กต์นี้ ซึ่งให้ข้อมูลการกำหนดค่าเกี่ยวกับอุปกรณ์สุขภาพที่ใช้บลูทูธที่พร้อมใช้งาน ซึ่งคุณต้องใช้เพื่อดำเนินการต่างๆ เช่น เริ่มต้นและสิ้นสุดการเชื่อมต่อกับBluetoothHealthAPI
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้โปรไฟล์สุขภาพบลูทูธได้ในเอกสารประกอบสำหรับ BluetoothHealth
การช่วยเหลือพิเศษ
Android 4.0 ปรับปรุงการช่วยเหลือพิเศษสำหรับผู้ใช้ที่มีความบกพร่องทางสายตาด้วยโหมดแตะเพื่อสำรวจใหม่และ API แบบขยายที่ช่วยให้คุณระบุข้อมูลเพิ่มเติมเกี่ยวกับเนื้อหาการดูหรือพัฒนาบริการการช่วยเหลือพิเศษขั้นสูงได้
โหมดแตะเพื่อสำรวจ
ตอนนี้ผู้ใช้ที่สูญเสียการมองเห็นสามารถสำรวจหน้าจอได้โดยการแตะและลากนิ้วไปทั่วหน้าจอเพื่อฟังคำอธิบายเนื้อหาด้วยเสียง เนื่องจากโหมดแตะเพื่อสำรวจทำงานเหมือนเคอร์เซอร์เสมือน จึงช่วยให้โปรแกรมอ่านหน้าจอระบุข้อความอธิบายได้ในลักษณะเดียวกับที่โปรแกรมอ่านหน้าจอทำได้เมื่อผู้ใช้ไปยังส่วนต่างๆ ด้วย D-pad หรือแทร็กบอล โดยการอ่านข้อมูลที่ได้จาก android:contentDescription และ setContentDescription() ในเหตุการณ์ "วางเมาส์เหนือ" ที่จำลองขึ้น ดังนั้น โปรดพิจารณาว่านี่เป็นการช่วยเตือนว่าคุณควรระบุข้อความอธิบายสำหรับมุมมองในแอปพลิเคชัน โดยเฉพาะสำหรับ ImageButton, EditText, ImageView และวิดเจ็ตอื่นๆ ที่อาจไม่มีข้อความอธิบายโดยธรรมชาติ
การช่วยเหลือพิเศษสำหรับมุมมอง
หากต้องการปรับปรุงข้อมูลที่พร้อมใช้งานสำหรับบริการการช่วยเหลือพิเศษ เช่น โปรแกรมอ่านหน้าจอ คุณสามารถใช้เมธอด Callback ใหม่สำหรับเหตุการณ์การช่วยเหลือพิเศษในคอมโพเนนต์ View ที่กำหนดเองได้
โปรดทราบว่าลักษณะการทำงานของเมธอด sendAccessibilityEvent() มีการเปลี่ยนแปลงใน Android 4.0 เช่นเดียวกับ Android เวอร์ชันก่อนหน้า เมื่อผู้ใช้เปิดใช้บริการการช่วยเหลือพิเศษในอุปกรณ์และการป้อนข้อมูล เช่น การคลิกหรือการวางเมาส์เหนือองค์ประกอบ มุมมองที่เกี่ยวข้องจะได้รับการแจ้งเตือนด้วยการเรียกใช้ sendAccessibilityEvent() ก่อนหน้านี้ การติดตั้งใช้งาน sendAccessibilityEvent() จะเริ่มต้น AccessibilityEvent และส่งไปยัง AccessibilityManager ลักษณะการทำงานใหม่เกี่ยวข้องกับเมธอด Callback เพิ่มเติมบางอย่างที่ช่วยให้มุมมองและระดับบนสุดของมุมมองเพิ่มข้อมูลตามบริบทลงในเหตุการณ์ได้มากขึ้น ดังนี้
- เมื่อเรียกใช้ เมธอด
sendAccessibilityEvent()และsendAccessibilityEventUnchecked()จะเลื่อนไปที่onInitializeAccessibilityEvent()การติดตั้งใช้งาน
Viewที่กำหนดเองอาจต้องการติดตั้งใช้งานonInitializeAccessibilityEvent()เพื่อแนบข้อมูลการช่วยเหลือพิเศษเพิ่มเติมไปยังAccessibilityEventแต่ควรเรียกใช้การติดตั้งใช้งานขั้นสูงเพื่อระบุข้อมูลเริ่มต้น เช่น คำอธิบายเนื้อหามาตรฐาน ดัชนีรายการ และอื่นๆ ด้วย อย่างไรก็ตาม คุณไม่ควรเพิ่มเนื้อหาข้อความเพิ่มเติมใน Callback นี้ ซึ่งจะเกิดขึ้นในขั้นตอนถัดไป - เมื่อเริ่มต้นแล้ว หากเหตุการณ์เป็นหนึ่งในหลายประเภทที่ควรป้อนข้อมูลข้อความ มุมมองจะได้รับการเรียกไปยัง
dispatchPopulateAccessibilityEvent()ซึ่งจะเลื่อนไปยัง CallbackonPopulateAccessibilityEvent()การติดตั้งใช้งาน
Viewที่กำหนดเองมักจะต้องติดตั้งใช้งานonPopulateAccessibilityEvent()เพื่อเพิ่มเนื้อหาข้อความเพิ่มเติมลงในAccessibilityEventหากไม่มีข้อความandroid:contentDescriptionหรือมีไม่เพียงพอ หากต้องการเพิ่มคำอธิบายข้อความในAccessibilityEventให้โทรgetText()add() - ณ จุดนี้
Viewจะส่งเหตุการณ์ขึ้นไปตามลำดับชั้นการแสดงผลโดยเรียกใช้requestSendAccessibilityEvent()ในมุมมองหลัก จากนั้นมุมมองหลักแต่ละมุมมองจะมีโอกาสเพิ่มข้อมูลการช่วยเหลือพิเศษโดยการเพิ่มAccessibilityRecordจนกว่าจะถึงมุมมองรากในที่สุด ซึ่งจะส่งเหตุการณ์ไปยังAccessibilityManagerพร้อมsendAccessibilityEvent()
นอกเหนือจากเมธอดใหม่ข้างต้นซึ่งมีประโยชน์เมื่อขยายคลาส View แล้ว คุณยังสามารถสกัดกั้น Callback ของเหตุการณ์เหล่านี้ใน View ใดก็ได้โดยขยาย AccessibilityDelegate และตั้งค่าในมุมมองด้วย setAccessibilityDelegate()
เมื่อดำเนินการดังกล่าว เมธอดการช่วยเหลือพิเศษแต่ละรายการในมุมมองจะเลื่อนการเรียกไปยังเมธอดที่เกี่ยวข้องในผู้รับมอบสิทธิ์ ตัวอย่างเช่น เมื่อมุมมองได้รับการเรียกไปยัง onPopulateAccessibilityEvent() ระบบจะส่งต่อไปยังเมธอดเดียวกันใน View.AccessibilityDelegate เมธอดใดๆ ที่ผู้รับมอบสิทธิ์ไม่ได้จัดการจะส่งกลับไปยังมุมมองเพื่อใช้ลักษณะการทำงานเริ่มต้น ซึ่งจะช่วยให้คุณลบล้างเฉพาะเมธอดที่จำเป็นสำหรับมุมมองหนึ่งๆ ได้โดยไม่ต้องขยายคลาส View
หากต้องการรักษาความเข้ากันได้กับ Android เวอร์ชันก่อน 4.0 ขณะเดียวกันก็รองรับ Accessibility API ใหม่ด้วย คุณสามารถทำได้โดยใช้ไลบรารีสนับสนุน v4 เวอร์ชันล่าสุด (ในแพ็กเกจความเข้ากันได้ r4) โดยใช้ชุดคลาสยูทิลิตีที่ให้ Accessibility API ใหม่ในการออกแบบที่เข้ากันได้แบบย้อนหลัง
บริการการช่วยเหลือพิเศษ
หากคุณกำลังพัฒนาบริการการช่วยเหลือพิเศษ ข้อมูลเกี่ยวกับเหตุการณ์การช่วยเหลือพิเศษต่างๆ ได้รับการขยายอย่างมากเพื่อเปิดใช้ความคิดเห็นเกี่ยวกับการช่วยเหลือพิเศษขั้นสูงสำหรับผู้ใช้ โดยเฉพาะอย่างยิ่ง เหตุการณ์จะสร้างขึ้นตามองค์ประกอบของมุมมอง ซึ่งให้ข้อมูลบริบทที่ดีขึ้นและช่วยให้บริการการช่วยเหลือพิเศษสามารถไปยังส่วนต่างๆ ของลำดับชั้นการแสดงผลเพื่อรับข้อมูลมุมมองเพิ่มเติมและจัดการกับกรณีพิเศษได้
หากคุณกำลังพัฒนาบริการการช่วยเหลือพิเศษ (เช่น โปรแกรมอ่านหน้าจอ) คุณสามารถเข้าถึงข้อมูลเนื้อหาเพิ่มเติมและไปยังส่วนต่างๆ ของลำดับชั้นการแสดงผลได้โดยทำตามขั้นตอนต่อไปนี้
- เมื่อได้รับ
AccessibilityEventจากแอปพลิเคชัน ให้เรียกใช้AccessibilityEvent.getRecord()เพื่อดึงข้อมูลAccessibilityRecordที่เฉพาะเจาะจง (อาจมีระเบียนหลายรายการแนบมากับเหตุการณ์) - คุณสามารถเรียก
getSource()จากAccessibilityEventหรือAccessibilityRecordแต่ละรายการเพื่อดึงข้อมูลออบเจ็กต์AccessibilityNodeInfoได้AccessibilityNodeInfoแสดงถึงโหนดเดียวของเนื้อหาหน้าต่างในรูปแบบที่ช่วยให้คุณค้นหาข้อมูลการช่วยเหลือพิเศษเกี่ยวกับโหนดนั้นได้ ออบเจ็กต์AccessibilityNodeInfoที่แสดงผลจากAccessibilityEventจะอธิบายแหล่งที่มาของเหตุการณ์ ส่วนแหล่งที่มาจากAccessibilityRecordจะอธิบายแหล่งที่มาของเหตุการณ์ก่อนหน้า - เมื่อใช้
AccessibilityNodeInfoคุณจะค้นหาข้อมูลเกี่ยวกับโหนดดังกล่าวได้ โดยเรียกใช้getParent()หรือgetChild()เพื่อไปยังส่วนต่างๆ ของลำดับชั้นการแสดงผล และยังเพิ่มหน้าจอสำหรับเด็กไปยังโหนดได้ด้วย
เพื่อให้แอปพลิเคชันของคุณเผยแพร่ตัวเองไปยังระบบเป็นบริการการช่วยเหลือพิเศษ แอปพลิเคชันต้องประกาศไฟล์การกำหนดค่า XML ที่สอดคล้องกับ AccessibilityServiceInfo ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างบริการการช่วยเหลือพิเศษได้ที่ AccessibilityService และดูข้อมูลเกี่ยวกับการกำหนดค่า XML ได้ที่ SERVICE_META_DATA
Accessibility API อื่นๆ
หากสนใจสถานะการช่วยเหลือพิเศษของอุปกรณ์ AccessibilityManager มี API ใหม่บางรายการ เช่น
AccessibilityManager.AccessibilityStateChangeListenerเป็นอินเทอร์เฟซที่ช่วยให้คุณได้รับ Callback เมื่อใดก็ตามที่มีการเปิดหรือปิดใช้การช่วยเหลือพิเศษgetEnabledAccessibilityServiceList()ให้ข้อมูลเกี่ยวกับบริการการช่วยเหลือพิเศษที่เปิดใช้อยู่ในปัจจุบันisTouchExplorationEnabled()จะบอกคุณว่าเปิดใช้โหมดแตะเพื่อสำรวจอยู่หรือไม่
บริการโปรแกรมตรวจตัวสะกด
เฟรมเวิร์กโปรแกรมตรวจตัวสะกดใหม่ช่วยให้แอปสร้างโปรแกรมตรวจตัวสะกดในลักษณะที่คล้ายกับเฟรมเวิร์กวิธีการป้อนข้อมูล (สำหรับ IME) หากต้องการสร้างโปรแกรมตรวจตัวสะกดใหม่ คุณต้องใช้บริการที่ขยาย SpellCheckerService และขยายคลาส SpellCheckerService.Session เพื่อให้คำแนะนำการสะกดคำตามข้อความที่ได้จากเมธอด Callback ของอินเทอร์เฟซ ในเมธอด Callback SpellCheckerService.Session คุณต้องแสดงผลคำแนะนำการสะกดคำเป็นออบเจ็กต์ SuggestionsInfo
แอปพลิเคชันที่มีบริการตรวจตัวสะกดต้องประกาศสิทธิ์ BIND_TEXT_SERVICE ตามที่บริการกำหนด
นอกจากนี้ บริการต้องประกาศตัวกรอง Intent โดยมี <action
android:name="android.service.textservice.SpellCheckerService" /> เป็นการดำเนินการของ Intent และควรมีองค์ประกอบ <meta-data> ที่ประกาศข้อมูลการกำหนดค่าสำหรับโปรแกรมตรวจตัวสะกด
ดูโค้ดตัวอย่างได้ที่แอปบริการตรวจตัวสะกดและแอปไคลเอ็นต์ตรวจตัวสะกดตัวอย่าง
เครื่องมืออ่านออกเสียงข้อความ
API การอ่านออกเสียงข้อความ (TTS) ของ Android ได้รับการขยายอย่างมากเพื่อให้แอปพลิเคชันติดตั้งใช้งานเครื่องมือ TTS ที่กำหนดเองได้ง่ายขึ้น ขณะที่แอปพลิเคชันที่ต้องการใช้เครื่องมือ TTS มี API ใหม่ 2 รายการสำหรับการเลือกเครื่องมือ
การใช้เครื่องมืออ่านออกเสียงข้อความ
ใน Android เวอร์ชันก่อนหน้า คุณสามารถใช้คลาส TextToSpeech เพื่อดำเนินการอ่านออกเสียงข้อความ (TTS) โดยใช้เครื่องมือ TTS ที่ระบบมีให้ หรือตั้งค่าเครื่องมือที่กำหนดเองโดยใช้ setEngineByPackageName() ใน Android 4.0 เมธอด setEngineByPackageName() เลิกใช้งานแล้ว และตอนนี้คุณสามารถระบุเครื่องมือที่จะใช้กับคอนสตรัคเตอร์ TextToSpeech ใหม่ที่ยอมรับชื่อแพ็กเกจของเครื่องมือ TTS ได้
นอกจากนี้ คุณยังค้นหาเครื่องมือ TTS ที่พร้อมใช้งานด้วย getEngines() ได้ด้วย เมธอดนี้จะแสดงรายการออบเจ็กต์ TextToSpeech.EngineInfo ซึ่งรวมถึงข้อมูลเมตา เช่น ไอคอน ป้ายกำกับ และชื่อแพ็กเกจของเครื่องมือ
การสร้างเครื่องมืออ่านออกเสียงข้อความ
ก่อนหน้านี้ เครื่องมือที่กำหนดเองกำหนดให้ต้องสร้างเครื่องมือโดยใช้ไฟล์ส่วนหัวแบบเนทีฟที่ไม่มีเอกสารประกอบ ใน Android 4.0 มีชุด API เฟรมเวิร์กที่สมบูรณ์สำหรับการสร้างเครื่องมือ TTS
การตั้งค่าพื้นฐานต้องมีการติดตั้งใช้งาน TextToSpeechService ที่ตอบสนองต่อ Intent INTENT_ACTION_TTS_SERVICE งานหลักของเครื่องมือ TTS จะเกิดขึ้นระหว่างการเรียกกลับ onSynthesizeText() ในบริการที่ขยาย TextToSpeechService ระบบจะส่งออบเจ็กต์ 2 รายการให้กับเมธอดนี้ ดังนี้
SynthesisRequest: ประกอบด้วยข้อมูลต่างๆ รวมถึงข้อความที่จะสังเคราะห์ ภาษา ความเร็วในการพูด และระดับเสียงพูดSynthesisCallback: นี่คืออินเทอร์เฟซที่เครื่องมือ TTS ใช้ส่งข้อมูลเสียงพูดที่ได้เป็นเสียงสตรีมมิง ก่อนอื่น เครื่องมือต้องเรียกใช้start()เพื่อระบุว่าเครื่องมือพร้อมที่จะส่งเสียง จากนั้นจึงเรียกใช้audioAvailable()โดยส่งข้อมูลเสียงในบัฟเฟอร์ไบต์ เมื่อเครื่องมือส่งผ่านเสียงทั้งหมดผ่านบัฟเฟอร์แล้ว ให้เรียกใช้done()
ตอนนี้เฟรมเวิร์กดังกล่าวรองรับ API ที่แท้จริงสำหรับการสร้างเครื่องมือ TTS แล้ว เราจึงนำการรองรับการใช้งานโค้ดแบบเนทีฟออก มองหาบล็อกโพสต์เกี่ยวกับเลเยอร์ความเข้ากันได้ที่คุณสามารถใช้เพื่อแปลงเครื่องมือ TTS เก่าเป็นเฟรมเวิร์กใหม่
ดูตัวอย่างเครื่องมือ TTS ที่ใช้ API ใหม่ได้ที่แอปตัวอย่างเครื่องมืออ่านออกเสียงข้อความ
การใช้เครือข่าย
Android 4.0 ช่วยให้ผู้ใช้เห็นปริมาณข้อมูลเครือข่ายที่แอปพลิเคชันใช้ได้อย่างแม่นยำ แอปการตั้งค่ามีการควบคุมที่ช่วยให้ผู้ใช้จัดการขีดจำกัดที่ตั้งไว้สำหรับการใช้งานอินเทอร์เน็ตมือถือ และปิดใช้การใช้อินเทอร์เน็ตในเบื้องหลังสำหรับแต่ละแอปได้ เพื่อหลีกเลี่ยงไม่ให้ผู้ใช้ปิดใช้สิทธิ์เข้าถึงข้อมูลของแอปจากเบื้องหลัง คุณควรพัฒนากลยุทธ์เพื่อใช้การเชื่อมต่ออินเทอร์เน็ตอย่างมีประสิทธิภาพและปรับการใช้งานตามประเภทการเชื่อมต่อที่พร้อมใช้งาน
หากแอปพลิเคชันของคุณทำธุรกรรมผ่านเครือข่ายจำนวนมาก คุณควรให้การตั้งค่าผู้ใช้ที่อนุญาตให้ผู้ใช้ควบคุมพฤติกรรมการใช้ข้อมูลของแอป เช่น ความถี่ที่แอปซิงค์ข้อมูล จะอัปโหลด/ดาวน์โหลดเฉพาะเมื่อใช้ Wi-Fi หรือไม่ จะใช้ข้อมูลขณะโรมมิ่งหรือไม่ เป็นต้น เมื่อมีการควบคุมเหล่านี้ ผู้ใช้จะมีโอกาสน้อยลงมากที่จะปิดใช้การเข้าถึงข้อมูลของแอปเมื่อใกล้ถึงขีดจำกัด เนื่องจากสามารถควบคุมปริมาณข้อมูลที่แอปใช้ได้อย่างแม่นยำแทน
หากคุณระบุกิจกรรมการตั้งค่าด้วยการตั้งค่าเหล่านี้ คุณควรใส่ตัวกรอง Intent สำหรับการดำเนินการ ACTION_MANAGE_NETWORK_USAGE ไว้ในการประกาศไฟล์ Manifest เช่น
<activity android:name="DataPreferences" android:label="@string/title_preferences"> <intent-filter> <action android:name="android.intent.action.MANAGE_NETWORK_USAGE" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
ตัวกรอง Intent นี้จะระบุให้ระบบทราบว่านี่คือกิจกรรมที่ควบคุมปริมาณการใช้อินเทอร์เน็ตของแอปพลิเคชัน ดังนั้น เมื่อผู้ใช้ตรวจสอบปริมาณข้อมูลที่แอปของคุณใช้จากแอปการตั้งค่า จะมีปุ่ม "ดูการตั้งค่าแอปพลิเคชัน" ที่เปิดกิจกรรมการตั้งค่าเพื่อให้ผู้ใช้ปรับแต่งปริมาณข้อมูลที่แอปของคุณใช้ได้
นอกจากนี้ โปรดทราบว่าตอนนี้ getBackgroundDataSetting() เลิกใช้งานแล้วและจะแสดงผลเป็น "จริง" เสมอ ให้ใช้ getActiveNetworkInfo() แทน ก่อนที่จะพยายามทำธุรกรรมเครือข่ายใดๆ คุณควรเรียกใช้ getActiveNetworkInfo() เพื่อรับ NetworkInfo ที่แสดงถึงเครือข่ายปัจจุบันและค้นหา isConnected() เพื่อตรวจสอบว่าอุปกรณ์มีการเชื่อมต่อหรือไม่เสมอ จากนั้นคุณจะตรวจสอบคุณสมบัติการเชื่อมต่ออื่นๆ ได้ เช่น อุปกรณ์กำลังโรมมิ่งหรือเชื่อมต่อกับ Wi-Fi อยู่หรือไม่
องค์กร
Android 4.0 ขยายขีดความสามารถของแอปพลิเคชันสำหรับองค์กรด้วยฟีเจอร์ต่อไปนี้
บริการ VPN
VpnService ใหม่ช่วยให้แอปพลิเคชันสร้าง VPN (Virtual Private Network) ของตนเองได้ โดยทำงานเป็นService บริการ VPN จะสร้างอินเทอร์เฟซสำหรับเครือข่ายเสมือนที่มีกฎการกำหนดเส้นทางและที่อยู่ของตัวเอง และดำเนินการอ่านและเขียนทั้งหมดด้วยตัวบอกไฟล์
หากต้องการสร้างบริการ VPN ให้ใช้ VpnService.Builder ซึ่งช่วยให้คุณระบุที่อยู่เครือข่าย, เซิร์ฟเวอร์ DNS, เส้นทางเครือข่าย และอื่นๆ ได้ เมื่อเสร็จแล้ว คุณจะสร้างอินเทอร์เฟซได้โดยเรียกใช้ establish() ซึ่งจะแสดงผล ParcelFileDescriptor
เนื่องจากบริการ VPN สามารถสกัดกั้นแพ็กเก็ตได้ จึงอาจส่งผลกระทบด้านความปลอดภัย ดังนั้น หากคุณใช้ VpnService บริการของคุณต้องกำหนดให้ใช้ BIND_VPN_SERVICE เพื่อให้มั่นใจว่ามีเพียงระบบเท่านั้นที่เชื่อมโยงกับบริการได้ (มีเพียงระบบเท่านั้นที่ได้รับสิทธิ์นี้ แอปจะขอสิทธิ์นี้ไม่ได้) จากนั้นหากต้องการใช้บริการ VPN ผู้ใช้ต้องเปิดใช้ด้วยตนเองในการตั้งค่าระบบ
นโยบายด้านอุปกรณ์
ตอนนี้แอปพลิเคชันที่จัดการข้อจำกัดของอุปกรณ์สามารถปิดใช้กล้องได้โดยใช้ setCameraDisabled() และพร็อพเพอร์ตี้ USES_POLICY_DISABLE_CAMERA (ใช้กับองค์ประกอบ <disable-camera /> ในไฟล์การกำหนดค่านโยบาย)
การจัดการใบรับรอง
คลาส KeyChain ใหม่มี API ที่ช่วยให้คุณนำเข้าและเข้าถึงใบรับรองในคีย์สโตร์ของระบบได้ ใบรับรองช่วยให้การติดตั้งทั้งใบรับรองไคลเอ็นต์ (เพื่อตรวจสอบตัวตนของผู้ใช้) และใบรับรองของผู้ออกใบรับรอง (เพื่อยืนยันตัวตนของเซิร์ฟเวอร์) มีประสิทธิภาพมากขึ้น แอปพลิเคชันต่างๆ เช่น เว็บเบราว์เซอร์หรือโปรแกรมรับส่งอีเมล จะเข้าถึงใบรับรองที่ติดตั้งไว้เพื่อตรวจสอบสิทธิ์ผู้ใช้กับเซิร์ฟเวอร์ได้ ดูข้อมูลเพิ่มเติมในเอกสารประกอบของ KeyChain
เซ็นเซอร์ของอุปกรณ์
มีการเพิ่มเซ็นเซอร์ประเภทใหม่ 2 ประเภทใน Android 4.0 ดังนี้
TYPE_AMBIENT_TEMPERATURE: เซ็นเซอร์อุณหภูมิที่แสดงอุณหภูมิแวดล้อม (ห้อง) เป็นองศาเซลเซียสTYPE_RELATIVE_HUMIDITY: เซ็นเซอร์วัดความชื้นที่แสดงความชื้นสัมพัทธ์ของสภาพแวดล้อม (ห้อง) เป็นเปอร์เซ็นต์
หากอุปกรณ์มีทั้งเซ็นเซอร์ TYPE_AMBIENT_TEMPERATURE และ TYPE_RELATIVE_HUMIDITY คุณสามารถใช้เซ็นเซอร์เหล่านี้เพื่อคำนวณจุดน้ำค้างและความชื้นสัมบูรณ์ได้
เซ็นเซอร์อุณหภูมิก่อนหน้า TYPE_TEMPERATURE เลิกใช้งานแล้ว คุณควรใช้เซ็นเซอร์ TYPE_AMBIENT_TEMPERATURE แทน
นอกจากนี้ เซ็นเซอร์สังเคราะห์ทั้ง 3 ตัวของ Android ยังได้รับการปรับปรุงอย่างมากเพื่อให้มีเวลาในการตอบสนองที่ต่ำลงและเอาต์พุตที่ราบรื่นยิ่งขึ้น เซ็นเซอร์เหล่านี้รวมถึงเซ็นเซอร์แรงโน้มถ่วง (TYPE_GRAVITY) เซ็นเซอร์เวกเตอร์การหมุน (TYPE_ROTATION_VECTOR) และเซ็นเซอร์ความเร่งเชิงเส้น (TYPE_LINEAR_ACCELERATION) เซ็นเซอร์ที่ได้รับการปรับปรุงจะอาศัยเซ็นเซอร์เครื่องวัดการหมุนเพื่อปรับปรุงเอาต์พุต ดังนั้นเซ็นเซอร์จะปรากฏเฉพาะในอุปกรณ์ที่มีเครื่องวัดการหมุนเท่านั้น
แถบการดำเนินการ
ActionBar ได้รับการอัปเดตเพื่อรองรับลักษณะการทำงานใหม่ๆ หลายอย่าง ที่สำคัญที่สุดคือ ระบบจะจัดการขนาดและการกำหนดค่าของแถบการดำเนินการอย่างเหมาะสมเมื่อทำงานบนหน้าจอขนาดเล็ก เพื่อมอบประสบการณ์ของผู้ใช้ที่ดีที่สุดในหน้าจอทุกขนาด ตัวอย่างเช่น เมื่อหน้าจอแคบ (เช่น เมื่อโทรศัพท์อยู่ในแนวตั้ง) แท็บการนำทางของแถบการดำเนินการจะปรากฏใน "แถบซ้อน" ซึ่งจะปรากฏใต้แถบการดำเนินการหลักโดยตรง นอกจากนี้ คุณยังเลือกใช้ "แถบการดำเนินการแบบแยก" ได้ด้วย ซึ่งจะวางรายการการดำเนินการทั้งหมดไว้ในแถบแยกต่างหากที่ด้านล่างของหน้าจอเมื่อหน้าจอแคบ
แถบการดำเนินการแบบแยก
หากแถบการดำเนินการมีรายการการดำเนินการหลายรายการ รายการทั้งหมดอาจไม่พอดีกับแถบการดำเนินการบนหน้าจอแคบ ระบบจึงจะวางรายการเพิ่มเติมไว้ในเมนูรายการเพิ่มเติม อย่างไรก็ตาม Android 4.0 ช่วยให้คุณเปิดใช้ "แถบการดำเนินการแยก" เพื่อให้รายการการดำเนินการอื่นๆ ปรากฏบนหน้าจอในแถบแยกต่างหากที่ด้านล่างของหน้าจอได้ หากต้องการเปิดใช้แถบการดำเนินการแบบแยก ให้เพิ่ม android:uiOptions ที่มี "splitActionBarWhenNarrow" ลงในแท็ก <application> หรือแท็ก <activity> แต่ละแท็กในไฟล์ Manifest เมื่อเปิดใช้ ระบบจะเพิ่มแถบเพิ่มเติมที่ด้านล่างของหน้าจอสำหรับรายการการดำเนินการทั้งหมดเมื่อหน้าจอแคบ (จะไม่มีรายการการดำเนินการปรากฏในแถบการดำเนินการหลัก)
หากต้องการใช้แท็บการนำทางที่ได้จาก ActionBar.Tab API แต่ไม่ต้องการแถบการดำเนินการหลักที่ด้านบน (คุณต้องการให้แท็บปรากฏที่ด้านบนเท่านั้น) ให้เปิดใช้แถบการดำเนินการแบบแยกตามที่อธิบายไว้ด้านบน และเรียกใช้ setDisplayShowHomeEnabled(false) เพื่อปิดใช้ไอคอนแอปพลิเคชันในแถบการดำเนินการ เมื่อไม่มีอะไรเหลืออยู่ในแถบการดำเนินการหลัก แถบดังกล่าวจะหายไป เหลือเพียงแท็บการนำทางที่ด้านบนและรายการการดำเนินการที่ด้านล่างของหน้าจอ
รูปแบบแถบการดำเนินการ
หากต้องการใช้การจัดรูปแบบที่กำหนดเองกับแถบการดำเนินการ คุณสามารถใช้พร็อพเพอร์ตี้รูปแบบใหม่ backgroundStacked และ backgroundSplit เพื่อใช้พื้นหลังที่วาดได้หรือสีกับแถบแบบซ้อนและแถบแยกตามลำดับ นอกจากนี้ คุณยังตั้งค่าสไตล์เหล่านี้ได้ที่รันไทม์ด้วย setStackedBackgroundDrawable() และ setSplitBackgroundDrawable()
ผู้ให้บริการการดำเนินการ
คลาส ActionProvider ใหม่ช่วยให้คุณสร้างเครื่องมือจัดการเฉพาะสำหรับรายการการทำงานได้ ผู้ให้บริการการดำเนินการสามารถกำหนดมุมมองการดำเนินการ ลักษณะการทำงานเริ่มต้น และเมนูย่อยสำหรับรายการการดำเนินการแต่ละรายการที่เชื่อมโยงได้ เมื่อต้องการสร้างรายการการทำงานที่มีลักษณะการทำงานแบบไดนามิก (เช่น มุมมองการทำงานแบบแปรผัน การทำงานเริ่มต้น หรือเมนูย่อย) การขยาย ActionProvider เป็นโซลูชันที่ดีในการสร้างคอมโพเนนต์ที่นำกลับมาใช้ใหม่ได้ แทนที่จะจัดการการเปลี่ยนรูปแบบรายการการทำงานต่างๆ ใน Fragment หรือกิจกรรม
ตัวอย่างเช่น ShareActionProvider เป็นส่วนขยายของ ActionProvider ที่ช่วยให้ดำเนินการ "แชร์" จากแถบการดำเนินการได้ คุณสามารถ
ใช้ผู้ให้บริการการดำเนินการนี้เพื่อแสดงมุมมองการดำเนินการพร้อมรายการแอปพลิเคชันแบบเลื่อนลงที่จัดการ
Intent ACTION_SEND แทนการใช้
รายการการดำเนินการแบบเดิมที่เรียกใช้ Intent ACTION_SEND เมื่อผู้ใช้เลือกแอปพลิเคชันที่จะใช้สำหรับการดำเนินการ ShareActionProvider จะจดจำตัวเลือกนั้นและแสดงไว้ในมุมมองการดำเนินการเพื่อให้เข้าถึงการแชร์กับแอปนั้นได้เร็วขึ้น
หากต้องการประกาศผู้ให้บริการการดำเนินการสำหรับรายการการดำเนินการ ให้ใส่แอตทริบิวต์ android:actionProviderClass ในองค์ประกอบ <item> สำหรับเมนูตัวเลือกของกิจกรรม โดยใช้ชื่อคลาสของผู้ให้บริการการดำเนินการเป็นค่า เช่น
<item android:id="@+id/menu_share"
android:title="Share"
android:showAsAction="ifRoom"
android:actionProviderClass="android.widget.ShareActionProvider" />ในเมธอด Callback onCreateOptionsMenu() ของกิจกรรม ให้ดึงข้อมูลอินสแตนซ์ของผู้ให้บริการการดำเนินการจากรายการในเมนูและตั้งค่า Intent ดังนี้
Kotlin
override fun onCreateOptionsMenu(menu: Menu): Boolean { menuInflater.inflate(R.menu.options, menu) val shareActionProvider = menu.findItem(R.id.menu_share)?.actionProvider as? ShareActionProvider // Set the share intent of the share action provider. shareActionProvider?.setShareIntent(createShareIntent()) ... return super.onCreateOptionsMenu(menu) }
Java
public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.options, menu); ShareActionProvider shareActionProvider = (ShareActionProvider) menu.findItem(R.id.menu_share).getActionProvider(); // Set the share intent of the share action provider. shareActionProvider.setShareIntent(createShareIntent()); ... return super.onCreateOptionsMenu(menu); }
ดูตัวอย่างการใช้ ShareActionProvider ได้ที่ ActionBarShareActionProviderActivity ใน ApiDemos
มุมมองการดำเนินการที่ยุบได้
ตอนนี้รายการการทำงานที่แสดงมุมมองการทำงานสามารถสลับไปมาระหว่างสถานะมุมมองการทำงานและสถานะรายการการทำงานแบบเดิมได้แล้ว ก่อนหน้านี้มีเพียง SearchView เท่านั้นที่รองรับการยุบเมื่อใช้เป็นมุมมองการดำเนินการ แต่ตอนนี้คุณสามารถเพิ่มมุมมองการดำเนินการสำหรับรายการการดำเนินการใดก็ได้ และสลับระหว่างสถานะขยาย (มุมมองการดำเนินการปรากฏ) และสถานะยุบ (รายการการดำเนินการปรากฏ)
หากต้องการประกาศว่ารายการการทำงานที่มีมุมมองการทำงานสามารถยุบได้ ให้ใส่แฟล็ก "collapseActionView" ในแอตทริบิวต์ android:showAsAction สำหรับองค์ประกอบ <item> ในไฟล์ XML ของเมนู
หากต้องการรับ Callback เมื่อมุมมองการดำเนินการสลับระหว่างขยายและยุบ ให้ลงทะเบียนอินสแตนซ์ของ MenuItem.OnActionExpandListener กับ MenuItem ที่เกี่ยวข้องโดยเรียกใช้ setOnActionExpandListener() โดยปกติแล้ว คุณควรดำเนินการดังกล่าวในระหว่างการเรียกกลับ onCreateOptionsMenu()
หากต้องการควบคุมมุมมองการดำเนินการที่ยุบได้ คุณสามารถเรียกใช้ collapseActionView() และ expandActionView() ใน MenuItem ที่เกี่ยวข้องได้
เมื่อสร้างมุมมองการดำเนินการที่กำหนดเอง คุณยังสามารถใช้อินเทอร์เฟซ CollapsibleActionView ใหม่เพื่อรับ Callback เมื่อมุมมองขยายและยุบได้ด้วย
API อื่นๆ สำหรับแถบการดำเนินการ
setHomeButtonEnabled()ช่วยให้คุณระบุได้ว่าไอคอน/โลโก้จะทำหน้าที่เป็นปุ่มเพื่อไปยังหน้าแรกหรือ "ขึ้น" (ส่ง "true" เพื่อให้ทำหน้าที่เป็นปุ่ม)setIcon()และsetLogo()ช่วยให้คุณกำหนดไอคอนหรือโลโก้ของแถบการดำเนินการได้ที่รันไทม์Fragment.setMenuVisibility()ช่วยให้คุณเปิดหรือปิดใช้ระดับการมองเห็นของรายการเมนูตัวเลือกที่ประกาศโดย Fragment ได้ ซึ่งจะเป็นประโยชน์ในกรณีที่มีการเพิ่ม Fragment ลงในกิจกรรม แต่ไม่ปรากฏให้เห็น ดังนั้นจึงควรซ่อนรายการเมนูFragmentManager.invalidateOptionsMenu()ช่วยให้คุณทำให้เมนูตัวเลือกกิจกรรมใช้งานไม่ได้ในสถานะต่างๆ ของวงจร Fragment ซึ่งอาจใช้เมธอดที่เทียบเท่าจากActivityไม่ได้
อินเทอร์เฟซผู้ใช้และมุมมอง
Android 4.0 เปิดตัวมุมมองใหม่ๆ และคอมโพเนนต์ UI อื่นๆ ที่หลากหลาย
GridLayout
GridLayout เป็นกลุ่มการแสดงผลใหม่ที่วางหน้าจอสำหรับเด็กในตารางกริดสี่เหลี่ยมผืนผ้า GridLayout ต่างจาก TableLayout ตรงที่ใช้ลำดับชั้นแบบแบนราบและไม่ใช้มุมมองระดับกลาง เช่น แถวตาราง เพื่อสร้างโครงสร้าง
แต่จะระบุแถวและคอลัมน์ที่ควรใช้แทน (เซลล์สามารถครอบคลุมหลายแถวและ/หรือคอลัมน์) และโดยค่าเริ่มต้นจะจัดวางตามลำดับในแถวและคอลัมน์ของตารางกริด
การวางแนว GridLayout จะกำหนดว่าองค์ประกอบย่อยที่ต่อเนื่องกันจะจัดวางในแนวนอนหรือแนวตั้งโดยค่าเริ่มต้น คุณสามารถระบุระยะห่างระหว่างองค์ประกอบย่อยได้โดยใช้อินสแตนซ์ของมุมมอง Space ใหม่ หรือโดยการตั้งค่าพารามิเตอร์ระยะขอบที่เกี่ยวข้องในองค์ประกอบย่อย
ดูตัวอย่างการใช้ GridLayout ได้ที่ ApiDemos
TextureView
TextureView เป็นมุมมองใหม่ที่ช่วยให้คุณแสดงสตรีมเนื้อหา เช่น วิดีโอหรือฉาก OpenGL ได้ TextureView มีลักษณะคล้ายกับ SurfaceView แต่มีความโดดเด่นตรงที่ทำงานเหมือนมุมมองปกติ แทนที่จะสร้างหน้าต่างแยกต่างหาก คุณจึงจัดการกับมุมมองนี้ได้เหมือนกับออบเจ็กต์ View อื่นๆ เช่น คุณสามารถใช้การเปลี่ยนรูปแบบ สร้างภาพเคลื่อนไหวโดยใช้ ViewPropertyAnimator หรือปรับความทึบแสงด้วย setAlpha()
โปรดทราบว่า TextureView จะทำงานภายในหน้าต่างที่มีการเร่งฮาร์ดแวร์เท่านั้น
ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ TextureView
วิดเจ็ตสวิตช์
วิดเจ็ต Switch ใหม่เป็นปุ่มเปิด/ปิด 2 สถานะที่ผู้ใช้สามารถลากไปด้านใดด้านหนึ่ง (หรือเพียงแค่แตะ) เพื่อสลับตัวเลือกระหว่าง 2 สถานะ
คุณสามารถใช้แอตทริบิวต์ android:textOn และ android:textOff เพื่อระบุข้อความที่จะปรากฏบนสวิตช์เมื่ออยู่ในการตั้งค่าเปิดและปิด แอตทริบิวต์ android:text ยังช่วยให้คุณวางป้ายกำกับไว้ข้างสวิตช์ได้ด้วย
ดูตัวอย่างการใช้สวิตช์ได้ที่ไฟล์เลย์เอาต์ switches.xml และกิจกรรม Switches ที่เกี่ยวข้อง
เมนูป๊อปอัป
Android 3.0 เปิดตัว PopupMenu เพื่อสร้างเมนูตามบริบทแบบสั้นๆ ที่ปรากฏขึ้นที่จุดยึดที่คุณระบุ (โดยปกติจะอยู่ที่จุดของรายการที่เลือก) Android 4.0 ขยายPopupMenuด้วยฟีเจอร์ที่มีประโยชน์ 2 อย่าง ได้แก่
- ตอนนี้คุณสามารถขยายเนื้อหาของเมนูป๊อปอัปจากทรัพยากรเมนู XML ได้อย่างง่ายดายด้วย
inflate()โดยส่งรหัสทรัพยากรเมนู - นอกจากนี้ คุณยังสร้าง
PopupMenu.OnDismissListenerที่รับ Callback เมื่อปิดเมนูได้แล้ว
ค่ากำหนด
คลาสแอบสแตรกต์ TwoStatePreference ใหม่ทำหน้าที่เป็นพื้นฐานสำหรับการตั้งค่าที่ให้ตัวเลือกการเลือก 2 สถานะ SwitchPreference ใหม่เป็นส่วนขยายของ TwoStatePreference ที่มีวิดเจ็ต Switch ในมุมมองค่ากำหนดเพื่อให้ผู้ใช้เปิดหรือปิดการตั้งค่าได้โดยไม่ต้องเปิดหน้าจอหรือกล่องโต้ตอบค่ากำหนดเพิ่มเติม ตัวอย่างเช่น แอปพลิเคชันการตั้งค่าใช้ SwitchPreference สำหรับการตั้งค่า Wi-Fi และบลูทูธ
ธีมของระบบ
ธีมเริ่มต้นสำหรับแอปพลิเคชันทั้งหมดที่กำหนดเป้าหมายเป็น Android 4.0 (โดยการตั้งค่า targetSdkVersion หรือ minSdkVersion เป็น "14" ขึ้นไป) ตอนนี้เป็นธีม "ค่าเริ่มต้นของอุปกรณ์" ซึ่งก็คือ Theme.DeviceDefault ซึ่งอาจเป็นธีม Holo มืดหรือธีมมืดอื่นๆ ที่กำหนดโดยอุปกรณ์นั้นๆ
ธีมตระกูล Theme.Holo จะไม่เปลี่ยนแปลงจากอุปกรณ์หนึ่งไปยังอีกอุปกรณ์หนึ่งเมื่อใช้ Android เวอร์ชันเดียวกัน หากคุณใช้ธีม Theme.Holo กับกิจกรรมอย่างชัดเจน ก็มั่นใจได้ว่าธีมเหล่านี้จะไม่เปลี่ยนลักษณะในอุปกรณ์ต่างๆ ภายในแพลตฟอร์มเวอร์ชันเดียวกัน
หากต้องการให้แอปกลมกลืนกับธีมโดยรวมของอุปกรณ์ (เช่น เมื่อ OEM ต่างๆ มีธีมเริ่มต้นที่แตกต่างกันสำหรับระบบ) คุณควรใช้ธีมจากตระกูล Theme.DeviceDefault อย่างชัดเจน
ปุ่มเมนูตัวเลือก
ตั้งแต่ Android 4.0 เป็นต้นไป คุณจะสังเกตเห็นว่าโทรศัพท์มือถือไม่จำเป็นต้องมีปุ่มกดเมนูอีกต่อไป อย่างไรก็ตาม คุณไม่จำเป็นต้องกังวลเกี่ยวกับเรื่องนี้หากแอปพลิเคชันที่มีอยู่มีเมนูตัวเลือกและคาดว่าจะมีปุ่มเมนู ระบบจะมีปุ่มเมนูบนหน้าจอสำหรับแอปที่ออกแบบมาสำหรับ Android เวอร์ชันเก่า เพื่อให้มั่นใจว่าแอปที่มีอยู่จะยังคงทำงานได้ตามที่คาดหวัง
เพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดีที่สุด แอปใหม่และแอปที่อัปเดตควรใช้ ActionBar แทนเพื่อให้สิทธิ์เข้าถึงรายการเมนูและตั้งค่า targetSdkVersion เป็น "14" เพื่อใช้ประโยชน์จากลักษณะการทำงานเริ่มต้นของเฟรมเวิร์กล่าสุด
การควบคุมการแสดง UI ของระบบ
ตั้งแต่ช่วงแรกๆ ของ Android ระบบได้จัดการคอมโพเนนต์ UI ที่เรียกว่าแถบสถานะ ซึ่งอยู่ที่ด้านบนของอุปกรณ์โทรศัพท์เพื่อแสดงข้อมูล เช่น สัญญาณของผู้ให้บริการ เวลา และการแจ้งเตือน Android 3.0 เพิ่มแถบระบบสำหรับอุปกรณ์แท็บเล็ต ซึ่งอยู่ที่ด้านล่างของหน้าจอเพื่อแสดงการควบคุมการนำทางของระบบ (เช่น หน้าแรกและย้อนกลับ) รวมถึงอินเทอร์เฟซสำหรับองค์ประกอบที่แถบสถานะมีให้ตามปกติ ใน Android 4.0 ระบบจะมี UI ของระบบประเภทใหม่ที่เรียกว่าแถบนำทาง คุณอาจมองว่าแถบนำทางเป็นแถบระบบเวอร์ชันที่ปรับแต่งใหม่ซึ่งออกแบบมาสำหรับโทรศัพท์มือถือ โดยมีตัวควบคุมการนำทางสำหรับอุปกรณ์ที่ไม่มีฮาร์ดแวร์ที่เทียบเท่าสำหรับการนำทางในระบบ แต่จะไม่มี UI การแจ้งเตือนและตัวควบคุมการตั้งค่าของแถบระบบ ดังนั้น อุปกรณ์ที่มีแถบการนำทางก็จะมีแถบสถานะที่ด้านบนด้วย
จนถึงทุกวันนี้ คุณสามารถซ่อนแถบสถานะในโทรศัพท์มือถือได้โดยใช้แฟล็ก FLAG_FULLSCREEN ใน Android 4.0, API ที่ควบคุมการแสดงผลของแถบระบบได้รับการอัปเดตเพื่อให้สอดคล้องกับลักษณะการทำงานของทั้งแถบระบบและแถบการนำทางได้ดียิ่งขึ้น
- แฟล็ก
SYSTEM_UI_FLAG_LOW_PROFILEจะแทนที่แฟล็กSTATUS_BAR_HIDDENเมื่อตั้งค่าแล้ว แฟล็กนี้จะเปิดใช้โหมด "โปรไฟล์ต่ำ" สำหรับแถบระบบหรือแถบการนำทาง ปุ่มการนำทางจะหรี่แสงลงและองค์ประกอบอื่นๆ ในแถบระบบจะซ่อนด้วย การเปิดใช้ฟีเจอร์นี้มีประโยชน์สำหรับการสร้างเกมที่สมจริงยิ่งขึ้นโดยไม่มีการรบกวนจากปุ่มการไปยังส่วนต่างๆ ของระบบ - แฟล็ก
SYSTEM_UI_FLAG_VISIBLEจะแทนที่แฟล็กSTATUS_BAR_VISIBLEเพื่อขอให้แถบระบบหรือแถบนำทางแสดงขึ้น SYSTEM_UI_FLAG_HIDE_NAVIGATIONเป็นแฟล็กใหม่ที่ขอให้ซ่อนแถบนำทางโดยสมบูรณ์ โปรดทราบว่าวิธีนี้ใช้ได้กับแถบนำทางที่โทรศัพท์มือถือบางรุ่นใช้เท่านั้น (วิธีนี้ไม่ซ่อนแถบระบบในแท็บเล็ต) แถบนำทางจะกลับมาแสดงทันทีที่ระบบได้รับอินพุตจากผู้ใช้ ดังนั้น โหมดนี้จึงมีประโยชน์สำหรับการเล่นวิดีโอหรือกรณีอื่นๆ ที่จำเป็นต้องใช้ทั้งหน้าจอ แต่ไม่จำเป็นต้องมีการป้อนข้อมูลจากผู้ใช้
คุณตั้งค่าแต่ละแฟล็กเหล่านี้สำหรับแถบระบบและแถบการนำทางได้โดยเรียกใช้ setSystemUiVisibility() ในมุมมองใดก็ได้ในกิจกรรม ตัวจัดการหน้าต่างจะรวม (OR-together) แฟล็กทั้งหมดจากทุกมุมมองในหน้าต่างและใช้แฟล็กเหล่านั้นกับ UI ของระบบตราบใดที่หน้าต่างของคุณมีโฟกัสอินพุต เมื่อหน้าต่างของคุณสูญเสียโฟกัสอินพุต (ผู้ใช้ออกจากแอปของคุณหรือกล่องโต้ตอบปรากฏขึ้น) แฟล็กของคุณจะไม่มีผลอีกต่อไป
ในทำนองเดียวกัน หากคุณนำมุมมองเหล่านั้นออกจากลำดับชั้นการแสดงผล แฟล็กของมุมมองเหล่านั้นจะไม่มีผลอีกต่อไป
หากต้องการซิงค์เหตุการณ์อื่นๆ ในกิจกรรมกับการเปลี่ยนแปลงระดับการเข้าถึง UI ของระบบ (เช่น ซ่อนแถบการดำเนินการหรือตัวควบคุม UI อื่นๆ เมื่อ UI ของระบบซ่อน) คุณควรลงทะเบียน View.OnSystemUiVisibilityChangeListener เพื่อรับการแจ้งเตือนเมื่อระดับการเข้าถึงแถบระบบหรือแถบการนำทางเปลี่ยนแปลง
ดูคลาส OverscanActivity เพื่อดูการสาธิตตัวเลือก UI ของระบบต่างๆ
เฟรมเวิร์กอินพุต
Android 4.0 เพิ่มการรองรับเหตุการณ์การวางเคอร์เซอร์เหนือองค์ประกอบ รวมถึงเหตุการณ์สไตลัสและปุ่มเมาส์ใหม่
เหตุการณ์การวางเมาส์เหนือองค์ประกอบ
ตอนนี้คลาส View รองรับเหตุการณ์ "โฮเวอร์" เพื่อให้มีการโต้ตอบที่สมบูรณ์ยิ่งขึ้นผ่านการใช้อุปกรณ์ชี้ตำแหน่ง (เช่น เมาส์หรืออุปกรณ์อื่นๆ ที่ขับเคลื่อนเคอร์เซอร์บนหน้าจอ)
หากต้องการรับเหตุการณ์การวางเมาส์เหนือมุมมอง ให้ใช้ View.OnHoverListener และลงทะเบียนกับ setOnHoverListener() เมื่อเหตุการณ์การวางเมาส์เหนือมุมมองเกิดขึ้น Listener จะได้รับการเรียกใช้ onHover() โดยระบุ View ที่ได้รับเหตุการณ์และ MotionEvent ที่อธิบายประเภทของเหตุการณ์การวางเมาส์เหนือมุมมองที่เกิดขึ้น เหตุการณ์การวางเมาส์เหนืออาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้
View.OnHoverListener ควรแสดงผลเป็น "จริง" จาก onHover() หากจัดการเหตุการณ์การวางเมาส์เหนือ หาก Listener แสดงผลเป็นเท็จ ระบบจะส่งเหตุการณ์การวางเมาส์เหนือไปยังมุมมองหลักตามปกติ
หากแอปพลิเคชันใช้ปุ่มหรือวิดเจ็ตอื่นๆ ที่เปลี่ยนรูปลักษณ์ตามสถานะปัจจุบัน ตอนนี้คุณสามารถใช้แอตทริบิวต์ android:state_hovered ในรายการสถานะที่ถอนออกได้เพื่อแสดงพื้นหลังที่ถอนออกได้แบบอื่นเมื่อเคอร์เซอร์วางเหนือมุมมอง
ดูการสาธิตเหตุการณ์การวางเมาส์เหนือใหม่ได้ที่คลาส Hover ใน ApiDemos
เหตุการณ์ปุ่มสไตลัสและเมาส์
ตอนนี้ Android มี API สำหรับรับอินพุตจากอุปกรณ์อินพุตสไตลัส เช่น อุปกรณ์ต่อพ่วงแท็บเล็ตดิจิไทเซอร์หรือหน้าจอสัมผัสที่รองรับสไตลัส
การป้อนข้อมูลด้วยสไตลัสทำงานในลักษณะคล้ายกับการป้อนข้อมูลด้วยการสัมผัสหรืออินพุตจากเมาส์ เมื่อสไตลัสสัมผัสกับตัวแปลงสัญญาณ แอปพลิเคชันจะได้รับการโต้ตอบแบบสัมผัสเช่นเดียวกับเมื่อใช้นิ้วสัมผัสจอแสดงผล เมื่อสไตลัสวางอยู่เหนือตัวแปลงสัญญาณดิจิทัล แอปพลิเคชันจะได้รับเหตุการณ์การวางเมาส์เหนือเช่นเดียวกับเมื่อมีการเลื่อนเคอร์เซอร์เมาส์ไปทั่วจอแสดงผลเมื่อไม่มีการกดปุ่มใดๆ
แอปพลิเคชันของคุณสามารถแยกความแตกต่างระหว่างการป้อนข้อมูลด้วยนิ้ว เมาส์ สไตลัส และยางลบได้โดยการค้นหา "ประเภทเครื่องมือ" ที่เชื่อมโยงกับตัวชี้แต่ละตัวใน MotionEvent โดยใช้ getToolType() ประเภทเครื่องมือที่กำหนดไว้ในปัจจุบัน ได้แก่ TOOL_TYPE_UNKNOWN, TOOL_TYPE_FINGER, TOOL_TYPE_MOUSE, TOOL_TYPE_STYLUS และ TOOL_TYPE_ERASER เมื่อค้นหาประเภทเครื่องมือ แอปพลิเคชันของคุณจะเลือกจัดการอินพุตจากสไตลัสในลักษณะที่แตกต่างจากอินพุตจากนิ้วหรืออินพุตจากเมาส์ได้
แอปพลิเคชันยังสามารถค้นหาปุ่มเมาส์หรือสไตลัสที่กดได้โดยค้นหา "สถานะปุ่ม" ของ MotionEvent โดยใช้ getButtonState() สถานะปุ่มที่กำหนดไว้ในปัจจุบัน ได้แก่ BUTTON_PRIMARY, BUTTON_SECONDARY, BUTTON_TERTIARY, BUTTON_BACK และ BUTTON_FORWARD เพื่อความสะดวก ปุ่มย้อนกลับและไปข้างหน้าของเมาส์จะแมปกับแป้น KEYCODE_BACK และ KEYCODE_FORWARD โดยอัตโนมัติ แอปพลิเคชันของคุณสามารถจัดการแป้นเหล่านี้เพื่อรองรับการไปยังหน้าก่อนหน้าและหน้าถัดไปโดยใช้ปุ่มเมาส์
นอกจากจะวัดตำแหน่งและแรงกดของการสัมผัสได้อย่างแม่นยำแล้ว อุปกรณ์อินพุตสไตลัสบางรุ่นยังรายงานระยะห่างระหว่างปลายสไตลัสกับตัวแปลงสัญญาณดิจิทัล มุมเอียงของสไตลัส และมุมการวางแนวของสไตลัสด้วย แอปพลิเคชันของคุณสามารถค้นหาข้อมูลนี้ได้โดยใช้ getAxisValue() กับรหัสแกน AXIS_DISTANCE, AXIS_TILT และ AXIS_ORIENTATION
ดูการสาธิตประเภทเครื่องมือ สถานะปุ่ม และรหัสแกนใหม่ได้ที่คลาส TouchPaint ใน ApiDemos
พร็อพเพอร์ตี้
คลาส Property ใหม่ช่วยให้ระบุพร็อพเพอร์ตี้ในออบเจ็กต์ใดก็ได้ที่อนุญาตให้ผู้เรียกตั้งค่า/รับค่าในออบเจ็กต์เป้าหมายได้อย่างรวดเร็ว มีประสิทธิภาพ และง่ายดาย นอกจากนี้ยังช่วยให้ฟังก์ชันการทำงานของการส่งผ่านการอ้างอิงฟิลด์/เมธอด และช่วยให้โค้ดตั้งค่า/รับค่าของพร็อพเพอร์ตี้ได้โดยไม่ต้องทราบรายละเอียดว่าฟิลด์/เมธอดคืออะไร
ตัวอย่างเช่น หากต้องการตั้งค่าของช่อง bar ในออบเจ็กต์ foo ก่อนหน้านี้คุณจะทำดังนี้
Kotlin
foo.bar = value
Java
foo.bar = value;
หากต้องการเรียกใช้ Setter สำหรับฟิลด์ส่วนตัว bar ที่สำคัญ ก่อนหน้านี้คุณจะทำดังนี้
Kotlin
foo.setBar(value)
Java
foo.setBar(value);
อย่างไรก็ตาม หากคุณต้องการส่งต่ออินสแตนซ์ foo และให้โค้ดอื่นๆ ตั้งค่า bar ก็ไม่มีวิธีใดที่จะทำได้ก่อน Android 4.0
เมื่อใช้คลาส Property คุณสามารถประกาศออบเจ็กต์ Property BAR ในคลาส Foo เพื่อให้คุณสามารถตั้งค่าฟิลด์ในอินสแตนซ์ foo ของคลาส Foo ได้ดังนี้
Kotlin
BAR.set(foo, value)
Java
BAR.set(foo, value);
ตอนนี้คลาส View ใช้ประโยชน์จากคลาส Property เพื่อให้คุณตั้งค่าช่องต่างๆ ได้ เช่น พร็อพเพอร์ตี้การเปลี่ยนรูปแบบที่เพิ่มเข้ามาใน Android 3.0 (ROTATION, ROTATION_X, TRANSLATION_X ฯลฯ)
คลาส ObjectAnimator ยังใช้คลาส Property ด้วย คุณจึงสร้าง ObjectAnimator ด้วย Property ได้ ซึ่งรวดเร็ว มีประสิทธิภาพ และปลอดภัยในการกำหนดประเภทมากกว่าแนวทางที่อิงตามสตริง
การเร่งฮาร์ดแวร์
ตั้งแต่ Android 4.0 เป็นต้นไป ระบบจะเปิดใช้การเร่งฮาร์ดแวร์สำหรับหน้าต่างทั้งหมดโดยค่าเริ่มต้นหากแอปพลิเคชันตั้งค่า targetSdkVersion หรือ minSdkVersion เป็น "14" ขึ้นไป โดยทั่วไปแล้ว การเร่งฮาร์ดแวร์จะส่งผลให้ภาพเคลื่อนไหวและการเลื่อนราบรื่นขึ้น รวมถึงประสิทธิภาพและการตอบสนองต่อการโต้ตอบของผู้ใช้โดยรวมดีขึ้น
หากจำเป็น คุณสามารถปิดใช้การเร่งฮาร์ดแวร์ด้วยตนเองได้โดยใช้แอตทริบิวต์ hardwareAccelerated สำหรับองค์ประกอบ <activity> แต่ละรายการหรือองค์ประกอบ <application> หรือจะปิดใช้การเร่งฮาร์ดแวร์สำหรับแต่ละมุมมองโดยเรียกใช้ setLayerType(LAYER_TYPE_SOFTWARE) ก็ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเร่งฮาร์ดแวร์ รวมถึงรายการการดำเนินการวาดที่ไม่รองรับได้ที่เอกสารการเร่งฮาร์ดแวร์
การเปลี่ยนแปลง JNI
ใน Android เวอร์ชันก่อนหน้า การอ้างอิง JNI ในเครื่องไม่ใช่แฮนเดิลทางอ้อม แต่ Android ใช้พอยน์เตอร์โดยตรง ซึ่งไม่เป็นปัญหาตราบใดที่ Garbage Collector ไม่ได้ย้ายออบเจ็กต์ แต่ดูเหมือนว่าจะทำงานได้เนื่องจากทำให้เขียนโค้ดที่มีข้อบกพร่องได้ ใน Android 4.0 ระบบจะใช้การอ้างอิงทางอ้อมเพื่อตรวจหาข้อบกพร่องเหล่านี้
รายละเอียดของข้อมูลอ้างอิงในเครื่อง JNI มีอธิบายไว้ใน "ข้อมูลอ้างอิงในเครื่องและทั่วโลก" ในเคล็ดลับ JNI ใน Android 4.0 CheckJNI ได้รับการปรับปรุงให้ตรวจหาข้อผิดพลาดเหล่านี้ ติดตามบล็อกของนักพัฒนาแอป Android เพื่อดูโพสต์ที่กำลังจะเผยแพร่เกี่ยวกับข้อผิดพลาดที่พบบ่อยในการอ้างอิง JNI และวิธีแก้ไข
การเปลี่ยนแปลงนี้ในการติดตั้งใช้งาน JNI จะส่งผลต่อแอปที่กำหนดเป้าหมายเป็น Android 4.0 โดยการตั้งค่า targetSdkVersion หรือ minSdkVersion เป็น "14" ขึ้นไปเท่านั้น หากคุณตั้งค่าแอตทริบิวต์เหล่านี้เป็นค่าที่ต่ำกว่า การอ้างอิงภายในของ JNI จะทำงานเหมือนกับในเวอร์ชันก่อนหน้า
WebKit
- อัปเดต WebKit เป็นเวอร์ชัน 534.30
- การรองรับแบบอักษรอินเดีย (เทวนาครี เบงกาลี และทมิฬ รวมถึงการรองรับอักขระที่ซับซ้อนซึ่งจำเป็นสำหรับการรวมอักขระ) ใน
WebViewและเบราว์เซอร์ในตัว - การรองรับแบบอักษรเอธิโอเปีย จอร์เจีย และอาร์เมเนียใน
WebViewและเบราว์เซอร์ในตัว - การรองรับ WebDriver ช่วยให้คุณทดสอบแอปที่ใช้
WebViewได้ง่ายขึ้น
เบราว์เซอร์ Android
แอปพลิเคชันเบราว์เซอร์จะเพิ่มฟีเจอร์ต่อไปนี้เพื่อรองรับเว็บแอปพลิเคชัน
- อัปเดตคอมไพเลอร์ V8 JavaScript เพื่อประสิทธิภาพที่เร็วขึ้น
- นอกจากนี้ การปรับปรุงที่สำคัญอื่นๆ ที่ยกมาจาก Android 3.0 ก็พร้อมใช้งานในโทรศัพท์มือถือแล้ว ดังนี้
- รองรับองค์ประกอบตำแหน่งคงที่ในทุกหน้า
- การจับภาพสื่อ HTML
- เหตุการณ์การวางแนวอุปกรณ์
- การเปลี่ยนรูปแบบ 3 มิติของ CSS
สิทธิ์
สิทธิ์ใหม่มีดังนี้
ADD_VOICEMAIL: อนุญาตให้บริการข้อความเสียงเพิ่มข้อความเสียงลงในอุปกรณ์BIND_TEXT_SERVICE: บริการที่ใช้SpellCheckerServiceต้องขอสิทธิ์นี้สำหรับตัวเองBIND_VPN_SERVICE: บริการที่ใช้VpnServiceต้องขอสิทธิ์นี้สำหรับตัวเอง- android.Manifest.permission#READ_PROFILE: ให้สิทธิ์อ่านแก่ผู้ให้บริการ
ContactsContract.Profile - android.Manifest.permission#WRITE_PROFILE: ให้สิทธิ์การเขียนแก่ผู้ให้บริการ
ContactsContract.Profile
ฟีเจอร์ของอุปกรณ์
ฟีเจอร์ใหม่ของอุปกรณ์มีดังนี้
FEATURE_WIFI_DIRECT: ประกาศว่าแอปพลิเคชันใช้ Wi-Fi สำหรับการสื่อสารแบบเพียร์ทูเพียร์
ดูมุมมองโดยละเอียดของการเปลี่ยนแปลง API ทั้งหมดใน Android 4.0 (ระดับ API 14) ได้ที่รายงานความแตกต่างของ API
API ก่อนหน้า
นอกจากฟีเจอร์ทั้งหมดข้างต้นแล้ว Android 4.0 ยังรองรับ API ทั้งหมดจากรุ่นก่อนหน้าด้วย เนื่องจากแพลตฟอร์ม Android 3.x พร้อมใช้งานสำหรับอุปกรณ์หน้าจอขนาดใหญ่เท่านั้น หากคุณพัฒนาแอปสำหรับโทรศัพท์มือถือเป็นหลัก คุณอาจไม่ทราบเกี่ยวกับ API ทั้งหมดที่เพิ่มลงใน Android ในรุ่นล่าสุดเหล่านี้
มาดู API ที่โดดเด่นที่สุดบางส่วนที่คุณอาจพลาดไปซึ่งตอนนี้พร้อมใช้งานบนโทรศัพท์มือถือแล้วเช่นกัน
- Android 3.0
-
Fragment: คอมโพเนนต์เฟรมเวิร์กที่ช่วยให้คุณแยกองค์ประกอบที่แตกต่างกันของกิจกรรมออกเป็นโมดูลแบบสแตนด์อโลนที่กำหนด UI และวงจรของตนเอง ดูคู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับส่วนย่อยActionBar: แถบชื่อแบบใหม่ที่ใช้แทนแถบชื่อแบบเดิมที่ด้านบนของหน้าต่างกิจกรรม ซึ่งรวมถึงโลโก้แอปพลิเคชันที่มุมซ้ายและอินเทอร์เฟซใหม่สำหรับรายการเมนู ดูคู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับแถบการดำเนินการLoader: คอมโพเนนต์เฟรมเวิร์กที่ช่วยให้โหลดข้อมูลแบบอะซิงโครนัสร่วมกับคอมโพเนนต์ UI เพื่อโหลดข้อมูลแบบไดนามิกโดยไม่บล็อกเธรดหลัก ดูคู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับตัวโหลด- คลิปบอร์ดของระบบ: แอปพลิเคชันสามารถคัดลอกและวางข้อมูล (นอกเหนือจากข้อความ) ไปยังและจากคลิปบอร์ดทั้งระบบได้ ข้อมูลที่ตัดอาจเป็นข้อความธรรมดา, URI หรือ Intent ดูคู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับการคัดลอกและวาง
- ลากและวาง: ชุด API ที่สร้างขึ้นในเฟรมเวิร์กมุมมองซึ่งช่วยอำนวยความสะดวกในการลากและวาง ดูคู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับการลากและวาง
- เฟรมเวิร์กภาพเคลื่อนไหวที่ยืดหยุ่นแบบใหม่ทั้งหมดช่วยให้คุณสร้างภาพเคลื่อนไหวให้กับพร็อพเพอร์ตี้ที่กำหนดเองของออบเจ็กต์ใดก็ได้ (View, Drawable, Fragment, Object หรืออื่นๆ) และกำหนดลักษณะของภาพเคลื่อนไหว เช่น ระยะเวลา การประมาณค่าในช่วง การทำซ้ำ และอื่นๆ เฟรมเวิร์กใหม่นี้ทำให้การสร้างภาพเคลื่อนไหวใน Android ง่ายกว่าที่เคย ดูคู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับภาพเคลื่อนไหวของพร็อพเพอร์ตี้
- เครื่องมือประมวลผลและกราฟิก RenderScript: RenderScript มี API การแสดงผลกราฟิก 3 มิติและการประมวลผลประสิทธิภาพสูงในระดับเนทีฟ ซึ่งคุณเขียนใน C (มาตรฐาน C99) ซึ่งให้ประสิทธิภาพประเภทที่คุณคาดหวังจากสภาพแวดล้อมแบบเนทีฟ ขณะที่ยังคงพกพาได้ใน CPU และ GPU ต่างๆ ดูคู่มือนักพัฒนาซอฟต์แวร์ RenderScript
- กราฟิก 2 มิติที่เร่งด้วยฮาร์ดแวร์: ตอนนี้คุณสามารถเปิดใช้โปรแกรมแสดงผล OpenGL สำหรับแอปพลิเคชันของคุณได้โดยตั้งค่า {android:hardwareAccelerated="true"} ในองค์ประกอบ
<application>ขององค์ประกอบไฟล์ Manifest หรือสำหรับองค์ประกอบ<activity>แต่ละรายการ ซึ่งจะส่งผลให้ภาพเคลื่อนไหวและการเลื่อนอย่างราบรื่น รวมถึงประสิทธิภาพและการตอบสนองต่อการโต้ตอบของผู้ใช้โดยรวมดีขึ้นหมายเหตุ: หากคุณตั้งค่า
minSdkVersionหรือtargetSdkVersionของแอปพลิเคชันเป็น"14"ขึ้นไป ระบบจะเปิดใช้การเร่งฮาร์ดแวร์โดยค่าเริ่มต้น - และอื่นๆ อีกมากมาย ดูข้อมูลเพิ่มเติมได้ที่หมายเหตุเกี่ยวกับแพลตฟอร์ม Android 3.0
- Android 3.1
-
- USB API: API ใหม่ที่มีประสิทธิภาพสำหรับการผสานรวมอุปกรณ์ต่อพ่วงที่เชื่อมต่อกับแอปพลิเคชัน Android API เหล่านี้อิงตามสแต็ก USB และบริการที่ติดตั้งมาในแพลตฟอร์ม ซึ่งรวมถึงการรองรับทั้งการโต้ตอบระหว่างโฮสต์ USB และอุปกรณ์ ดูคู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับโฮสต์และอุปกรณ์เสริม USB
- MTP/PTP API: แอปพลิเคชันสามารถโต้ตอบกับกล้องที่เชื่อมต่อและอุปกรณ์ PTP อื่นๆ ได้โดยตรงเพื่อรับการแจ้งเตือนเมื่อมีการเชื่อมต่อและนำอุปกรณ์ออก จัดการไฟล์และพื้นที่เก็บข้อมูลในอุปกรณ์เหล่านั้น รวมถึงโอนไฟล์และข้อมูลเมตาไปยังและจากอุปกรณ์เหล่านั้น MTP API ใช้ชุดย่อย PTP (Picture Transfer Protocol) ของข้อกำหนดเฉพาะ MTP (Media Transfer Protocol) ดูเอกสารประกอบของ
android.mtp - RTP API: Android แสดง API ไปยังสแต็ก RTP (โปรโตคอลรับส่งข้อมูลเรียลไทม์) ในตัว ซึ่งแอปพลิเคชันสามารถใช้เพื่อจัดการสตรีมมิงข้อมูลแบบออนดีมานด์หรือแบบอินเทอร์แอกทีฟได้ โดยเฉพาะอย่างยิ่ง แอปที่ให้บริการ VOIP, Push-to-Talk, การประชุม และสตรีมเสียงสามารถใช้ API เพื่อเริ่มเซสชันและส่งหรือรับสตรีมข้อมูลผ่านเครือข่ายที่พร้อมใช้งาน ดูเอกสารประกอบของ
android.net.rtp - รองรับจอยสติ๊กและอินพุตการเคลื่อนไหวทั่วไปอื่นๆ
- ดูหมายเหตุเกี่ยวกับแพลตฟอร์ม Android 3.1 สำหรับ API ใหม่ๆ อีกมากมาย
- Android 3.2
-
- หน้าจอใหม่รองรับ API ที่ช่วยให้คุณควบคุมวิธีแสดงแอปพลิเคชันในหน้าจอขนาดต่างๆ ได้มากขึ้น API ขยายรูปแบบการรองรับหน้าจอที่มีอยู่ด้วยความสามารถในการกำหนดเป้าหมายช่วงขนาดหน้าจอที่เฉพาะเจาะจงตามขนาดได้อย่างแม่นยำ โดยวัดเป็นหน่วยความหนาแน่นของพิกเซลอิสระ (เช่น ความกว้าง 600dp หรือ 720dp) แทนที่จะเป็นขนาดหน้าจอทั่วไป (เช่น ใหญ่หรือใหญ่มาก) ตัวอย่างเช่น ข้อมูลนี้สำคัญต่อการช่วยคุณแยกความแตกต่างระหว่างอุปกรณ์ขนาด 5 นิ้วกับอุปกรณ์ขนาด 7 นิ้ว ซึ่งโดยปกติแล้วทั้ง 2 ขนาดจะจัดอยู่ในกลุ่มหน้าจอ "ขนาดใหญ่" ดูบล็อกโพสต์เครื่องมือใหม่สำหรับจัดการขนาดหน้าจอ
- ค่าคงที่ใหม่สำหรับ
<uses-feature>เพื่อประกาศข้อกำหนดการวางแนวหน้าจอแนวนอนหรือแนวตั้ง - ตอนนี้การกำหนดค่า "ขนาดหน้าจอ" ของอุปกรณ์จะเปลี่ยนไปเมื่อมีการเปลี่ยนการวางแนวหน้าจอ หากแอปกำหนดเป้าหมายเป็น API ระดับ 13 ขึ้นไป คุณต้องจัดการการเปลี่ยนแปลงการกำหนดค่า
"screenSize"หากต้องการจัดการการเปลี่ยนแปลงการกำหนดค่า"orientation"ด้วย ดูข้อมูลเพิ่มเติมได้ที่android:configChanges - ดูหมายเหตุเกี่ยวกับแพลตฟอร์ม Android 3.2 สำหรับ API ใหม่อื่นๆ
ระดับ API
API ของ Android 4.0 จะได้รับการกำหนดตัวระบุจำนวนเต็ม 14 ซึ่งจัดเก็บไว้ในระบบเอง ตัวระบุนี้เรียกว่า "ระดับ API" ซึ่งช่วยให้ระบบระบุได้อย่างถูกต้องว่าแอปพลิเคชันเข้ากันได้กับระบบหรือไม่ก่อนที่จะติดตั้งแอปพลิเคชัน
หากต้องการใช้ API ที่เปิดตัวใน Android 4.0 ในแอปพลิเคชัน คุณต้องคอมไพล์แอปพลิเคชันกับแพลตฟอร์ม Android ที่รองรับ API ระดับ 14 ขึ้นไป คุณอาจต้องเพิ่มแอตทริบิวต์ android:minSdkVersion="14" ลงในองค์ประกอบ <uses-sdk> ด้วย ทั้งนี้ขึ้นอยู่กับความต้องการของคุณ
อ่านข้อมูลเพิ่มเติมได้ที่ระดับ API คืออะไร