"مساعد Google" على نظام التشغيل Wear OS

توفّر المساعدات الصوتية في الساعة سيناريوهات سريعة وفعّالة أثناء التنقل. تكون التفاعلات الصوتية على الأجهزة القابلة للارتداء ديناميكية، ما يعني أنّ المستخدم قد يتحدث إلى معصمه بدون الحاجة إلى النظر إلى الجهاز أثناء انتظار الردّ.

باستخدام "إجراءات التطبيقات مع مساعد Google"، يمكن لمطوّري البرامج المتوافقة مع Android توسيع نطاق تطبيقات Wear OS ليشمل "مساعد Google" وميزة إعادة توجيه المستخدمين إلى تطبيقاتهم سريعًا باستخدام طلبات صوتية، مثل "Ok Google، أريد تشغيل الركض على ExampleApp".

القيود

يدعم "مساعد Google" على Wear OS التفاعلات مع الأنشطة في تتبُّع الوسائط والتمارين. للحصول على إرشادات حول دمج تطبيقات الوسائط مع "مساعد Google"، يمكنك الاطّلاع على مساعد Google وتطبيقات الوسائط. تتوافق السمات التالية للصحة واللياقة البدنية مع تطبيقات Wear OS:

• START_EXERCISE
• STOP_EXERCISE
• PAUSE_EXERCISE
• RESUME_EXERCISE

طريقة العمل

توسّع "المهام في التطبيقات" وظائف التطبيق لتشمل "مساعد Google"، ما يتيح للمستخدمين الوصول إلى ميزات التطبيق بسرعة باستخدام أصواتهم. عندما يشير مستخدم إلى "مساعد Google" بأنّه يريد استخدام تطبيقك، يبحث "مساعد Google" عن "إجراءات في التطبيقات" مسجّلة في تطبيقك في مورد shortcuts.xml الخاص بالتطبيق.

يتم توضيح الإجراءات في التطبيقات في shortcuts.xml مع عناصر إمكانية Android. تعمل عناصر الإمكانية على إقران الأغراض المضمّنة (BII)، وهي أوصاف دلالية لإحدى ميزات التطبيق، مع تعليمات التنفيذ، مثل نموذج رابط لصفحة في التطبيق. عند تحميل تطبيقك باستخدام Google Play Console، تسجِّل Google الإمكانات الموضَّحة في shortcuts.xml، ما يتيح للمستخدمين تشغيلها من خلال "مساعد Google".

يوضح المخطّط السابق للمستخدِم إيقاف التمرين مؤقتًا في تطبيق مستقل. وتحدث الخطوات التالية:

1. يرسِل المستخدم طلبًا صوتيًا إلى "مساعد Google" الخاص بالتطبيق المحدّد القابل للارتداء.
2. يطابق "مساعد Google" الطلب بنموذج مدرَّب مسبقًا (BII)، ويستخرج أي معلَمات موجودة في الطلب تكون متوافقة مع BII.
3. في المثال، يطابق المساعد طلب البحث مع PAUSE_EXERCISE BII، ويستخرج مَعلمة اسم التمرين "hike".
4. يتم تشغيل التطبيق من خلال تعريف تنفيذ إمكانات shortcuts.xml لمعيار BII هذا.
5. يعالج التطبيق عملية التنفيذ، ويتم إيقاف التمرين مؤقتًا.

إمكانية الاتصال

يختلف تطوير "المهام في التطبيقات" وفقًا لوظائف تطبيقك ضمن المنظومة المتكاملة للأجهزة التي تعمل بنظام التشغيل Android.

• مربوط بالإنترنت: عندما يعتمد تطبيق الأجهزة القابلة للارتداء على التطبيق المتوافق مع الأجهزة الجوّالة لأداء وظائفه الكاملة، يتم تنفيذ طلبات المستخدمين التي يجريها المستخدمون على "مساعد Google" من خلال الساعة على الجهاز الجوّال. يجب دمج منطق تنفيذ إجراءات التطبيقات في تطبيق الأجهزة الجوّالة حتى يعمل هذا السيناريو بشكل صحيح.

• بدون ربط: عندما يكون تطبيق الأجهزة القابلة للارتداء مستقلاً عن وظائف التطبيقات المتوافقة مع الأجهزة الجوّالة، ينفّذ "مساعد Google" طلبات المستخدمين محليًا على الساعة. يجب دمج إمكانات إجراءات التطبيق في تطبيق الأجهزة القابلة للارتداء لتلبية هذه الطلبات بشكل صحيح.

إضافة الميزات الصوتية إلى Wear OS

يمكنك دمج "إجراءات التطبيق" مع تطبيق Wear OS باتّباع الخطوات التالية:

1. يجب مطابقة الوظائف داخل التطبيق التي تريد تفعيلها باستخدام مفتاح BII مطابق.

2. يجب الإفصاح عن إتاحة اختصارات Android في مورد النشاط الرئيسي AndroidManifest.xml.

   <!-- AndroidManifest.xml -->
   <meta-data
       android:name="android.app.shortcuts"
       android:resource="@xml/shortcuts" />
   

3. إضافة عنصر <intent-filter> إلى ملف AndroidManifest.xml يتيح ذلك لخدمة "مساعد Google" استخدام روابط لصفحات في التطبيق لربطها بمحتوى التطبيق.

4. أنشئ ملف shortcuts.xml لتوفير تفاصيل تنفيذ BII. يمكنك استخدام عناصر اختصارات capability لإعلام "مساعد Google" بتوفّرها في تطبيقك. للمزيد من المعلومات، يُرجى الاطّلاع على إضافة الإمكانيات.

5. في shortcuts.xml، يمكنك تنفيذ إمكانية لثنائية الأعمال التي اخترتها. يوضِّح النموذج التالي إمكانية استخدام ملحق START_EXERCISE BII:

   <?xml version="1.0" encoding="utf-8"?>
   <!-- This is a sample shortcuts.xml -->
   <shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
     <capability android:name="actions.intent.START_EXERCISE">
       <intent
         android:action="android.intent.action.VIEW"
         android:targetPackage="YOUR_UNIQUE_APPLICATION_ID"
         android:targetClass="YOUR_TARGET_CLASS">
         <!-- Eg. name = "Running" -->
         <parameter
           android:name="exercise.name"
           android:key="name"/>
         <!-- Eg. duration = "PT1H" -->
         <parameter
           android:name="exercise.duration"
           android:key="duration"/>
       </intent>
     </capability>
   </shortcuts>
   

6. إن أمكن، وسِّع نطاق إتاحة صيغ كلام المستخدم المختلفة باستخدام مستودع مضمّن يمثّل الميزات والمحتوى في تطبيقك.

   <capability android:name="actions.intent.START_EXERCISE">
     <intent
       android:targetPackage="com.example.myapp"
       android:targetClass="com.example.myapp.ExerciseActivity">
       <parameter android:name="exercise.name" android:key="exercise" />
     </intent>
   </capability>
   
   <shortcut android:shortcutId="CARDIO_RUN">
     <capability-binding android:key="actions.intent.START_EXERCISE">
       <parameter-binding
         android:key="exercise.name"
         android:value="@array/run_names" />
       </capability-bindig>
   </shortcut>
   

7. يُرجى تعديل منطق تطبيقك للتعامل مع تنفيذ إجراءات التطبيقات الواردة.

   //FitMainActivity.kt
   
   private fun handleIntent(data: Uri?) {
       var actionHandled = true
       val startExercise = intent?.extras?.getString(START_EXERCISE)
   
       if (startExercise != null){
           val type = FitActivity.Type.find(startExercise)
           val arguments = Bundle().apply {
               putSerializable(FitTrackingFragment.PARAM_TYPE, type)
           }
           updateView(FitTrackingFragment::class.java, arguments)
       }
       else{
           showDefaultView()
           actionHandled = false
       }
       notifyActionSuccess(actionHandled)
   }
   

معاينة تطبيقك واختباره ونشره

توفر "المهام في التطبيقات" أدوات لمراجعة تطبيقك واختباره. للحصول على معلومات أكثر تفصيلاً، يمكنك الاطّلاع على مكوّن "مساعد Google" الإضافي في "استوديو Android". بعد اختبار تطبيقك وإنشاء إصدار تجريبي، يمكنك طلب مراجعة الإجراءات في التطبيقات ونشرها. راجع أفضل الممارسات التالية للحصول على إرشادات حول التعامل مع الأخطاء الشائعة.

أفضل الممارسات

تقديم تجربة إيجابية للمستخدم عند دمج تطبيقك مع "مساعد Google" من خلال اتّباع أفضل الممارسات المقترَحة

اعرض شاشة تأكيد مقابلة أو ذات صلة، بالإضافة إلى تقنية اللمس والملاحظات الصوتية، للاستجابة لطلب المستخدم - إما عند تنفيذ الطلب بنجاح أو للتنبيه بخطأ.

جودة أساسية	جودة أفضل	أفضل جودة
إنشاء هدف لبدء ConfirmationActivity من أحد الأنشطة	إنشاء هدف لبدء ConfirmationActivity من أحد الأنشطة عليك تشغيل رنين وملاحظات حسّية للإشارة إلى الحالة الراهنة.	إنشاء هدف لبدء ConfirmationActivity من أحد الأنشطة تقنية تحويل النص إلى كلام (TTS) والملاحظات الملموسة للإشارة إلى الخطأ أو النجاح.

الأخطاء الشائعة والحلول

في حالات الخطأ التالية، استخدِم تطبيق مراسلة ConfirmationActivity المقترَح التالي.

حالة الخطأ	مثال على تفاعل المستخدم	استجابة التطبيق
النشاط مستمر	"بدء ExerciseName" "استئناف ExerciseName"	حدث خطأ في العرض: نشاط جارٍ حاليًا.
لم يبدأ أي نشاط	"إيقاف مؤقت/إيقاف ExerciseName"	خطأ في العرض: "لم يبدأ أي نشاط".
عدم تطابق أنواع الأنشطة	"إيقاف مؤقت/إيقاف ExerciseName"، وهو نوع تمرين مختلف عن النشاط الجاري.	خطأ في العرض: "نوع النشاط غير متطابق".
خطأ في تسجيل الدخول	"بدء ExerciseName"، عندما لا يكون المستخدم مسجّلاً الدخول إلى التطبيق.	يُرجى تشغيل تقنية اللمس لتنبيه المستخدم وإعادة التوجيه إلى شاشة تسجيل الدخول.
خطأ في الأذونات	لا يملك المستخدم الإذن ببدء نشاطه المطلوب.	يُرجى تشغيل تقنية اللمس لتنبيه المستخدم وإعادة التوجيه إلى شاشة طلب الإذن.
مشكلة في جهاز الاستشعار	إيقاف خدمات الموقع الجغرافي في إعدادات الجهاز لدى المستخدم.	يُرجى تشغيل تقنية اللمس لتنبيه المستخدمين وعرض شاشة خطأ أداة الاستشعار. الخطوات التالية الاختيارية: بدء النشاط بدون تتبُّع أداة الاستشعار وإشعار المستخدم عليك طلب إقرار المستخدم لبدء النشاط بدون تتبُّع أداة الاستشعار.

---