Wear'da giriş yöntemi düzenleyicileri oluşturma

Wear OS, Android giriş yöntemi düzenleyici (IME) çerçevesini genişleterek sesin ötesinde giriş yöntemlerini destekler. IME çerçevesi, kullanıcıların tuş tıklamaları, el yazısı veya hareketler şeklinde metin girmesine olanak tanıyan sanal, ekran klavyeleri için destek sağlar.

Wear OS kullanıcıları, Uzaktan Giriş'teki çeşitli giriş seçenekleri arasından seçim yapabilir. Bu seçenekler şunlardır:

• Dikte
• Emoji
• Hazır yanıtlar
• Akıllı Yanıt
• Varsayılan IME

Wear OS'te varsayılan bir sistem IME'si bulunur ve üçüncü taraf geliştiricilerin özel IME'ler oluşturmasına da olanak tanınır. Wear OS cihazlarda kullanılan IME API'leri, diğer form faktörlerinde kullanılanlarla aynıdır. Ancak sınırlı ekran boyutu nedeniyle kullanım biraz farklıdır.

Bu belge, Wear OS'e özel bir IME oluşturmanıza yardımcı olacak yönergeler içerir.

Wear için giriş yöntemi oluşturma

Android platformu, IME'ler oluşturmak için standart bir çerçeve sağlar. Wear OS'e özel bir IME oluşturmak için IME'nizi giyilebilir cihazların sınırlı ekran boyutuna göre optimize etmeniz gerekir.

Wear OS'e özel IME filtreleri

Wear OS için giriş yöntemi oluşturmayı öğrenmek üzere cep telefonlarında giriş yöntemi oluşturma kılavuzunu inceleyin. Ardından, Wear OS'e özel bir IME yapmak için aşağıdaki bölümlerdeki Google Play filtrelerini manifest dosyanıza ekleyin.

API seviyesi

Wear OS için bir IME geliştiriyorsanız bu özelliğin yalnızca Android 6.0 (API düzeyi 23) ve sonraki sürümlerde desteklendiğini unutmayın. IME'nizin yalnızca sesin ötesinde giriş yöntemlerini destekleyen giyilebilir cihazlara yüklenebilmesini sağlamak için uygulamanızın build.gradle.kts dosyasındaki minSdkVersion değerini 23 veya daha yüksek bir değere ayarlayın.

Cihaz özelliği grupları

Uygulamanızın, Wear OS IME'lerini desteklemeyen cihazlarda (ör. iPhone) nasıl filtreleneceğini kontrol etmek için uygulamanızın manifest dosyasına aşağıdakileri ekleyin:

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

Giriş yöntemini çağırma

Wear OS, kullanıcıya yüklü IME'ler listesinden birden fazla IME'yi etkinleştirmesine olanak tanıyan, saatteki kullanıcı ayarlarını sunar. Kullanıcı IME'nizi etkinleştirdikten sonra RemoteInput API'sini kullanarak bir bildirimden veya uygulamadan IME'nizi çağırabilir.

Genel IME ile ilgili dikkat edilmesi gereken noktalar

Wear için IME'yi uygularken dikkat etmeniz gereken bazı noktalar:

• Varsayılan bir işlem ayarlayın.

  RemoteInput ve Wear OS uygulamaları yalnızca tek satırlık metin girişi bekler. Enter tuşunu her zaman bir çağrıyı tetiklemek için kullanın to sendDefaultEditorAction, Bu işlem, uygulamanın klavyeyi kapatmasına ve sonraki adıma veya işleme devam etmesine neden olur.

• Tam ekran modunda IME kullanma

  Wear OS'teki giriş yöntemleri ekranın büyük bir kısmını kapladığından uygulamanın çok az bir kısmı görünür kalıyor. Tam ekran modunu kullanmak, uygulama kullanıcı arayüzünden bağımsız olarak optimum kullanıcı deneyimi sunar. Tam ekran modunda, düzenlenmekte olan metin alanının yansıtılmış görünümünü sağlayan bir ExtractedText bulunur. Bu görünüm, giriş yöntemi kullanıcı arayüzünün geri kalanıyla uyumlu olacak şekilde stillendirilebilir. Tam ekran modu hakkında daha fazla bilgi için InputMethodService başlıklı makaleyi inceleyin.

• Herkese açık kullanıcı adı InputType işaretleri.

  Gizlilik nedeniyle, IME'nizde en azından InputType TYPE_TEXT_VARIATION_PASSWORD işaretini işleyin. IME'niz şifre modundayken klavyenizin tek tuşla basma için optimize edildiğinden emin olun. Bu durumda, otomatik yazım düzeltme, otomatik tamamlama ve hareketle giriş devre dışı bırakılır. En önemlisi, şifre modundaki klavye, giriş dilinden bağımsız olarak American Standard Code for Information Interchange (ASCII) sembollerini desteklemelidir. Daha fazla bilgi için Giriş yöntemi türünü belirtme başlıklı makaleyi inceleyin.

• Sonraki giriş yöntemine geçmek için bir tuş sağlayın.

  Android, kullanıcıların platform tarafından desteklenen tüm IME'ler arasında geçiş yapmasına olanak tanır. IME uygulamanızda, boolean supportsSwitchingToNextInputMethod değerini true olarak ayarlayın. Bu, uygulamaların bir sonraki platform destekli IME'ye geçebilmesi için IME'nizin geçiş mekanizmasını desteklemesini sağlar. IME'ler arasında geçiş yapmayı uygulama hakkında daha fazla bilgi edinmek için IME alt türleri arasında geçiş yapma başlıklı makaleyi inceleyin.