ویرایشگرهای روش ورودی را در Wear ایجاد کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Wear OS از روش‌های ورودی فراتر از صدا با گسترش چارچوب ویرایشگر روش ورودی Android (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 هستید، به یاد داشته باشید که این ویژگی فقط در Android 6.0 (سطح API 23) و بالاتر پشتیبانی می‌شود. برای اطمینان از اینکه IME شما فقط روی پوشیدنی‌هایی که از روش‌های ورودی فراتر از صدا پشتیبانی می‌کنند قابل نصب است، موارد زیر را به مانیفست برنامه خود اضافه کنید:
<uses-sdk android:minSdkVersion="23" />
مجموعه ویژگی های دستگاه
برای کنترل نحوه فیلتر شدن برنامه شما از دستگاه‌هایی که از Wear OS IME پشتیبانی نمی‌کنند، مانند iPhone، موارد زیر را به مانیفست برنامه خود اضافه کنید:
<uses-feature android:required="true" android:name="android.hardware.type.watch" />
یک روش ورودی را فراخوانی کنید
Wear OS تنظیمات کاربر را روی ساعت فراهم می‌کند که به کاربر اجازه می‌دهد چندین IME را از لیست IMEهای نصب شده فعال کند. هنگامی که کاربر IME شما را فعال کرد، می تواند IME شما را از مکان های زیر فراخوانی کند:
- یک اعلان یا یک برنامه با استفاده از RemoteInput API.
- برنامه های سیستم عامل را با قسمت
EditText بپوشید. لمس یک فیلد نوشتاری مکان نما را در فیلد قرار می دهد و به طور خودکار IME را روی فوکوس نشان می دهد.
ملاحظات عمومی IME
در اینجا مواردی وجود دارد که باید هنگام اجرای IME for Wear در نظر بگیرید:
- یک اقدام پیش فرض را تنظیم کنید.
برنامه‌های RemoteInput و Wear OS فقط انتظار دارند متن تک خطی وارد شوند. همیشه از کلید Enter برای راه‌اندازی تماس با sendDefaultEditorAction استفاده کنید، که باعث می‌شود برنامه صفحه‌کلید را حذف کند و به مرحله یا اقدام بعدی ادامه دهد.
- از یک IME در حالت تمام صفحه استفاده کنید.
روش‌های ورودی در Wear OS بیشتر صفحه را پوشش می‌دهند و مقدار کمی از برنامه قابل مشاهده است. استفاده از حالت تمام صفحه بدون در نظر گرفتن رابط کاربری برنامه، تجربه کاربری مطلوبی را ارائه می دهد. در حالت تمام صفحه، ExtractedText یک نمای آینه‌ای از فیلد متنی که در حال ویرایش است ارائه می‌کند و می‌تواند به گونه‌ای استایل‌بندی شود که با بقیه UI روش ورودی ترکیب شود. برای جزئیات بیشتر در مورد حالت تمام صفحه، InputMethodService را ببینید.
- پرچم های
InputType را کنترل کنید. حداقل، به دلایل حفظ حریم خصوصی، پرچم InputType TYPE_TEXT_VARIATION_PASSWORD را در IME خود مدیریت کنید. هنگامی که IME شما در حالت رمز عبور است، مطمئن شوید که صفحه کلید شما برای فشار دادن یک کلید بهینه شده است، به این معنی که تصحیح خودکار املا، تکمیل خودکار، و ورودی اشاره غیرفعال است. مهمتر از همه، صفحه کلید در حالت رمز عبور باید از نمادهای کد استاندارد آمریکایی برای تبادل اطلاعات (ASCII) بدون توجه به زبان ورودی پشتیبانی کند. برای جزئیات بیشتر، به تعیین نوع روش ورودی مراجعه کنید.
- کلیدی برای تغییر به روش ورودی بعدی ارائه دهید.
اندروید به کاربران اجازه می دهد بین تمام IME های پشتیبانی شده توسط پلتفرم جابجا شوند. در اجرای IME خود، supportsSwitchingToNextInputMethod بولین را روی true تنظیم کنید. این به IME شما امکان می‌دهد از مکانیسم سوئیچینگ پشتیبانی کند تا برنامه‌ها بتوانند به IME بعدی که از پلتفرم پشتیبانی می‌شود سوئیچ کنند. برای کسب اطلاعات بیشتر در مورد نحوه اجرای جابجایی بین IMEها، به جابجایی در میان انواع فرعی IME مراجعه کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Create input method editors on Wear\n\nWear OS supports input methods beyond voice by extending the\nAndroid input method editor (IME) framework. The IME framework provides support\nfor virtual, on-screen keyboards that let users input text in the form of\nkeyclicks, handwriting, or gestures.\n\n\nWear OS users can choose between various input options from Remote Input. These options include:\n\n- Dictation\n- Emoji\n- Canned responses\n- Smart Reply\n- Default IME\n\nCreate an input method for Wear\n\nThe Android platform provides a standard framework for creating IMEs. To create\na Wear-OS-specific IME, you need to optimize your IME for a wearable's limited screen size.\n\n### Wear-OS-specific IME filters\n\nTo learn how to create an input method for Wear OS, follow the guide to\n[create an input method](/guide/topics/text/creating-input-method) on handsets.\nThen add the Google Play filters in the following sections to your manifest file to make it a Wear-OS-specific IME.\n\n#### API level\n\nIf you are developing an IME for Wear OS, remember that the\nfeature is supported only on Android 6.0 (API level 23) and higher.\nTo ensure that your IME can be installed only on wearables that support input\nmethods beyond voice, add the following to your app's manifest: \n\n```xml\n\u003cuses-sdk android:minSdkVersion=\"23\" /\u003e\n```\n\n#### Device feature sets\n\nTo control how your app is filtered from devices that don't support\nWear OS IMEs, such as iPhones, add the following to your app's manifest: \n\n```xml\n\u003cuses-feature android:required=\"true\" android:name=\"android.hardware.type.watch\" /\u003e\n```\n\nInvoke an input method\n----------------------\n\nWear OS provides user settings on the watch that let the user enable multiple\nIMEs from the list of installed IMEs. Once the user enables your IME, they\ncan invoke your IME from the following places:\n\n- A notification or an app using the [RemoteInput](/reference/androidx/core/app/RemoteInput) API.\n- Wear OS apps with an [`EditText`](/reference/android/widget/EditText) field. Touching a text field places the cursor in the field and automatically displays the IME on focus.\n\nGeneral IME considerations\n--------------------------\n\nHere are some things to consider when implementing IME for Wear:\n\n- **Set a default action.**\n\n\n [`RemoteInput`](/reference/androidx/core/app/RemoteInput)\n and Wear OS apps expect only single-line text entry. Always use the \u003ckbd\u003eEnter\u003c/kbd\u003e key to trigger a call\n to\n [`sendDefaultEditorAction`](/reference/android/inputmethodservice/InputMethodService#sendDefaultEditorAction(boolean)),\n which causes the app to dismiss the keyboard and continue on to the next step or action.\n- **Use a full-screen-mode IME.**\n\n Input methods on Wear OS cover most of the screen, leaving very little of the\n app visible. Using full-screen mode offers an optimal user experience regardless of the\n app UI. In full-screen mode, an\n [`ExtractedText`](/reference/android/view/inputmethod/ExtractedText)\n provides a mirrored view of the text field being edited and can be styled to blend with the\n rest of the input method UI. For more details on full-screen mode, see\n [`InputMethodService`](/reference/android/inputmethodservice/InputMethodService).\n- **Handle `InputType` flags.**\n\n At a minimum, for privacy reasons, handle the\n [`InputType`](/reference/android/text/InputType)\n flag `TYPE_TEXT_VARIATION_PASSWORD` in your IME. When your IME is in\n password mode, make sure that your keyboard is optimized for single key press,\n meaning that auto spelling correction, auto completion, and gesture input are disabled.\n Most importantly, the keyboard in password mode must support American Standard Code for Information Interchange (ASCII) symbols\n regardless of the input language. For more details, see\n [Specify the input method type](/training/keyboard-input/style).\n- **Provide a key for switching to the next input method.**\n\n Android lets users switch between all IMEs supported by the platform.\n In your IME implementation, set the boolean\n [`supportsSwitchingToNextInputMethod`](/guide/topics/text/creating-input-method#Switching) to `true`.\n This lets your IME support the switching mechanism so that apps can switch to the next\n platform-supported IME. To learn more about how to implement switching between IMEs, see\n [Switching among IME subtypes](/guide/topics/text/creating-input-method#Switching)."]]
