Membuat editor metode input di Wear

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

Pengguna Wear OS bisa memilih berbagai opsi input dari Input Jarak Jauh. Opsi tersebut mencakup:

  • Dikte
  • Emoji
  • Template pesan
  • Smart Reply
  • IME default
Contoh metode input.
Gambar 1. Contoh metode input.

Wear OS dilengkapi dengan IME default sistem dan juga memungkinkan developer pihak ketiga membuat IME khusus. IME API yang digunakan untuk perangkat Wear OS sama dengan faktor bentuk lainnya, meskipun penggunaannya sedikit berbeda karena ukuran layar yang terbatas.

Dokumen ini memberikan panduan untuk membantu Anda membuat IME khusus Wear OS.

Membuat metode input untuk Wear

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

Filter IME khusus Wear OS

Untuk mempelajari cara membuat metode input pada Wear OS, ikuti panduan untuk membuat metode input di handset. Kemudian, tambahkan filter Google Play di bagian berikut ke file manifes untuk menjadikannya IME khusus Wear OS.

Level API

Jika Anda mengembangkan IME untuk Wear OS, ingat bahwa fitur ini hanya didukung di Android 6.0 (level API 23) dan versi lebih tinggi. Untuk memastikan IME Anda hanya dapat diinstal di perangkat wearable yang mendukung metode input di luar suara, tetapkan nilai minSdkVersion dalam file build.gradle.kts aplikasi Anda ke 23 atau yang lebih tinggi.

Set fitur perangkat

Untuk mengontrol cara memfilter aplikasi Anda dari perangkat yang tidak mendukung IME Wear OS, misalnya iPhone, tambahkan kode berikut ke manifes aplikasi Anda:

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

Memanggil metode input

Wear OS menyediakan setelan pengguna di smartwatch 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.

Pertimbangan IME umum

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

  • Menetapkan tindakan default.

    RemoteInput dan aplikasi Wear OS hanya memperkirakan entri teks baris tunggal. Selalu gunakan tombol Enter untuk memicu panggilan ke sendDefaultEditorAction, yang menyebabkan aplikasi menutup keyboard dan melanjutkan ke langkah atau tindakan berikutnya.

  • Menggunakan IME mode layar penuh.

    Metode input di Wear OS menutupi sebagian besar layar sehingga aplikasi yang terlihat sangat sedikit. Penggunaan mode layar penuh menawarkan pengalaman pengguna yang optimal, apa pun UI aplikasinya. Dalam mode layar penuh, ExtractedText memberikan tampilan pencerminan kolom teks yang sedang diedit dan dapat ditata agar selaras dengan metode input lainnya UI. Untuk detail mode layar penuh selengkapnya, lihat InputMethodService.

  • Menangani InputType flag.

    Setidaknya, untuk alasan privasi, tangani flag InputType TYPE_TEXT_VARIATION_PASSWORD di IME Anda. Ketika IME berada dalam mode sandi, pastikan keyboard telah dioptimalkan untuk penekanan tombol tunggal, yang berarti bahwa pemeriksa ejaan otomatis, pelengkapan otomatis, dan input gestur dinonaktifkan. Yang terpenting, keyboard dalam mode sandi harus mendukung simbol American Standard Code for Information Interchange (ASCII), apa pun bahasa inputnya. Untuk detail selengkapnya, lihat Menentukan jenis metode input.

  • Menyediakan tombol untuk beralih ke metode input berikutnya.

    Android memungkinkan pengguna beralih di antara semua IME yang didukung oleh platform. Dalam implementasi IME, tetapkan boolean supportsSwitchingToNextInputMethod ke true. Hal ini memungkinkan IME Anda mendukung mekanisme peralihan sehingga aplikasi dapat beralih ke IME berikutnya yang didukung oleh platform. Untuk mempelajari cara mengimplementasikan peralihan antar-IME selengkapnya, lihat Beralih di antara subjenis IME.