ویرایشگرهای روش ورودی را در Wear ایجاد کنید

Wear OS با گسترش چارچوب ویرایشگر روش ورودی اندروید (IME) از روش‌های ورودی فراتر از صدا پشتیبانی می‌کند. چارچوب IME از صفحه کلیدهای مجازی روی صفحه پشتیبانی می‌کند که به کاربران اجازه می‌دهد متن را به شکل کلیک روی کلید، دست خط یا حرکات وارد کنند.

کاربران Wear OS می‌توانند از بین گزینه‌های ورودی مختلف از Remote Input یکی را انتخاب کنند. این گزینه‌ها عبارتند از:

  • دیکته
  • ایموجی
  • پاسخ‌های از پیش آماده
  • پاسخ هوشمند
  • IME پیش‌فرض

یک متد ورودی برای Wear ایجاد کنید

پلتفرم اندروید یک چارچوب استاندارد برای ایجاد IMEها ارائه می‌دهد. برای ایجاد یک IME مخصوص Wear-OS، باید IME خود را برای اندازه صفحه نمایش محدود دستگاه پوشیدنی بهینه کنید.

فیلترهای IME مخصوص Wear OS

برای یادگیری نحوه ایجاد یک روش ورودی برای Wear OS، راهنمای ایجاد یک روش ورودی در گوشی‌ها را دنبال کنید. سپس فیلترهای Google Play را در بخش‌های بعدی به فایل مانیفست خود اضافه کنید تا آن را به یک IME مخصوص Wear-OS تبدیل کنید.

سطح API

اگر در حال توسعه یک IME برای Wear OS هستید، به یاد داشته باشید که این ویژگی فقط در اندروید ۶.۰ (سطح API ۲۳) و بالاتر پشتیبانی می‌شود. برای اطمینان از اینکه IME شما فقط روی دستگاه‌های پوشیدنی که از روش‌های ورودی فراتر از صدا پشتیبانی می‌کنند، قابل نصب است، مقدار minSdkVersion را در فایل build.gradle.kts برنامه خود روی 23 یا بالاتر تنظیم کنید.

مجموعه ویژگی‌های دستگاه

برای کنترل نحوه فیلتر شدن برنامه‌تان از دستگاه‌هایی که از Wear OS IMEs پشتیبانی نمی‌کنند، مانند آیفون‌ها، موارد زیر را به مانیفست برنامه‌تان اضافه کنید:

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

فراخوانی یک متد ورودی

Wear OS تنظیمات کاربری را در ساعت ارائه می‌دهد که به کاربر اجازه می‌دهد چندین IME را از لیست IMEهای نصب شده فعال کند. هنگامی که کاربر IME خود را فعال کرد، می‌تواند IME شما را از طریق یک اعلان یا یک برنامه با استفاده از RemoteInput API فراخوانی کند.

ملاحظات عمومی IME

هنگام پیاده‌سازی IME برای Wear، نکات زیر را در نظر بگیرید:

  • یک اقدام پیش‌فرض تنظیم کنید.

    برنامه‌های RemoteInput و Wear OS فقط ورودی متن تک‌خطی را می‌پذیرند. همیشه از کلید Enter برای فراخوانی sendDefaultEditorAction استفاده کنید، که باعث می‌شود برنامه صفحه‌کلید را غیرفعال کرده و به مرحله یا اقدام بعدی ادامه دهد.

  • از یک IME تمام صفحه استفاده کنید.

    روش‌های ورودی در Wear OS بیشتر صفحه را می‌پوشانند و بخش بسیار کمی از برنامه قابل مشاهده است. استفاده از حالت تمام صفحه، صرف نظر از رابط کاربری برنامه، تجربه کاربری بهینه‌ای را ارائه می‌دهد. در حالت تمام صفحه، ExtractedText نمای آینه‌ای از فیلد متنی که ویرایش می‌شود را ارائه می‌دهد و می‌تواند به گونه‌ای طراحی شود که با بقیه رابط کاربری روش ورودی ترکیب شود. برای جزئیات بیشتر در مورد حالت تمام صفحه، به InputMethodService مراجعه کنید.

  • مدیریت پرچم‌های InputType .

    حداقل، به دلایل حفظ حریم خصوصی، پرچم InputType TYPE_TEXT_VARIATION_PASSWORD در IME خود مدیریت کنید. وقتی IME شما در حالت رمز عبور است، مطمئن شوید که صفحه کلید شما برای فشار دادن تک کلید بهینه شده است، به این معنی که تصحیح املای خودکار، تکمیل خودکار و ورودی حرکتی غیرفعال هستند. مهمتر از همه، صفحه کلید در حالت رمز عبور باید صرف نظر از زبان ورودی، از نمادهای کد استاندارد آمریکایی برای تبادل اطلاعات (ASCII) پشتیبانی کند. برای جزئیات بیشتر، به Specify the input method type مراجعه کنید.

  • یک کلید برای تغییر به روش ورودی بعدی ارائه دهید.

    اندروید به کاربران اجازه می‌دهد بین تمام IMEهای پشتیبانی‌شده توسط پلتفرم، جابه‌جا شوند. در پیاده‌سازی IME خود، مقدار بولی supportsSwitchingToNextInputMethod را روی true تنظیم کنید. این به IME شما اجازه می‌دهد از مکانیزم جابه‌جایی پشتیبانی کند تا برنامه‌ها بتوانند به IME بعدی که توسط پلتفرم پشتیبانی می‌شود، جابه‌جا شوند. برای کسب اطلاعات بیشتر در مورد نحوه پیاده‌سازی جابه‌جایی بین IMEها، به بخش جابه‌جایی بین زیرگروه‌های IME مراجعه کنید.