دستیار گوگل (Google Assistant) امکان کنترل صوتی برنامههای اندروید را فراهم میکند. با استفاده از دستیار، کاربران میتوانند با گفتن جملاتی مانند «هی گوگل، اجرای یک برنامهی آزمایشی را شروع کن» از طریق صدا، برنامهها را اجرا کنند، وظایف خود را انجام دهند، به محتوا دسترسی پیدا کنند و کارهای بیشتری انجام دهند.
به عنوان یک توسعهدهنده اندروید، میتوانید از چارچوب توسعه و ابزارهای تست دستیار گوگل استفاده کنید تا به راحتی کنترل صوتی عمیق برنامههای خود را روی سطوح مبتنی بر اندروید، مانند دستگاههای تلفن همراه، اتومبیلها و پوشیدنیها، فعال کنید.
اقدامات برنامه
قابلیت App Actions در دستیار گوگل به کاربران اجازه میدهد تا برنامههای اندروید را با صدای خود اجرا و کنترل کنند.
اقدامات برنامه، کنترل صوتی عمیقتری را فعال میکنند و به کاربران این امکان را میدهند که برنامههای شما را اجرا کرده و کارهایی مانند موارد زیر را انجام دهند:
- راهاندازی ویژگیها از دستیار : قابلیتهای برنامه خود را به پرسوجوهای کاربر که با الگوهای معنایی از پیش تعریفشده یا اهداف داخلی مطابقت دارند، متصل کنید.
- نمایش اطلاعات برنامه در سطوح گوگل : ارائه ویجتهای اندروید برای نمایش دستیار، ارائه پاسخهای درونخطی، تأییدهای ساده و تعاملات مختصر با کاربران بدون تغییر زمینه.
- پیشنهاد میانبرهای صوتی از دستیار : از دستیار استفاده کنید تا به صورت فعال وظایف را در زمینه مناسب برای کشف یا پخش مجدد کاربران پیشنهاد دهد.
App Actions از Intentهای داخلی (BII) برای فعال کردن این موارد و دهها مورد استفاده دیگر در دستههای وظایف محبوب استفاده میکنند. برای جزئیات بیشتر در مورد پشتیبانی از BIIها در برنامههای خود، به نمای کلی App Actions در این صفحه مراجعه کنید.
توسعه چند دستگاهی
شما میتوانید از App Actions برای ارائه کنترل صوتی روی سطوح دستگاه فراتر از موبایل استفاده کنید. به عنوان مثال، با BII های بهینه شده برای موارد استفاده خودکار، رانندگان میتوانند کارهای زیر را با استفاده از صدای خود انجام دهند:
مرور کلی اقدامات برنامه
شما از App Actions برای ارائه کنترل صوتی عمیقتر برنامههای خود به کاربران استفاده میکنید و به آنها این امکان را میدهید که از صدای خود برای انجام وظایف خاص در برنامه شما استفاده کنند. اگر کاربری برنامه شما را نصب کرده باشد، میتواند به سادگی قصد خود را با استفاده از عبارتی که شامل نام برنامه شما است، مانند "سلام گوگل، یک تمرین را در برنامه نمونه شروع کن" بیان کند. App Actions از BII هایی پشتیبانی میکند که روشهای رایج بیان وظایفی که کاربران میخواهند انجام دهند یا اطلاعاتی که به دنبال آن هستند را مدلسازی میکنند، مانند:
- شروع یک تمرین، ارسال پیام و سایر اقدامات خاص دسته بندی.
- باز کردن یک ویژگی از برنامه شما.
- جستجوی محصولات یا محتوا با استفاده از جستجوی درون برنامهای.
با App Actions، دستیار میتواند به صورت فعال قابلیتهای صوتی شما را به عنوان میانبر به کاربران، بر اساس زمینه کاربر، پیشنهاد دهد. این قابلیت به کاربران امکان میدهد تا به راحتی App Actions شما را کشف و دوباره پخش کنند. شما همچنین میتوانید این میانبرها را در برنامه خود با استفاده از SDK تبلیغاتی درون برنامهای App Actions پیشنهاد دهید.
شما با تعریف تگهای <capability> در shortcuts.xml ، پشتیبانی از App Actions را فعال میکنید. Capabilities به گوگل میگوید که چگونه میتوان با استفاده از BII به قابلیتهای درون برنامهای شما به صورت معنایی دسترسی پیدا کرد و پشتیبانی صوتی را برای ویژگیهای شما فعال میکند. Assistant با راهاندازی برنامه شما به محتوا یا عملکرد مشخص شده، اهداف کاربر را برآورده میکند. برای برخی موارد استفاده، میتوانید یک ویجت اندروید را برای نمایش در Assistant مشخص کنید تا درخواست کاربر را برآورده کند.
App Actions در اندروید ۵ (سطح API ۲۱) و بالاتر پشتیبانی میشود. کاربران فقط میتوانند در گوشیهای اندروید به App Actions دسترسی داشته باشند. دستیار در اندروید گو از App Actions پشتیبانی نمیکند.
نحوه عملکرد اقدامات برنامه
App Actions قابلیتهای درونبرنامهای شما را به Assistant گسترش میدهد و به کاربران امکان میدهد تا از طریق صدا به ویژگیهای برنامه شما دسترسی پیدا کنند. وقتی کاربری یک App Action را فراخوانی میکند، Assistant درخواست را با یک BII اعلام شده در منبع shortcuts.xml شما مطابقت میدهد و برنامه شما را در صفحه درخواستی اجرا میکند یا یک ویجت اندروید را نمایش میدهد.
شما BII ها را در برنامه خود با استفاده از عناصر قابلیت اندروید اعلام میکنید. وقتی برنامه خود را با استفاده از کنسول Google Play آپلود میکنید، Google قابلیتهای اعلام شده در برنامه شما را ثبت میکند و آنها را برای دسترسی کاربران از طریق Assistant در دسترس قرار میدهد.
برای مثال، ممکن است شما قابلیتی برای شروع تمرین در برنامه خود فراهم کنید. وقتی کاربر میگوید: «سلام گوگل، در برنامه نمونه شروع به دویدن کن»، مراحل زیر اتفاق میافتد:
- دستیار، تحلیل زبان طبیعی را روی پرسوجو انجام میدهد و معنای درخواست را با الگوی از پیش تعریفشدهی یک BII مطابقت میدهد. در این مورد،
actions.intent.START_EXERCISEBII با پرسوجو مطابقت دارد. - دستیار بررسی میکند که آیا BII قبلاً برای برنامه شما ثبت شده است یا خیر و از آن پیکربندی برای تعیین نحوه راهاندازی آن استفاده میکند.
- دستیار با استفاده از اطلاعاتی که شما در
<capability>ارائه میدهید، یک اینتنت اندروید برای راهاندازی مقصد درونبرنامهای درخواست ایجاد میکند. دستیار پارامترهای پرسوجو را استخراج کرده و آنها را به عنوان موارد اضافی در یک اینتنت اندروید تولید شده ارسال میکند. - دستیار با راهاندازی اینتنت اندروید تولید شده، درخواست کاربر را برآورده میکند. شما
intentرا طوری پیکربندی میکنید که یک صفحه را در برنامه شما راهاندازی کند یا یک ویجت را در دستیار نمایش دهد.

پس از اینکه کاربر یک کار را انجام داد، شما با استفاده از کتابخانه یکپارچهسازی میانبرهای گوگل، یک میانبر پویا از آن عمل و پارامترهای آن را به گوگل ارسال میکنید و به دستیار گوگل این امکان را میدهید که در زمانهای مرتبط با متن، میانبر را به کاربر پیشنهاد دهد.
استفاده از این کتابخانه، میانبرهای شما را برای کشف و پخش مجدد در سطوح گوگل، مانند دستیار گوگل، واجد شرایط میکند. به عنوان مثال، میتوانید برای هر مقصدی که کاربر در برنامه اشتراکگذاری سفر شما درخواست میکند، یک میانبر به گوگل ارسال کنید تا بعداً به عنوان یک پیشنهاد میانبر، بتوانید به سرعت آن را پخش کنید.
ساخت اکشنهای برنامه
App Actions بر اساس قابلیتهای موجود در برنامه اندروید شما ساخته میشوند. این فرآیند برای هر App Action که پیادهسازی میکنید، مشابه است. App Actions کاربران را مستقیماً به محتوا یا ویژگیهای خاصی در برنامه شما با استفاده از عناصر capability که در shortcuts.xml مشخص میکنید، هدایت میکند.
وقتی یک App Action میسازید، اولین قدم شناسایی فعالیتی است که میخواهید به کاربران اجازه دسترسی از طریق Assistant را بدهید. سپس، با استفاده از آن اطلاعات، نزدیکترین BII منطبق را از مرجع App Actions BII پیدا کنید.
BIIها برخی از روشهای رایج بیان وظایفی که کاربران میخواهند با استفاده از یک برنامه انجام دهند یا اطلاعاتی که به دنبال آن هستند را مدلسازی میکنند. به عنوان مثال، BIIها برای اقداماتی مانند شروع یک تمرین، ارسال پیام و جستجو در یک برنامه وجود دارند. BIIها بهترین راه برای شروع با App Actions هستند، زیرا انواع رایج درخواستهای کاربر را در چندین زبان مدلسازی میکنند و فعالسازی سریع برنامه شما را با صدا آسان میکنند.
پس از شناسایی عملکرد درون برنامهای و BII مورد نیاز برای پیادهسازی، فایل منبع shortcuts.xml را در برنامه اندروید خود اضافه یا بهروزرسانی میکنید که BII را به عملکرد برنامه شما نگاشت میکند. اقدامات برنامه که به عنوان عناصر capability در shortcuts.xml تعریف شدهاند، نحوه حل و فصل هر BII و همچنین پارامترهای استخراج شده و ارائه شده به برنامه شما را شرح میدهند.
بخش قابل توجهی از توسعه App Actions، نگاشت پارامترهای BII به فرآیند تعریفشدهی شما است. این فرآیند معمولاً به شکل نگاشت ورودیهای مورد انتظار از عملکرد درون برنامهای شما به پارامترهای معنایی BII است.
اقدامات برنامه آزمایشی
در طول توسعه و آزمایش، شما از افزونه Google Assistant برای اندروید استودیو برای ایجاد پیشنمایشی از App Actions خود در Assistant برای حساب گوگل خود استفاده میکنید. این افزونه به شما کمک میکند تا قبل از ارسال App Action برای استقرار، نحوه مدیریت پارامترهای مختلف توسط App Action خود را آزمایش کنید. پس از ایجاد پیشنمایشی از App Action خود در ابزار تست، میتوانید مستقیماً از پنجره ابزار تست، App Action را روی دستگاه تست خود فعال کنید.
برنامههای رسانهای
دستیار گوگل همچنین قابلیتهای داخلی برای درک دستورات برنامههای رسانهای، مانند «هی گوگل، آهنگی از بیانسه پخش کن» ارائه میدهد و از کنترلهای رسانهای مانند مکث ، رد کردن ، جلو بردن سریع و تایید پشتیبانی میکند.
مراحل بعدی
برای ساخت یک App Action با استفاده از نمونه برنامه اندروید ما، مسیر App Actions را دنبال کنید. سپس، به راهنمای ما برای ساخت App Actions برای برنامه خودتان ادامه دهید. همچنین میتوانید این منابع اضافی را برای ساخت App Actions بررسی کنید:
- نمونه برنامه تناسب اندام اندروید ما را از گیتهاب دانلود و بررسی کنید.
- r/GoogleAssistantDev : انجمن رسمی ردیت برای توسعهدهندگانی که با دستیار گوگل کار میکنند.
- اگر در مورد App Actions سوال برنامهنویسی دارید، با استفاده از تگهای "android" و "app-actions" یک پست در Stack Overflow ارسال کنید. قبل از ارسال، مطمئن شوید که سوال شما مرتبط با موضوع است و راهنمای نحوه پرسیدن یک سوال خوب را مطالعه کردهاید.
- اشکالات و مشکلات عمومی مربوط به ویژگیهای «اقدامات برنامه» را در ردیاب مشکلات عمومی ما گزارش دهید.