Membuat editor metode masukan di Wear

Wear OS by Google menambahkan dukungan untuk metode masukan di luar suara dengan memperluas framework editor metode masukan (IME) Android. Framework IME menyediakan dukungan untuk keyboard virtual di layar yang memungkinkan pengguna memasukkan teks dalam bentuk penekanan tombol, tulisan tangan, atau gestur.

Pengguna Wear bisa memilih berbagai opsi masukan dari Masukan Jarak Jauh. Opsi ini mencakup:

  • Dikte
  • Emoji
  • Template pesan
  • Smart Reply
  • IME default

Gambar 1. Sampel metode masukan

Wear dilengkapi dengan Editor Metode Masukan (IME) default sistem dan akan membuka IME API bagi developer pihak ketiga guna membuat IME khusus untuk Wear. IME API yang digunakan untuk perangkat Wear sama dengan faktor bentuk lainnya, meskipun penggunaannya sedikit berbeda karena properti layar yang terbatas.

Dokumen ini memberikan panduan yang akan membantu Anda membuat IME spesifik Wear

Membuat metode masukan untuk Wear

Platform Android menyediakan framework standar untuk membuat IME. Untuk membuat IME spesifik Wear, Anda perlu mengoptimalkan IME untuk ukuran layar terbatas.

Untuk mempelajari cara membuat metode masukan pada Wear, ikuti panduan untuk Membuat Metode Masukan di perangkat genggam dan tambahkan filter Google Play berikut dalam file manifes Anda untuk membuatnya menjadi IME spesifik Wear.

Filter IME spesifik Wear

  • API level

    Jika Anda mengembangkan IME untuk Wear, ingat bahwa fitur ini hanya didukung di Android 6.0 (API level 23) dan versi platform yang lebih tinggi. Untuk memastikan IME Anda hanya bisa diinstal di perangkat wearable yang mendukung metode masukan di luar suara, tambahkan kode berikut ke manifes aplikasi Anda: 

        <uses-sdk android:minSdkVersion="23" />

    Kode berikut menunjukkan bahwa aplikasi Anda memerlukan Android 6.0 atau yang lebih tinggi. Untuk informasi selengkapnya, lihat API Level dan dokumentasi untuk elemen <uses-sdk>.

  • Set fitur perangkat

    Untuk mengontrol bagaimana aplikasi Anda difilter dari perangkat yang tidak mendukung IME Wear (misalnya, di Ponsel), tambahkan kode berikut ke manifes aplikasi:

        <uses-feature android:required="true" android:name="android.hardware.type.watch" />

Memanggil metode masukan

Wear menyediakan setelan pengguna di jam tangan yang memungkinkan pengguna mengaktifkan beberapa IME dari daftar IME yang terinstal. Setelah mengaktifkan IME, pengguna dapat memanggil IME Anda dari:

  • Notifikasi atau aplikasi menggunakan RemoteInput API.
  • Aplikasi Wear dengan kolom EditText. Menyentuh kolom teks akan mengarahkan kursor ke dalamnya dan secara otomatis menampilkan IME dalam fokus.

Pertimbangan IME umum

Berikut adalah beberapa hal yang perlu dipertimbangkan saat mengimplementasikan IME untuk Wear:

  • Tetapkan tindakan default

    RemoteInput dan aplikasi Wear hanya mengharapkan entri teks baris tunggal. Tombol ENTER harus selalu memicu panggilan ke sendDefaultEditorAction, yang menyebabkan aplikasi menutup keyboard dan melanjutkan ke langkah atau tindakan berikutnya.

  • Gunakan IME mode layar penuh

    Metode masukan di Wear menggunakan hampir seluruh bagian layar dan hanya menyisakan sedikit bagian aplikasi yang terlihat. Penggunaan mode layar penuh akan memastikan pengalaman pengguna yang optimal apa pun UI aplikasi-nya. Dalam mode layar penuh, ExtractEditText menyediakan tampilan pencerminan kolom teks yang sedang diedit dan bisa ditata agar menyatu dengan metode masukan UI lainnya. Untuk selengkapnya tentang detail mode layar penuh, lihat InputMethodService.

  • Tangani tanda InputType

    Untuk alasan privasi, Anda setidaknya harus menangani tanda InputType TYPE_TEXT_VARIATION_PASSWORD di IME Anda. Ketika IME berada dalam mode sandi, pastikan keyboard telah dioptimalkan untuk penekanan tombol tunggal (pemeriksa ejaan otomatis, pelengkapan otomatis, dan masukan gestur dinonaktifkan). Lebih penting lagi, keyboard dalam mode sandi harus mendukung simbol ASCII terlepas dari bahasa masukan saat ini. Untuk detail selengkapnya, lihat Menentukan Jenis Metode Masukan.

  • Sediakan tombol untuk beralih ke metode masukan berikutnya

    Android memungkinkan pengguna untuk beralih dengan mudah di antara semua IME yang didukung oleh platform. Dalam implementasi IME Anda, setel boolean supportsSwitchingToNextInputMethod = true untuk memungkinkan IME mendukung mekanisme peralihan (sehingga aplikasi dapat beralih ke IME berikutnya yang didukung platform). Untuk mempelajari cara mengimplementasikan peralihan antar-IME selengkapnya, lihat Beralih di antara Subjenis IME.