يتيح "مساعد Google" التحكّم باستخدام ميزة إعادة توجيه الصوت في تطبيقات Android. وباستخدام "مساعد Google"، يمكن للمستخدمين تشغيل التطبيقات وتنفيذ المهام والوصول إلى المحتوى وغير ذلك باستخدام أصواتهم ليقولوا عبارات مثل "Ok Google، أريد تشغيل تشغيل على "example App".
بصفتك مطوّر برامج Android، يمكنك استخدام إطار عمل التطوير وأدوات الاختبار في "مساعد Google" لتفعيل التحكّم الصوتي العميق في تطبيقاتك بسهولة على الأسطح التي تعمل بنظام التشغيل Android، مثل الأجهزة الجوّالة والسيارات والأجهزة القابلة للارتداء.
مهامّ في التطبيقات
تتيح "إجراءات التطبيقات" في "مساعد Google" للمستخدمين تشغيل تطبيقات Android والتحكّم فيها باستخدام أصواتهم.
تمكّن "إجراءات التطبيقات" من التحكم الصوتي بشكل أعمق، ما يتيح للمستخدمين تشغيل التطبيقات وتنفيذ المهام مثل:
- إطلاق الميزات من "مساعد Google": تربط إمكانات تطبيقك بطلبات بحث المستخدمين التي تتطابق مع الأنماط الدلالية المحدّدة مسبقًا أو الأهداف المضمَّنة.
- عرض معلومات التطبيق على مساحات عرض Google: يمكنك توفير تطبيقات Android المصغّرة التي يمكن لخدمة "مساعد Google" عرضها، مع توفير إجابات مضمّنة وتأكيدات بسيطة وتفاعلات مختصرة مع المستخدمين بدون تغيير السياق.
- اقتراح اختصارات صوتية من "مساعد Google": يمكنك استخدام "مساعد Google" لاقتراح مهام بشكل استباقي في السياق المناسب للمستخدمين لاكتشافها أو إعادة تشغيلها.
تستخدم "إجراءات التطبيقات" أغراضًا مدمَجة (BII) لتفعيل هذه الحالات وعشرات حالات الاستخدام الأخرى على مستوى فئات المهام الشائعة. يمكنك الاطّلاع على النظرة العامة على الإجراءات في التطبيقات في هذه الصفحة للحصول على تفاصيل عن إتاحة استخدام BII في تطبيقاتك.
تطوير أجهزة متعددة
يمكنك استخدام "المهام في التطبيقات" لتوفير التحكّم في إعادة توجيه الصوت على أسطح الأجهزة بخلاف الأجهزة الجوّالة. على سبيل المثال، إذا كانت BII محسَّنة لحالات الاستخدام التلقائي، يمكن للسائقين تنفيذ المهام التالية باستخدام أصواتهم:
- الانتقال إلى أقرب مطعم على مسار القيادة
- العثور على أقرب مرآب سيارات
- تحديد الموقع الجغرافي لمحطات شحن المركبات الكهربائية القريبة
نظرة عامة على "المهام في التطبيقات"
يمكنك استخدام "إجراءات التطبيقات" لتوفير تحكُّم صوتي أعمق في تطبيقاتك للمستخدمين من خلال السماح لهم باستخدام أصواتهم لأداء مهام محدّدة في تطبيقك. وإذا ثبَّت أحد المستخدمين تطبيقك، يمكنه ببساطة توضيح هدفه باستخدام عبارة تتضمّن اسم تطبيقك، مثل "Ok Google، اطلب بيتزا على التطبيق المثالي". تتيح "إجراءات التطبيقات" استخدام معرّفات BIS التي تشكِّل الطرق الشائعة التي يعبّر بها المستخدمون عن المهام التي يريدون إنجازها أو المعلومات التي يبحثون عنها، مثل:
- طلب الطعام وحجز الرحلات وغيرها من الإجراءات الخاصة بفئة معيّنة
- جارٍ فتح ميزة في تطبيقك.
- إجراء طلب بحث عن منتجات أو محتوى باستخدام البحث داخل التطبيق
باستخدام "المهام في التطبيقات"، يمكن لخدمة "مساعد Google" اقتراح قدراتك الصوتية بشكل استباقي كاختصارات للمستخدمين، وذلك بناءً على سياق المستخدم. وتتيح هذه الوظيفة للمستخدمين اكتشاف مهام التطبيق وإعادة تشغيلها بسهولة. يمكنك أيضًا اقتراح هذه الاختصارات في تطبيقك باستخدام حزمة تطوير البرامج (SDK) الترويجية داخل التطبيق.
تتيح إتاحة "إجراءات التطبيقات" من خلال الإعلان عن علامات <capability>
في
shortcuts.xml
. تعمل الإمكانات على إبلاغ Google بكيفية الوصول إلى الوظائف داخل التطبيق
دلاليًا باستخدام BII وتفعيل الدعم الصوتي لميزاتك.
يحقّق "مساعد Google" نوايا المستخدم من خلال تشغيل التطبيق
بالمحتوى أو الإجراء المحدَّد. في بعض حالات الاستخدام، يمكنك تحديد تطبيق Android
مصغر لعرضها ضمن "مساعد Google" لتنفيذ طلب بحث المستخدم.
تتوفّر المهام في التطبيقات على نظام التشغيل Android 5 (المستوى 21 من واجهة برمجة التطبيقات) والإصدارات الأحدث. يمكن للمستخدمين الوصول إلى "إجراءات التطبيقات" على هواتف Android فقط. لا يتوافق "مساعد Google" على Android Go مع مهام التطبيقات.
آلية عمل مهام التطبيقات
توسّع "المهام في التطبيقات" الوظائف داخل التطبيق لتشمل "مساعد Google"، ما يتيح للمستخدمين
الوصول إلى ميزات تطبيقك باستخدام الصوت. عندما يستدعي المستخدم إجراءً في التطبيق،
يطابق "مساعد Google" طلب البحث مع طلب BII تم تحديده في مورد shortcuts.xml
،
ويشغّل تطبيقك على الشاشة المطلوبة أو يعرض تطبيق Android المصغّر.
تُعلن عن معرّفات BII في تطبيقك باستخدام عناصر إمكانية Android. عند تحميل تطبيقك باستخدام Google Play Console، تسجِّل Google الإمكانات المضمّنة في تطبيقك وتتيح للمستخدمين الوصول إليها من "مساعد Google".
على سبيل المثال، يمكنك توفير إمكانية طلب الطعام في تطبيقك. عندما يقول أحد المستخدمين: "Ok Google، اطلب بيتزا من تطبيق Example": تحدث الخطوات التالية:
- يُجري "مساعد Google" تحليلاً للغة طبيعية لطلب البحث، مع مطابقة
دلالات الطلب مع نمط BII المحدَّد مسبقًا. في هذه الحالة، يتطابق
actions.intent.ORDER_MENU_ITEM
BII مع الاستعلام. - يتحقّق "مساعد Google" مما إذا كان قد سبق تسجيل لمؤشر BII في تطبيقك ويستخدم تلك الإعدادات لتحديد كيفية إطلاقه.
- ينشئ "مساعد Google" هدفًا على Android لتشغيل وجهة الطلب داخل التطبيق، باستخدام المعلومات التي تقدّمها في
<capability>
. يستخلص "مساعد Google" معلَمات طلب البحث ويمرّرها كإضافات في هدف Android تم إنشاؤه. - يلبّي "مساعد Google" طلب المستخدم من خلال إطلاق هدف Android الذي تم إنشاؤه. يمكنك ضبط "
intent
" لتشغيل شاشة في تطبيقك أو عرض تطبيق مصغّر في "مساعد Google".
![عندما يقدّم المستخدم طلبًا إلى "مساعد Google"، يستجيب "مساعد Google"
من خلال إطلاق وجهة في التطبيق للمستخدم.](https://developer.android.google.cn/static/guide/app-actions/images/assistant-flow.png?authuser=19&hl=ar)
بعد أن يكمل المستخدم المهمة، يمكنك استخدام مكتبة اختصارات Google لدمج اختصارات Google لإرسال اختصار ديناميكي للإجراء ومعلَماته إلى Google، ما يمكّن "مساعد Google" من اقتراح الاختصار للمستخدم في الأوقات المناسبة من حيث السياق.
عند استخدام هذه المكتبة، تصبح الاختصارات مؤهّلة لاستكشاف المحتوى وإعادة تشغيله على مساحات عرض Google، مثل "مساعد Google". على سبيل المثال، يمكنك إرسال اختصار إلى Google لكل وجهة يطلبها المستخدم في تطبيق مشاركة الرحلات لإعادة التشغيل السريع لاحقًا كاقتراح اختصار.
إنشاء مهامّ في التطبيق
تعتمد "الإجراءات في التطبيق" على الوظائف الحالية في تطبيق Android،
وتتماثل العملية لكل إجراء في التطبيق تنفذه. توجّه "إجراءات التطبيق" المستخدمين
مباشرةً إلى محتوى معيّن أو ميزات محدّدة في تطبيقك باستخدام عناصر capability
التي تحدّدها في shortcuts.xml
.
عند إنشاء إجراء في التطبيق، تكون الخطوة الأولى هي تحديد النشاط الذي تريد السماح للمستخدمين بالوصول إليه من خلال "مساعد Google". وبعد ذلك، وباستخدام هذه المعلومات، ابحث عن أقرب BII من تلك المعلومات في مرجع App Actions BII.
تمثِّل BII بعض الطرق الشائعة التي يعبّر بها المستخدمون عن المهام التي يريدون تنفيذها باستخدام تطبيق أو معلومات يبحثون عنها. على سبيل المثال، توجد مؤشرات BII لإجراءات مثل طلب وجبة، وحجز رحلة، والتحقق من رصيد الحساب. تُعد BII أفضل طريقة لبدء استخدام "إجراءات التطبيق"، لأنّها تشكِّل الأشكال الشائعة من طلبات بحث المستخدمين بلغات متعددة، ما يسهّل عليك تفعيل صوت تطبيقك بسرعة.
بعد تحديد الوظيفة داخل التطبيق وثاني أكسيد الكربون (BII) المطلوب تنفيذه، يمكنك إضافة أو تعديل ملف المصدر shortcuts.xml
في تطبيق Android الخاص بك والذي يربط BII بوظائف تطبيقك. إنّ الإجراءات في التطبيقات المحدّدة على أنّها عناصر capability
في
shortcuts.xml
توضّح كيفية معالجة كل خوارزمية بخوارزمية BII لعملية تنفيذ كل منها، بالإضافة إلى
المعلَمات التي يتم استخراجها وتقديمها إلى تطبيقك.
يتمثّل جزء كبير من عملية تطوير "المهام في التطبيقات" في ربط معلَمات BII في عملية التنفيذ المحدّدة. عادةً ما تأخذ هذه العملية شكل تعيين المدخلات المتوقعة للوظائف داخل التطبيق إلى المعلمات الدلالية لـ BII.
إجراءات التطبيق التجريبية
أثناء التطوير والاختبار، يتم استخدام مكوّن "مساعد Google" الإضافي لاستوديو Android لإنشاء معاينة لـ "إجراءات التطبيق" في "مساعد Google" لحسابك على Google. يساعدك هذا المكوِّن الإضافي في اختبار كيفية تعامل إجراء التطبيق مع المعلَمات المختلفة قبل إرساله للنشر. بعد إنشاء معاينة لإجراء التطبيق في أداة الاختبار، يمكنك تشغيل "إجراء تطبيق" على جهاز الاختبار مباشرةً من نافذة أداة الاختبار.
تطبيقات الوسائط
يتضمّن "مساعد Google" إمكانات مدمجة لفهم الأوامر المتاحة في تطبيقات الوسائط، مثل "Ok Google، أريد الاستماع إلى أغاني لـ Beyonce"، ويتيح استخدام عناصر التحكّم في الوسائط، مثل إيقاف مؤقت وتخطّي وتقديم سريع وإبهام للأعلى.
الخطوات التالية
اتّبِع مسار "المهام في التطبيق" لإنشاء مهمّة من "مهام التطبيقات" باستخدام نموذج تطبيق Android. ثم انتقِل إلى دليلنا حول إنشاء "إجراءات في التطبيق" لتطبيقك الخاص. يمكنك أيضًا استكشاف هذه الموارد الإضافية لإنشاء مهام في التطبيقات:
- يمكنك تنزيل نموذج تطبيق Android للياقة البدنية على GitHub واستكشافه.
- r/GoogleAssistantDev: المنتدى الرسمي على Reddit لمطوّري البرامج الذين يستخدمون "مساعد Google".
- إذا كان لديك سؤال برمجة حول "إجراءات التطبيقات"، يمكنك إرسال مشاركة إلى Stack Overflow باستخدام علامتَي "android" و"app-actions". قبل نشر السؤال، تأكَّد من أنّ سؤالك يتناول الموضوع ومن أنّك قرأت الإرشادات حول كيفية طرح سؤال جيد.
- يمكنك الإبلاغ عن الأخطاء والمشاكل العامة في ميزات "إجراءات التطبيقات" من خلال أداة تتبُّع المشاكل العامة.