Level API: 12
Untuk developer, platform Android 3.1
(HONEYCOMB_MR1) tersedia sebagai
komponen yang dapat didownload untuk Android SDK. Platform yang dapat didownload mencakup
library dan image sistem Android, serta serangkaian skin emulator dan
lainnya. Platform yang dapat didownload tidak menyertakan library eksternal.
Bagi developer, platform Android 3.1 tersedia sebagai komponen yang dapat didownload untuk Android SDK. Platform yang dapat didownload mencakup library dan image sistem Android, serta serangkaian skin emulator dan lainnya. Untuk mulai mengembangkan atau menguji Android 3.1, gunakan Android SDK Manager untuk mendownload platform ke SDK Anda.
Ringkasan API
Bagian di bawah ini memberikan ringkasan teknis tentang hal-hal baru bagi developer di Android 3.1, termasuk fitur dan perubahan baru dalam API framework sejak versi sebelumnya.
USB API
Android 3.1 memperkenalkan API baru yang canggih untuk mengintegrasikan periferal yang terhubung dengan aplikasi yang berjalan di platform. API ini didasarkan pada stack USB (Universal Serial Bus) dan layanan yang di-build ke dalam platform, termasuk dukungan untuk interaksi host dan perangkat USB. Dengan menggunakan API, developer dapat membuat aplikasi yang dapat menemukan, berkomunikasi dengan, dan mengelola berbagai jenis perangkat yang terhubung melalui USB.
Stack dan API membedakan dua jenis dasar hardware USB, berdasarkan apakah perangkat Android bertindak sebagai host atau hardware eksternal bertindak sebagai host:
- Perangkat USB adalah hardware terhubung yang bergantung pada perangkat Android untuk berfungsi sebagai host. Misalnya, sebagian besar perangkat input, mouse, dan joystick adalah perangkat USB, seperti halnya banyak kamera dan hub.
- Aksesori USB adalah hardware terhubung yang memiliki pengontrol host USB, menyediakan daya, dan dirancang untuk berkomunikasi dengan perangkat Android melalui USB. Berbagai periferal dapat terhubung sebagai aksesori, mulai dari pengontrol robotika hingga peralatan musik, sepeda olahraga, dan lainnya.
Untuk kedua jenis — perangkat USB dan aksesori USB — API USB platform mendukung penemuan melalui siaran intent saat dipasang atau dilepas, serta antarmuka, endpoint, dan mode transfer standar (kontrol, massal, dan interupsi).
USB API tersedia dalam paket android.hardware.usb. Class
pusatnya adalah UsbManager, yang menyediakan
metode bantuan untuk mengidentifikasi dan berkomunikasi dengan
perangkat USB dan aksesori USB. Aplikasi dapat memperoleh instance
UsbManager, lalu mengkueri daftar perangkat atau aksesori yang terpasang,
kemudian berkomunikasi dengan atau mengelolanya.
UsbManager juga mendeklarasikan tindakan intent yang disiarkan sistem, untuk mengumumkan saat perangkat atau aksesori USB dipasang atau dilepas.
Class lainnya mencakup:
UsbDevice, class yang mewakili hardware eksternal yang terhubung sebagai perangkat USB (dengan perangkat Android yang bertindak sebagai host).UsbAccessory, yang mewakili hardware eksternal yang terhubung sebagai host USB (dengan perangkat yang didukung Android bertindak sebagai perangkat USB).UsbInterfacedanUsbEndpoint, yang memberikan akses ke antarmuka dan endpoint USB standar untuk perangkat.UsbDeviceConnectiondanUsbRequest, untuk mengirim dan menerima data serta pesan kontrol ke atau dari perangkat USB, secara sinkron dan asinkron.UsbConstants, yang menyediakan konstanta untuk mendeklarasikan jenis endpoint dan class perangkat.
Perhatikan bahwa meskipun stack USB sudah di-build ke dalam platform, dukungan sebenarnya untuk mode host USB dan aksesori terbuka pada perangkat tertentu ditentukan oleh produsennya. Secara khusus, mode host mengandalkan hardware pengontrol USB yang sesuai di perangkat Android.
Selain itu, developer dapat meminta pemfilteran di Google Play, sehingga aplikasi mereka tidak tersedia bagi pengguna yang perangkatnya tidak menyediakan dukungan USB yang sesuai. Untuk meminta pemfilteran, tambahkan salah satu atau kedua elemen di bawah ke manifes aplikasi, sebagaimana mestinya:
- Jika aplikasi hanya boleh terlihat oleh perangkat yang mendukung mode host USB (koneksi perangkat USB), deklarasikan elemen ini:
<uses-feature android:name="android.hardware.usb.host" android:required="true"> - Jika aplikasi hanya boleh terlihat oleh perangkat yang mendukung aksesori
USB (koneksi host USB), deklarasikan elemen ini:
<uses-feature android:name="android.hardware.usb.accessory" android:required="true">
Untuk mengetahui informasi lengkap tentang cara mengembangkan aplikasi yang berinteraksi dengan aksesori USB, lihat dokumentasi developer.
Untuk melihat aplikasi contoh yang menggunakan USB host API, lihat ADB Test dan Missile Launcher
MTP/PTP API
Android 3.1 mengekspos API MTP baru yang memungkinkan aplikasi berinteraksi langsung dengan kamera yang terhubung dan perangkat PTP lainnya. API baru ini memungkinkan aplikasi menerima notifikasi saat perangkat dipasang dan dilepas, mengelola file dan penyimpanan di perangkat tersebut, serta mentransfer file dan metadata ke dan dari perangkat tersebut. MTP API mengimplementasikan subset PTP (Picture Transfer Protocol) dari spesifikasi MTP (Media Transfer Protocol).
MTP API tersedia dalam paket android.mtp dan menyediakan
class berikut:
MtpDevicemengenkapsulasi perangkat MTP yang terhubung melalui bus host USB. Aplikasi dapat membuat instance objek dari jenis ini, lalu menggunakan metodenya untuk mendapatkan informasi tentang perangkat dan objek yang disimpan di dalamnya, serta membuka koneksi dan mentransfer data. Beberapa metodenya mencakup:getObjectHandles()menampilkan daftar handle untuk semua objek di perangkat yang cocok dengan format dan induk yang ditentukan. Untuk mendapatkan informasi tentang objek, aplikasi dapat meneruskan handle kegetObjectInfo().importFile()memungkinkan aplikasi menyalin data untuk objek ke file di penyimpanan eksternal. Panggilan ini dapat memblokir untuk jangka waktu arbitrer, bergantung pada ukuran data dan kecepatan perangkat, sehingga harus dilakukan dari thread terpisah.open()memungkinkan aplikasi membuka perangkat MTP/PTP yang terhubung.getThumbnail()menampilkan thumbnail objek sebagai array byte.
MtpStorageInfomenyimpan informasi tentang unit penyimpanan di perangkat MTP, yang sesuai dengan Set Data StorageInfo yang dijelaskan di bagian 5.2.2 spesifikasi MTP. Metode di class ini memungkinkan aplikasi mendapatkan string deskripsi unit penyimpanan, ruang kosong, kapasitas penyimpanan maksimum, ID penyimpanan, dan ID volume.MtpDeviceInfomenyimpan informasi tentang perangkat MTP yang sesuai dengan Set Data DeviceInfo yang dijelaskan di bagian 5.1.1 spesifikasi MTP. Metode dalam class ini memungkinkan aplikasi mendapatkan produsen, model, nomor seri, dan versi perangkat.MtpObjectInfomenyimpan informasi tentang objek yang disimpan di perangkat MTP, sesuai dengan Set Data ObjectInfo yang dijelaskan di bagian 5.3.1 spesifikasi MTP. Metode dalam class memungkinkan aplikasi mendapatkan ukuran objek, format data, jenis pengaitan, tanggal pembuatan, dan informasi thumbnail.MtpConstantsmenyediakan konstanta untuk mendeklarasikan kode format file MTP, jenis pengaitan, dan status perlindungan.
Dukungan untuk perangkat input dan peristiwa gerakan baru
Android 3.1 memperluas subsistem input untuk mendukung perangkat input baru dan jenis peristiwa gerakan baru, di semua tampilan dan jendela. Developer dapat memanfaatkan kemampuan ini untuk memungkinkan pengguna berinteraksi dengan aplikasi mereka menggunakan mouse, trackball, joystick, gamepad, dan perangkat lainnya, selain keyboard dan layar sentuh.
Untuk menangani input mouse, scrollwheel, dan trackball, platform ini mendukung dua tindakan peristiwa gerakan baru:
ACTION_SCROLL, yang menjelaskan lokasi pointer tempat gerakan scroll non-sentuh, seperti dari roda scroll mouse, terjadi. Di MotionEvent, nilai sumbuAXIS_HSCROLLdanAXIS_VSCROLLmenentukan gerakan scroll relatif.ACTION_HOVER_MOVE, melaporkan posisi mouse saat ini saat tidak ada tombol yang ditekan, serta titik perantara sejak peristiwaHOVER_MOVEterakhir. Notifikasi masuk dan keluar saat kursor diarahkan belum didukung.
Untuk mendukung joystick dan gamepad, class InputDevice
menyertakan sumber perangkat input baru berikut:
SOURCE_CLASS_JOYSTICK— perangkat sumber memiliki sumbu joystick.SOURCE_CLASS_BUTTON— perangkat sumber memiliki tombol atau tombol keyboard.SOURCE_GAMEPAD— perangkat sumber memiliki tombol gamepad sepertiKEYCODE_BUTTON_AatauKEYCODE_BUTTON_B. MenyiratkanSOURCE_CLASS_BUTTONSOURCE_JOYSTICK— perangkat sumber memiliki sumbu joystick. Menyiratkan SOURCE_CLASS_JOYSTICK.
Untuk mendeskripsikan peristiwa gerakan dari sumber baru ini, serta dari mouse
dan trackball, platform kini menentukan kode sumbu di MotionEvent, mirip dengan cara menentukan kode tombol di KeyEvent. Kode sumbu baru untuk joystick
dan pengontrol game mencakup
AXIS_HAT_X, AXIS_HAT_Y, AXIS_RTRIGGER, AXIS_ORIENTATION, AXIS_THROTTLE, dan banyak lainnya.
Sumbu MotionEvent yang ada diwakili oleh AXIS_X, AXIS_Y,
AXIS_PRESSURE, AXIS_SIZE, AXIS_TOUCH_MAJOR, AXIS_TOUCH_MINOR, AXIS_TOOL_MAJOR, AXIS_TOOL_MINOR, dan AXIS_ORIENTATION.
Selain itu, MotionEvent menentukan sejumlah kode sumbu umum yang digunakan saat framework tidak mengetahui cara memetakan sumbu tertentu. Perangkat tertentu dapat menggunakan kode sumbu generik untuk meneruskan data gerakan kustom ke aplikasi. Untuk mengetahui daftar lengkap sumbu dan interpretasi yang dimaksud, lihat dokumentasi class MotionEvent.
Platform ini menyediakan peristiwa gerakan ke aplikasi dalam batch, sehingga satu
peristiwa dapat berisi posisi saat ini dan beberapa gerakan historis.
Aplikasi harus menggunakan getHistorySize() untuk mendapatkan
jumlah sampel historis, lalu mengambil dan memproses semua sampel
historis secara berurutan menggunakan getHistoricalAxisValue(). Setelah itu, aplikasi harus memproses sampel saat ini menggunakan getAxisValue().
Beberapa sumbu dapat diambil menggunakan metode pengakses khusus. Misalnya,
daripada memanggil getAxisValue(), aplikasi dapat memanggil getX(). Sumbu yang memiliki pengakses bawaan mencakup AXIS_X, AXIS_Y,
AXIS_PRESSURE, AXIS_SIZE, AXIS_TOUCH_MAJOR, AXIS_TOUCH_MINOR, AXIS_TOOL_MAJOR, AXIS_TOOL_MINOR, dan AXIS_ORIENTATION.
Setiap perangkat input memiliki ID unik yang ditetapkan sistem dan juga dapat menyediakan
beberapa sumber. Jika perangkat menyediakan beberapa sumber, lebih dari satu sumber
dapat menyediakan data sumbu menggunakan sumbu yang sama. Misalnya, peristiwa sentuh yang berasal
dari sumber sentuh menggunakan sumbu X untuk data posisi layar, sedangkan peristiwa joystick
yang berasal dari sumber joystick akan menggunakan sumbu X untuk posisi
stick. Oleh karena itu, penting bagi aplikasi untuk menafsirkan nilai sumbu
sesuai dengan sumber asalnya. Saat menangani peristiwa gerakan, aplikasi harus menggunakan metode di class InputDevice untuk menentukan sumbu yang didukung oleh perangkat atau sumber. Secara khusus,
aplikasi dapat menggunakan getMotionRanges() untuk mengkueri semua sumbu perangkat atau semua sumbu dari sumber
perangkat tertentu. Dalam kedua kasus tersebut, informasi rentang untuk sumbu yang ditampilkan dalam objek InputDevice.MotionRange menentukan sumber untuk setiap nilai sumbu.
Terakhir, karena peristiwa gerakan dari joystick, gamepad, mouse, dan
trackball bukan peristiwa sentuh, platform menambahkan metode callback baru untuk
meneruskannya ke View sebagai peristiwa gerakan "generik".
Secara khusus, class ini melaporkan peristiwa gerakan non-sentuh ke
View melalui panggilan ke onGenericMotionEvent(), bukan ke onTouchEvent().
Platform mengirimkan peristiwa gerakan umum secara berbeda, bergantung pada
class sumber peristiwa. Peristiwa SOURCE_CLASS_POINTER
berpindah ke View di bawah pointer, mirip dengan cara kerja peristiwa
sentuh. Semua yang lain akan masuk ke View yang saat ini difokuskan.
Misalnya, ini berarti View harus mengambil fokus untuk
menerima peristiwa joystick. Jika diperlukan, aplikasi dapat menangani peristiwa ini di
tingkat Aktivitas atau Dialog dengan mengimplementasikan onGenericMotionEvent() di sana.
Untuk melihat contoh aplikasi yang menggunakan peristiwa gerakan joystick, lihat GameControllerInput dan GameView.
RTP API
Android 3.1 mengekspos API ke stack RTP (Real-time Transport Protocol) bawaannya, yang dapat digunakan aplikasi untuk mengelola streaming data on-demand atau interaktif. Secara khusus, aplikasi yang menyediakan VOIP, push-to-talk, konferensi, dan streaming audio dapat menggunakan API untuk memulai sesi dan mengirimkan atau menerima aliran data melalui jaringan yang tersedia.
RTP API tersedia dalam paket android.net.rtp. Kelasnya
meliputi:
RtpStream, class dasar aliran data yang mengirim dan menerima paket jaringan dengan payload media melalui RTP.AudioStream, subclass dariRtpStreamyang membawa payload audio melalui RTP.AudioGroup, hub audio lokal untuk mengelola dan menggabungkan speaker, mikrofon, danAudioStreamperangkat.AudioCodec, yang menyimpan kumpulan codec yang Anda tentukan untukAudioStream.
Untuk mendukung konferensi audio dan penggunaan serupa, aplikasi membuat instance dua class sebagai endpoint untuk streaming:
AudioStreammenentukan endpoint jarak jauh dan terdiri dari pemetaan jaringan danAudioCodecyang dikonfigurasi.AudioGroupmewakili endpoint lokal untuk satu atau beberapaAudioStream.AudioGroupmenggabungkan semuaAudioStreamdan secara opsional berinteraksi dengan speaker dan mikrofon perangkat secara bersamaan.
Penggunaan paling sederhana melibatkan satu endpoint jarak jauh dan endpoint lokal.
Untuk penggunaan yang lebih kompleks, lihat batasan yang dijelaskan untuk
AudioGroup.
Untuk menggunakan RTP API, aplikasi harus meminta izin dari pengguna dengan
mendeklarasikan <uses-permission
android:name="android.permission.INTERNET">
dalam file manifesnya. Untuk mendapatkan mikrofon perangkat, izin <uses-permission
android:name="android.permission.RECORD_AUDIO"> juga diperlukan.
Widget aplikasi yang ukurannya dapat disesuaikan
Mulai Android 3.1, developer dapat membuat widget layar utama dapat diubah ukurannya — secara horizontal, vertikal, atau pada kedua sumbu. Pengguna menyentuh lama widget untuk menampilkan handel pengubah ukurannya, lalu menarik tuas horizontal dan/atau vertikal untuk mengubah ukuran pada petak tata letak.
Developer dapat membuat widget Layar utama dapat diubah ukurannya dengan menentukan
atribut resizeMode dalam metadata AppWidgetProviderInfo widget. Nilai untuk atribut resizeMode mencakup "horizontal", "vertical", dan "none".
Untuk mendeklarasikan widget sebagai dapat diubah ukurannya secara horizontal dan vertikal, berikan nilai
"horizontal|vertical".
Berikut contohnya:
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minWidth="294dp" android:minHeight="72dp" android:updatePeriodMillis="86400000" android:previewImage="@drawable/preview" android:initialLayout="@layout/example_appwidget" android:configure="com.example.android.ExampleAppWidgetConfigure" android:resizeMode="horizontal|vertical" > </appwidget-provider>
Untuk informasi selengkapnya tentang widget Layar utama, lihat dokumentasi Widget Aplikasi.
Framework animasi
- Class ViewPropertyAnimator baru
- Class
ViewPropertyAnimatorbaru memberikan cara yang mudah bagi developer untuk menganimasikan properti tertentu pada objekView. Class ini mengotomatiskan dan mengoptimalkan animasi properti serta mempermudah pengelolaan beberapa animasi simultan pada objekView.Penggunaan
ViewPropertyAnimatorsangat mudah. Untuk menganimasikan properti bagiView, panggilanimate()guna membuat objekViewPropertyAnimatoruntukViewtersebut. Gunakan metode padaViewPropertyAnimatoruntuk menentukan properti yang akan dianimasikan dan cara menganimasikannya. Misalnya, untuk memudarkanViewmenjadi transparan, panggilalpha(0);. ObjekViewPropertyAnimatormenangani detail konfigurasi classAnimatoryang mendasarinya dan memulainya, lalu merender animasi.
- Class
- Warna latar belakang animasi
- Metode
getBackgroundColor()dansetBackgroundColor(int)baru memungkinkan Anda mendapatkan/menetapkan warna latar belakang di balik animasi, hanya untuk animasi jendela. Saat ini, latar belakang harus berwarna hitam, dengan tingkat alfa yang Anda inginkan.
- Metode
- Mendapatkan pecahan animasi dari
ViewAnimator- Metode
getAnimatedFraction()baru memungkinkan Anda mendapatkan pecahan animasi saat ini — pecahan yang berlalu/diinterpolasi yang digunakan dalam update frame terbaru — dariValueAnimator.
- Metode
Framework UI
- Rendering paksa lapisan
- Metode
buildLayer()baru memungkinkan aplikasi memaksa pembuatan lapisan View dan View langsung dirender ke dalamnya. Misalnya, aplikasi dapat menggunakan metode ini untuk merender View ke dalam lapisan sebelum memulai animasi. Jika View bersifat kompleks, merendernya ke lapisan sebelum memulai animasi akan menghindari frame yang terlewati.
- Metode
- Jarak kamera
- Aplikasi dapat menggunakan metode baru
setCameraDistance(float)untuk menetapkan jarak dari kamera ke View. Hal ini memberi aplikasi kontrol yang lebih baik atas transformasi 3D Tampilan, seperti rotasi.
- Aplikasi dapat menggunakan metode baru
- Mendapatkan tampilan kalender dari DatePicker
- Metode
getCalendarView()baru memungkinkan Anda mendapatkanCalendarViewdari instanceDatePicker.
- Metode
- Mendapatkan callback saat tampilan dilepas
View.OnAttachStateChangeListenerbaru memungkinkan Anda menerima callback saat View dipasang atau dilepas dari jendelanya. GunakanaddOnAttachStateChangeListener()untuk menambahkan pemroses danaddOnAttachStateChangeListener()untuk menghapusnya.
- Pemroses breadcrumb fragmen, tanda tangan onInflate() baru
- Metode baru,
setOnBreadCrumbClickListener(), menyediakan hook untuk memungkinkan aplikasi menangkap klik breadcrumb fragmen dan mengambil tindakan apa pun yang diperlukan sebelum membuka entri backstack atau fragmen yang diklik. - Di class
Fragment,onInflate(attrs, savedInstanceState)tidak digunakan lagi. GunakanonInflate(activity, attrs, savedInstanceState)sebagai gantinya.
- Metode baru,
- Tampilkan hasil penelusuran di tab baru
- Kunci data
EXTRA_NEW_SEARCHuntuk intentACTION_WEB_SEARCHmemungkinkan Anda membuka penelusuran di tab browser baru, bukan di tab yang sudah ada.
- Kunci data
- Kursor teks drawable
- Anda kini dapat menentukan drawable yang akan digunakan sebagai kursor teks menggunakan atribut resource baru
textCursorDrawable.
- Anda kini dapat menentukan drawable yang akan digunakan sebagai kursor teks menggunakan atribut resource baru
- Menyetel turunan yang ditampilkan dalam tampilan jarak jauh
- Metode praktis baru,
setDisplayedChild(viewId, childIndex), tersedia di subclassRemoteViews, untuk memungkinkan Anda menetapkan turunan yang ditampilkan di subclassViewAnimatordanAdapterViewAnimatorsepertiAdapterViewFlipper,StackView,ViewFlipper, danViewSwitcher.
- Metode praktis baru,
- Tombol umum untuk gamepad dan perangkat input lainnya
KeyEventmenambahkan berbagai kode tombol generik untuk mengakomodasi tombol gamepad. Class ini juga menambahkanisGamepadButton(int)dan beberapa metode helper lainnya untuk menangani kode tombol.
Grafik
- Helper untuk mengelola bitmap
setHasAlpha(boolean)memungkinkan aplikasi menunjukkan bahwa semua piksel dalam Bitmap diketahui buram (false) atau beberapa piksel mungkin berisi nilai alfa yang tidak buram (true). Perhatikan bahwa untuk beberapa konfigurasi (seperti RGB_565), panggilan ini diabaikan karena tidak mendukung nilai alfa per piksel. Hal ini dimaksudkan sebagai petunjuk gambar, karena dalam beberapa kasus, bitmap yang diketahui buram dapat mengambil kasus gambar yang lebih cepat daripada bitmap yang mungkin memiliki nilai alfa per piksel yang tidak buram.getByteCount()mendapatkan ukuran Bitmap dalam byte.getGenerationId()memungkinkan aplikasi mengetahui apakah Bitmap telah diubah, misalnya untuk penyimpanan cache.sameAs(android.graphics.Bitmap)menentukan apakah Bitmap tertentu berbeda dengan Bitmap saat ini, dalam dimensi, konfigurasi, atau data piksel.
- Menetapkan lokasi dan rotasi kamera
Cameramenambahkan dua metode baru,rotate()dansetLocation(), untuk mengontrol lokasi kamera, untuk transformasi 3D.
Jaringan
- Kunci Wi-Fi berperforma tinggi
- Kunci Wi-Fi berperforma tinggi yang baru memungkinkan aplikasi mempertahankan
koneksi Wi-Fi berperforma tinggi bahkan saat layar perangkat nonaktif.
Aplikasi yang melakukan streaming musik, video, atau suara dalam waktu lama dapat memperoleh
kunci Wi-Fi berperforma tinggi untuk memastikan performa streaming bahkan saat layar
nonaktif. Karena menggunakan lebih banyak daya, aplikasi harus memperoleh
Wi-Fi berperforma tinggi saat ada kebutuhan untuk koneksi aktif yang berjalan
lama.
Untuk membuat kunci berperforma tinggi, teruskan
WIFI_MODE_FULL_HIGH_PERFsebagai mode kunci dalam panggilan kecreateWifiLock().
- Kunci Wi-Fi berperforma tinggi yang baru memungkinkan aplikasi mempertahankan
koneksi Wi-Fi berperforma tinggi bahkan saat layar perangkat nonaktif.
Aplikasi yang melakukan streaming musik, video, atau suara dalam waktu lama dapat memperoleh
kunci Wi-Fi berperforma tinggi untuk memastikan performa streaming bahkan saat layar
nonaktif. Karena menggunakan lebih banyak daya, aplikasi harus memperoleh
Wi-Fi berperforma tinggi saat ada kebutuhan untuk koneksi aktif yang berjalan
lama.
- Statistik traffic lainnya
- Aplikasi kini dapat mengakses statistik tentang lebih banyak jenis penggunaan jaringan
menggunakan metode baru di
TrafficStats. Aplikasi dapat menggunakan metode untuk mendapatkan statistik UDP, jumlah paket, byte payload transmisi/penerimaan TCP, dan segmen untuk UID tertentu.
- Aplikasi kini dapat mengakses statistik tentang lebih banyak jenis penggunaan jaringan
menggunakan metode baru di
- Nama pengguna autentikasi SIP
- Aplikasi kini dapat memperoleh dan menetapkan nama pengguna autentikasi SIP untuk profil
menggunakan
metode baru
getAuthUserName()dansetAuthUserName().
- Aplikasi kini dapat memperoleh dan menetapkan nama pengguna autentikasi SIP untuk profil
menggunakan
metode baru
Pengelola Download
- Penanganan download yang telah selesai
- Aplikasi kini dapat memulai download yang hanya memberi tahu pengguna setelah
selesai. Untuk memulai jenis download ini, aplikasi meneruskan
VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETIONdalam metodesetNotificationVisibility()objek permintaan. - Metode baru,
addCompletedDownload(), memungkinkan aplikasi menambahkan file ke database download, sehingga dapat dikelola oleh aplikasi Download.
- Aplikasi kini dapat memulai download yang hanya memberi tahu pengguna setelah
selesai. Untuk memulai jenis download ini, aplikasi meneruskan
- Menampilkan hasil download yang diurutkan menurut ukuran
- Aplikasi dapat memulai aplikasi Downloads dalam mode urutkan berdasarkan ukuran dengan
menambahkan
INTENT_EXTRAS_SORT_BY_SIZEtambahan baru ke intentACTION_VIEW_DOWNLOADS.
- Aplikasi dapat memulai aplikasi Downloads dalam mode urutkan berdasarkan ukuran dengan
menambahkan
Framework IME
- Mendapatkan kunci nilai tambahan metode input
InputMethodSubtypemenambahkan metodecontainsExtraValueKey()untuk memeriksa apakah string ExtraValue disimpan untuk subjenis dan metodegetExtraValueOf()untuk mengekstrak nilai kunci tertentu dari hashmap ExtraValue.
Media
- Format audio streaming baru
- Framework media menambahkan dukungan bawaan untuk konten ADTS AAC mentah, untuk audio streaming yang lebih baik, serta dukungan untuk audio FLAC, untuk konten audio terkompresi berkualitas tertinggi (lossless). Lihat dokumen Format Media yang Didukung untuk mengetahui informasi selengkapnya.
Kontrol peluncuran pada aplikasi yang dihentikan
Mulai dari Android 3.1, pengelola paket sistem melacak aplikasi yang berada dalam status berhenti dan menyediakan cara untuk mengontrol peluncurannya dari proses latar belakang dan aplikasi lain.
Perhatikan bahwa status aplikasi yang dihentikan tidak sama dengan status Aktivitas yang dihentikan. Sistem mengelola kedua status berhenti tersebut secara terpisah.
Platform ini menentukan dua flag intent baru yang memungkinkan pengirim menentukan apakah Intent harus diizinkan untuk mengaktifkan komponen dalam aplikasi yang dihentikan.
FLAG_INCLUDE_STOPPED_PACKAGES— Sertakan filter intent aplikasi yang dihentikan dalam daftar target potensial untuk diselesaikan.FLAG_EXCLUDE_STOPPED_PACKAGES— Mengecualikan filter intent aplikasi yang dihentikan dari daftar target potensial.
Jika tidak ada atau kedua flag ini ditentukan dalam intent, perilaku defaultnya adalah menyertakan filter aplikasi yang dihentikan dalam daftar target potensial.
Perhatikan bahwa sistem menambahkan FLAG_EXCLUDE_STOPPED_PACKAGES ke semua intent
siaran. Hal ini dilakukan untuk mencegah siaran dari layanan latar belakang
meluncurkan komponen aplikasi yang dihentikan secara tidak sengaja atau tidak perlu.
Layanan atau aplikasi latar belakang dapat mengganti perilaku ini dengan menambahkan
flag FLAG_INCLUDE_STOPPED_PACKAGES ke intent siaran
yang harus diizinkan untuk mengaktifkan aplikasi yang dihentikan.
Aplikasi berada dalam status dihentikan saat pertama kali diinstal, tetapi belum diluncurkan dan saat dihentikan secara manual oleh pengguna (di Kelola Aplikasi).
Notifikasi peluncuran dan upgrade pertama aplikasi
Platform ini menambahkan notifikasi yang ditingkatkan untuk peluncuran dan upgrade aplikasi pertama melalui dua tindakan intent baru:
ACTION_PACKAGE_FIRST_LAUNCH— Dikirim ke paket penginstal aplikasi saat aplikasi tersebut pertama kali diluncurkan (yaitu, pertama kali dipindahkan dari status dihentikan). Data tersebut berisi nama paket.ACTION_MY_PACKAGE_REPLACED— Memberi tahu aplikasi bahwa aplikasi tersebut telah diupdate, dengan versi baru yang diinstal di atas versi yang ada. Intent ini hanya dikirim ke aplikasi yang diganti. Objek ini tidak berisi data tambahan. Untuk menerimanya, deklarasikan filter intent untuk tindakan ini. Anda dapat menggunakan intent untuk memicu kode yang membantu mengembalikan aplikasi ke kondisi berjalan yang semestinya setelah upgrade.Intent ini dikirim langsung ke aplikasi, tetapi hanya jika aplikasi diupgrade saat dalam status dimulai (bukan dalam status dihentikan).
Utilitas inti
- Cache LRU
- Class
LruCachebaru memungkinkan aplikasi Anda mendapatkan manfaat dari caching yang efisien. Aplikasi dapat menggunakan class ini untuk mengurangi waktu yang dihabiskan untuk menghitung atau mendownload data dari jaringan, sekaligus mempertahankan jejak memori yang wajar untuk data yang di-cache.LruCacheadalah cache yang menyimpan referensi kuat ke sejumlah nilai yang terbatas. Setiap kali nilai diakses, nilai tersebut akan dipindahkan ke awal antrean. Saat nilai ditambahkan ke cache yang penuh, nilai di akhir antrean tersebut akan dikeluarkan dan mungkin memenuhi syarat untuk pembersihan sampah memori.
- Class
- Deskriptor file sebagai
int- Anda kini bisa mendapatkan int deskriptor file native untuk
ParcelFileDescriptormenggunakan salah satu metode baru,getFd()ataudetachFd().
- Anda kini bisa mendapatkan int deskriptor file native untuk
WebKit
- Cookie skema file
CookieManagerkini mendukung cookie yang menggunakan skema URIfile:. Anda dapat menggunakansetAcceptFileSchemeCookies()untuk mengaktifkan/menonaktifkan dukungan untuk cookie skema file, sebelum membuat instanceWebViewatauCookieManager. Dalam instanceCookieManager, Anda dapat memeriksa apakah cookie skema file diaktifkan dengan memanggilallowFileSchemeCookies().
- Notifikasi permintaan login
- Untuk mendukung fitur login otomatis browser yang diperkenalkan di Android 3.0, metode
baru
onReceivedLoginRequest()memberi tahu aplikasi host bahwa permintaan login otomatis untuk pengguna telah diproses.
- Untuk mendukung fitur login otomatis browser yang diperkenalkan di Android 3.0, metode
baru
- Class dan antarmuka yang dihapus
- Beberapa class dan antarmuka dihapus dari API publik, setelah sebelumnya dalam status tidak digunakan lagi. Lihat Laporan Perbedaan API untuk mengetahui informasi selengkapnya.
Browser
Aplikasi Browser menambahkan fitur berikut untuk mendukung aplikasi web:
- Dukungan untuk pemutaran sisipan video yang disematkan dalam tag
<video>HTML5. Pemutaran diakselerasi dengan hardware jika memungkinkan. - Dukungan lapisan untuk elemen posisi yang tetap untuk semua situs (seluler dan desktop).
Konstanta fitur baru
Platform ini menambahkan konstanta fitur hardware baru yang dapat dideklarasikan oleh developer
dalam manifes aplikasi mereka, untuk memberi tahu entitas eksternal seperti Google
Play tentang persyaratan aplikasi untuk kemampuan hardware baru yang didukung
dalam versi platform ini. Developer mendeklarasikan konstanta fitur ini dan konstanta fitur lainnya dalam elemen manifes <uses-feature>.
android.hardware.usb.accessory— Aplikasi menggunakan USB API untuk berkomunikasi dengan perangkat hardware eksternal yang terhubung melalui USB dan berfungsi sebagai host.android.hardware.usb.host— Aplikasi menggunakan USB API untuk berkomunikasi dengan perangkat hardware eksternal yang terhubung melalui USB dan berfungsi sebagai perangkat.
Google Play memfilter aplikasi berdasarkan fitur yang dideklarasikan dalam elemen manifes <uses-feature>. Untuk mengetahui informasi selengkapnya tentang
mendeklarasikan fitur dalam manifes aplikasi, baca Filter
Google Play.
Laporan Perbedaan API
Untuk melihat tampilan mendetail semua perubahan API di Android 3.1 (API Level 12), lihat Laporan Perbedaan API.
API Level
Platform Android 3.1 menyediakan versi terbaru API framework. Android 3.1 API diberi ID bilangan bulat — 12 — yang disimpan dalam sistem itu sendiri. ID ini, yang disebut "Level API", memungkinkan sistem menentukan dengan benar apakah aplikasi kompatibel dengan sistem, sebelum menginstal aplikasi.
Untuk menggunakan API yang diperkenalkan di Android 3.1 dalam aplikasi,
Anda perlu mengompilasi aplikasi terhadap library Android yang disediakan di
platform Android 3.1 SDK. Bergantung pada kebutuhan, Anda
mungkin
juga perlu menambahkan atribut android:minSdkVersion="12"
ke elemen <uses-sdk> dalam manifes
aplikasi.
Untuk mengetahui informasi selengkapnya, baca Apa yang dimaksud dengan Level API?