تتيح Wear OS أساليب إدخال أخرى غير الصوت من خلال توسيع إطار عمل محرر أسلوب الإدخال (IME) في Android. يتيح إطار عمل IME استخدام لوحات المفاتيح الافتراضية التي تظهر على الشاشة والتي تتيح للمستخدمين إدخال النص في شكل نقرات على المفاتيح أو كتابة بخط اليد أو إيماءات.
يمكن لمستخدمي Wear OS الاختيار من بين خيارات إدخال متنوعة من خلال ميزة "الإدخال عن بُعد". تتضمن هذه الخيارات:
- الإملاء
- رموز الإيموجي
- الردود الجاهزة
- الرد السريع
- أداة IME الافتراضية
يتضمّن نظام التشغيل Wear OS طريقة إدخال IME تلقائية، كما يتيح للمطوّرين الخارجيين إنشاء طرق إدخال IME مخصّصة. إنّ واجهات برمجة التطبيقات الخاصة بمحرّرات طرق الإدخال المستخدَمة لأجهزة Wear OS هي نفسها المستخدَمة لأشكال الأجهزة الأخرى، على الرغم من أنّ الاستخدام يختلف قليلاً بسبب حجم الشاشة المحدود.
يقدّم هذا المستند إرشادات لمساعدتك في إنشاء أداة IME مخصّصة لنظام التشغيل Wear OS.
إنشاء طريقة إدخال لتطبيقات Wear
يوفر نظام Android الأساسي إطار عمل عاديًا لإنشاء طرق إدخال. لإنشاء طريقة إدخال خاصة بنظام التشغيل Wear OS، عليك تحسين طريقة الإدخال لتناسب حجم الشاشة المحدود على الأجهزة القابلة للارتداء.
فلاتر IME خاصة بنظام التشغيل Wear OS
للتعرّف على كيفية إنشاء طريقة إدخال لنظام التشغيل Wear OS، اتّبِع دليل إنشاء طريقة إدخال على الهواتف. بعد ذلك، أضِف فلاتر Google Play في الأقسام التالية إلى ملف البيان لجعله طريقة إدخال خاصة بنظام التشغيل Wear OS.
مستوى واجهة برمجة التطبيقات
إذا كنت بصدد تطوير طريقة إدخال (IME) لنظام التشغيل Wear OS، تذكَّر أنّ هذه الميزة لا تتوفّر إلا على الإصدار 6.0 من نظام التشغيل Android (المستوى 23 من واجهة برمجة التطبيقات) والإصدارات الأحدث.
لضمان عدم إمكانية تثبيت محرر أسلوب الإدخال إلا على الأجهزة القابلة للارتداء التي تتيح استخدام طرق إدخال أخرى غير الصوت، اضبط القيمة minSdkVersion في ملف build.gradle.kts الخاص بتطبيقك على 23 أو أعلى.
مجموعات ميزات الأجهزة
للتحكّم في طريقة فلترة تطبيقك من الأجهزة التي لا تتوافق مع أدوات تحرير طريقة الإدخال في Wear OS، مثل هواتف iPhone، أضِف ما يلي إلى بيان تطبيقك:
<uses-feature android:required="true" android:name="android.hardware.type.watch" />
استدعاء طريقة إدخال
توفّر Wear OS إعدادات للمستخدم على الساعة تتيح له تفعيل أدوات إدخال متعددة من قائمة أدوات الإدخال المثبَّتة. بعد أن يفعّل المستخدم أداة IME الخاصة بك، يمكنه استدعاء أداة IME من إشعار أو تطبيق باستخدام واجهة برمجة التطبيقات RemoteInput.
اعتبارات عامة بشأن أداة IME
في ما يلي بعض الأمور التي يجب مراعاتها عند تنفيذ IME على Wear:
- تحديد إجراء تلقائي
RemoteInputوتتوقّع تطبيقات Wear OS إدخال نص من سطر واحد فقط. استخدِم مفتاح Enter دائمًا لتفعيل مكالمة إلىsendDefaultEditorAction، ما يؤدي إلى إغلاق التطبيق للوحة المفاتيح والمتابعة إلى الخطوة أو الإجراء التالي. - استخدام محرر أسلوب إدخال (IME) في وضع ملء الشاشة
تغطي طرق الإدخال على Wear OS معظم مساحة الشاشة، ما يترك مساحة صغيرة جدًا من التطبيق مرئية. يوفّر استخدام وضع ملء الشاشة تجربة مثالية للمستخدم بغض النظر عن واجهة مستخدم التطبيق. في وضع ملء الشاشة، يوفّر
ExtractedTextعرضًا معكوسًا لحقل النص الذي يتم تعديله ويمكن تنسيقه ليتناسب مع بقية واجهة مستخدم أسلوب الإدخال. لمزيد من التفاصيل حول وضع ملء الشاشة، يُرجى الاطّلاع علىInputMethodService. - علامات
InputTypeالاسم المعرِّفكحد أدنى، ولأسباب تتعلّق بالخصوصية، يجب التعامل مع العلامة
InputTypeTYPE_TEXT_VARIATION_PASSWORDفي محرر أسلوب الإدخال. عندما يكون محرر أسلوب الإدخال في وضع كلمة المرور، تأكَّد من أنّ لوحة المفاتيح محسّنة للضغط على مفتاح واحد، ما يعني أنّه تم إيقاف التصحيح التلقائي للأخطاء الإملائية والإكمال التلقائي والإدخال بالإيماءات. والأهم من ذلك، يجب أن تتوافق لوحة المفاتيح في وضع كلمة المرور مع رموز معيار التبادل الأمريكي للمعلومات (ASCII) بغض النظر عن لغة الإدخال. لمزيد من التفاصيل، يُرجى الاطّلاع على تحديد نوع طريقة الإدخال. - توفير مفتاح للتبديل إلى أسلوب الإدخال التالي
يتيح نظام التشغيل Android للمستخدمين التبديل بين جميع طرق الإدخال (IME) المتوافقة مع النظام الأساسي. في عملية تنفيذ أداة IME، اضبط القيمة المنطقية
supportsSwitchingToNextInputMethodعلىtrue. يتيح ذلك لبرنامج IME دعم آلية التبديل كي تتمكّن التطبيقات من التبديل إلى برنامج IME التالي المتوافق مع النظام الأساسي. لمزيد من المعلومات حول كيفية تنفيذ التبديل بين أدوات IME، يُرجى الاطّلاع على التبديل بين الأنواع الفرعية لأدوات IME.