יצירת עורכים לשיטות קלט ב-Wear

מערכת Wear OS תומכת בשיטות קלט מעבר לקלט קולי, על ידי הרחבת מסגרת עורך שיטות הקלט (IME) של Android. מסגרת ה-IME מספקת תמיכה במקלדות וירטואליות במסך שמאפשרות למשתמשים להזין טקסט בצורה של הקשות על מקשים, כתב יד או תנועות.

משתמשי Wear OS יכולים לבחור בין אפשרויות קלט שונות מתוך 'קלט מרחוק'. אפשרויות אלה כוללות:

• הכתבה
• אמוג'י
• תגובות מוכנות מראש
• תשובה מהירה
• ה-IME שמוגדר כברירת מחדל

ל-Wear OS יש IME שמוגדר כברירת מחדל במערכת, והיא גם מאפשרת למפתחי צד שלישי ליצור IME בהתאמה אישית. ממשקי ה-API של IME שמשמשים למכשירי WearOS זהים לאלה שמשמשים לגורמי צורה אחרים, אבל השימוש בהם שונה מעט בגלל גודל המסך המוגבל.

במסמך הזה מוסבר איך ליצור IME ספציפי ל-Wear OS.

יצירת שיטת קלט ל-Wear

פלטפורמת Android מספקת מסגרת סטנדרטית ליצירת IME. כדי ליצור IME ספציפי ל-WearOS, צריך לבצע אופטימיזציה של ה-IME לגודל המסך המוגבל של מכשיר לביש.

מסנני IME ספציפיים ל-Wear OS

כדי ללמוד איך ליצור שיטת קלט ל-Wear OS, אפשר לעיין במדריך בנושא יצירת שיטת קלט לטלפונים. לאחר מכן, מוסיפים את המסננים של Google Play בקטעים הבאים לקובץ המניפסט כדי להפוך אותו ל-IME ספציפי ל-WearOS.

רמת ממשק API:

אם אתם מפתחים IME ל-Wear OS, חשוב לזכור שהתכונה נתמכת רק ב-Android מגרסה 6.0 (רמת API‏ 23) ומעלה. כדי לוודא שאפשר להתקין את ה-IME רק במכשירים לבישים שתומכים בשיטות קלט מעבר לקלט קולי, צריך להגדיר את הערך minSdkVersion בקובץ build.gradle.kts של האפליקציה ל-23 או לערך גבוה יותר.

קבוצות של תכונות מכשיר

כדי לקבוע איך האפליקציה שלכם מסוננת ממכשירים שלא תומכים ב-IME של Wear OS, כמו אייפונים, מוסיפים את השורות הבאות למניפסט של האפליקציה:

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

הפעלת שיטת קלט

מערכת Wear OS מספקת הגדרות משתמש בשעון שמאפשרות למשתמש להפעיל כמה שיטות קלט מתוך רשימת שיטות הקלט המותקנות. אחרי שהמשתמש מפעיל את ה-IME, הוא יכול להפעיל אותו מהתראה או מאפליקציה באמצעות RemoteInput API.

שיקולים כלליים לגבי IME

כמה דברים שכדאי לזכור כשמטמיעים IME ל-Wear:

• הגדרת פעולת ברירת מחדל

  RemoteInput ואפליקציות Wear OS מצפות להזנת טקסט בשורה אחת בלבד. כדי להפעיל שיחה ב- sendDefaultEditorAction, תמיד משתמשים במקש Enter. כך האפליקציה תסגור את המקלדת ותמשיך לשלב או לפעולה הבאים.

• משתמשים ב-IME במצב מסך מלא.

  שיטות הקלט ב-Wear OS מכסות את רוב המסך, כך שרק חלק קטן מהאפליקציה נראה. שימוש במצב מסך מלא מאפשר חוויית משתמש אופטימלית ללא קשר לממשק המשתמש של האפליקציה. במצב מסך מלא, ExtractedText מספק תצוגה משוקפת של שדה הטקסט שנערך, ואפשר לעצב אותו כך שיתאים לשאר ממשק המשתמש של שיטת הקלט. פרטים נוספים על מצב מסך מלא זמינים במאמר בנושא InputMethodService.

• טיפול בדגלים InputType.

  מטעמי פרטיות, צריך לטפל בדגל InputType TYPE_TEXT_VARIATION_PASSWORD ב-IME. כשמקלדת ה-IME במצב סיסמה, צריך לוודא שהמקלדת מותאמת ללחיצה על מקש יחיד, כלומר שההשלמה האוטומטית, התיקון האוטומטי של האיות והזנת המחוות מושבתים. הכי חשוב, המקלדת במצב סיסמה צריכה לתמוך בסמלים של American Standard Code for Information Interchange ‏ (ASCII) ללא קשר לשפת הקלט. פרטים נוספים זמינים במאמר בנושא ציון סוג שיטת הקלט.

• מציינים מקש למעבר לשיטת הקלט הבאה.

  ב-Android, המשתמשים יכולים לעבור בין כל שיטות ה-IME שנתמכות בפלטפורמה. בהטמעה של ה-IME, מגדירים את הערך הבוליאני supportsSwitchingToNextInputMethod ל-true. כך עורך שיטות הקלט (IME) יכול לתמוך במנגנון המעבר, כדי שאפליקציות יוכלו לעבור ל-IME הבא שנתמך בפלטפורמה. מידע נוסף על הטמעה של מעבר בין שיטות קלט זמין במאמר בנושא מעבר בין סוגי משנה של IME.