Google Assistant کنترل صوتی برنامه های اندروید را فعال می کند. با استفاده از «دستیار»، کاربران میتوانند برنامهها را راهاندازی کنند، وظایف را انجام دهند، به محتوا دسترسی داشته باشند و موارد دیگر را با استفاده از صدایشان برای گفتن مواردی مانند «Hey Google, start a run on Example App».
بهعنوان یک توسعهدهنده اندروید، میتوانید از چارچوب توسعه دستیار و ابزارهای آزمایشی استفاده کنید تا به راحتی کنترل صوتی عمیق برنامههای خود را روی سطوح مجهز به اندروید، مانند دستگاههای تلفن همراه، ماشینها و پوشیدنیها فعال کنید.
اقدامات برنامه
Assistant's App Actions به کاربران اجازه می دهد برنامه های اندروید را با صدای خود راه اندازی و کنترل کنند.
App Actions کنترل صوتی عمیقتری را فعال میکند و به کاربران امکان میدهد برنامههای شما را راهاندازی کنند و کارهایی مانند:
- راهاندازی ویژگیها از دستیار : قابلیتهای برنامهتان را به درخواستهای کاربر که با الگوهای معنایی از پیش تعریفشده یا مقاصد داخلی مطابقت دارند، متصل کنید.
- نمایش اطلاعات برنامه در سطوح Google : ویجتهای Android را برای نمایش دستیار ارائه دهید، پاسخهای درون خطی، تأییدیههای ساده و تعاملات کوتاه را بدون تغییر زمینه به کاربران ارائه دهید.
- پیشنهاد میانبرهای صوتی از دستیار : از دستیار برای پیشنهاد فعالانه وظایف در زمینه مناسب برای کشف یا پخش مجدد توسط کاربران استفاده کنید.
App Actions از مقاصد داخلی (BII) برای فعال کردن این موارد و دهها مورد دیگر در دستههای کار محبوب استفاده میکند. برای جزئیات بیشتر در مورد پشتیبانی از BII در برنامه های خود، نمای کلی اقدامات برنامه را در این صفحه ببینید.
توسعه چند دستگاهی
میتوانید از App Actions برای کنترل انتقال صدا بر روی سطوح دستگاه فراتر از تلفن همراه استفاده کنید. برای مثال، با BII هایی که برای موارد استفاده خودکار بهینه شده اند، رانندگان می توانند وظایف زیر را با استفاده از صدای خود انجام دهند:
- در مسیر رانندگی آنها به نزدیکترین رستوران بروید
- نزدیکترین پارکینگ را پیدا کنید
- ایستگاه های شارژ EV در نزدیکی را پیدا کنید
نمای کلی اقدامات برنامه
شما از App Actions برای ارائه کنترل صوتی عمیقتر برنامههای خود به کاربران استفاده میکنید، زیرا آنها را قادر میسازید تا از صدای خود برای انجام وظایف خاص در برنامه شما استفاده کنند. اگر کاربری برنامه شما را نصب کرده باشد، میتواند به سادگی با استفاده از عبارتی که شامل نام برنامه شما است، قصد خود را بیان کند، مانند «Hey Google, start a exercise on Example App». App Actions از BII هایی پشتیبانی می کند که روش های رایجی را که کاربران وظایفی را که می خواهند انجام دهند یا اطلاعاتی را که به دنبال آن هستند بیان می کنند، مدل می کنند، مانند:
- تمرینی را شروع کنید، پیام بفرستید، و سایر اقدامات خاص دسته بندی را انجام دهید.
- باز کردن یکی از ویژگی های برنامه شما
- پرس و جو برای محصولات یا محتوا با استفاده از جستجوی درون برنامه ای.
با App Actions، «دستیار» میتواند قابلیتهای صوتی شما را بهعنوان میانبر، بر اساس زمینه کاربر، فعالانه به کاربران پیشنهاد دهد. این قابلیت به کاربران امکان میدهد تا به آسانی Actions App شما را پیدا کرده و دوباره پخش کنند. همچنین میتوانید این میانبرها را با SDK تبلیغاتی درونبرنامه Actions در برنامهتان پیشنهاد دهید.
با اعلام تگهای <capability>
در shortcuts.xml
، پشتیبانی از App Actions را فعال میکنید. قابلیتها به Google میگویند که چگونه میتوان به عملکرد درونبرنامهای شما با استفاده از BII دسترسی معنایی داشت و پشتیبانی صوتی را برای ویژگیهای شما فعال میکند. دستیار با راهاندازی برنامه شما در محتوا یا عملکرد مشخص شده، اهداف کاربر را برآورده میکند. برای برخی موارد استفاده، میتوانید ویجت Android را برای نمایش در دستیار تعیین کنید تا درخواست کاربر را برآورده کند.
App Actions در Android 5 (سطح API 21) و بالاتر پشتیبانی میشود. کاربران فقط میتوانند به App Actions در تلفنهای Android دسترسی داشته باشند. Assistant در Android Go از App Actions پشتیبانی نمیکند.
نحوه عملکرد App Actions
App Actions عملکرد درونبرنامه شما را به Assistant گسترش میدهد و کاربران را قادر میسازد تا از طریق صدا به ویژگیهای برنامه شما دسترسی داشته باشند. وقتی کاربر یک App Action را فراخوانی میکند، دستیار درخواست را با BII اعلام شده در منبع shortcuts.xml
شما مطابقت میدهد، برنامه شما را در صفحه درخواستی راهاندازی میکند یا یک ویجت Android را نمایش میدهد.
شما BII ها را در برنامه خود با استفاده از عناصر قابلیت Android اعلام می کنید. وقتی برنامه خود را با استفاده از کنسول Google Play آپلود میکنید، Google قابلیتهای اعلامشده در برنامه شما را ثبت میکند و آنها را برای دسترسی کاربران از دستیار در دسترس قرار میدهد.
برای مثال، ممکن است قابلیتی برای شروع ورزش در برنامه خود ارائه دهید. وقتی کاربر میگوید: «Hey Google، اجرا را در Example App شروع کن»، مراحل زیر رخ میدهد:
- Assistant تجزیه و تحلیل زبان طبیعی را روی پرس و جو انجام می دهد و معنایی درخواست را با الگوی از پیش تعریف شده یک BII مطابقت می دهد. در این مورد،
actions.intent.START_EXERCISE
BII با درخواست مطابقت دارد. - دستیار بررسی می کند که آیا BII قبلاً برای برنامه شما ثبت شده است یا خیر و از آن پیکربندی برای تعیین نحوه راه اندازی آن استفاده می کند.
- Assistant با استفاده از اطلاعاتی که در
<capability>
ارائه میدهید، قصد Android برای راهاندازی مقصد درونبرنامه درخواست ایجاد میکند. دستیار پارامترهای پرس و جو را استخراج می کند و آنها را به عنوان موارد اضافی در یک هدف اندرویدی تولید شده ارسال می کند. - دستیار درخواست کاربر را با راهاندازی هدف اندروید تولید شده برآورده میکند. شما
intent
راه اندازی یک صفحه در برنامه خود یا نمایش ویجت را در Assistant پیکربندی می کنید.
![هنگامی که کاربر درخواستی را به دستیار Google ارائه می دهد، دستیار با راه اندازی یک مقصد برنامه برای کاربر پاسخ می دهد.](https://developer.android.com/static/guide/app-actions/images/assistant-flow.png?authuser=4&hl=fa)
پس از اینکه کاربر یک کار را انجام داد، از کتابخانه ادغام میانبرهای Google برای ارسال میانبر پویا از عملکرد و پارامترهای آن به Google استفاده میکنید و دستیار را قادر میسازد تا میانبر را در زمانهای مرتبط با متن به کاربر پیشنهاد دهد.
استفاده از این کتابخانه باعث میشود میانبرهای شما برای کشف و پخش مجدد در سطوح Google، مانند Assistant، واجد شرایط باشند. برای مثال، میتوانید برای هر مقصدی که کاربر درخواست میکند، میانبری را در برنامه اشتراکگذاری سواری خود برای پخش سریع بعداً به عنوان پیشنهاد میانبر به Google فشار دهید.
اقدامات برنامه را بسازید
App Actions بر روی عملکردهای موجود در برنامه Android شما ساخته می شود. این فرآیند برای هر App Action که پیادهسازی میکنید مشابه است. App Actions با استفاده از عناصر capability
که در shortcuts.xml
مشخص کردهاید، کاربران را مستقیماً به محتوا یا ویژگیهای خاص در برنامه شما میبرد.
وقتی یک App Action میسازید، اولین قدم شناسایی فعالیتی است که میخواهید به کاربران اجازه دهید از Assistant به آن دسترسی داشته باشند. سپس، با استفاده از آن اطلاعات، نزدیکترین BII منطبق را از مرجع App Actions BII پیدا کنید.
BII ها برخی از روش های رایجی را که کاربران با استفاده از یک برنامه یا اطلاعاتی که به دنبال آن هستند بیان می کنند، مدل سازی می کنند. به عنوان مثال، BII برای اقداماتی مانند شروع یک تمرین، ارسال پیام و جستجو در یک برنامه وجود دارد. BII ها بهترین راه برای شروع با App Actions هستند، زیرا انواع مختلف درخواست های کاربر را در چندین زبان مدل می کنند و به شما کمک می کند تا به سرعت برنامه خود را به صورت صوتی فعال کنید.
هنگامی که عملکرد درون برنامه و BII را برای پیاده سازی شناسایی کردید، فایل منبع shortcuts.xml
را در برنامه Android خود اضافه یا به روز می کنید که BII را به عملکرد برنامه شما نگاشت می کند. App Actions که بهعنوان عناصر capability
در shortcuts.xml
تعریف میشوند، نحوه انجام هر BII و همچنین پارامترهایی را که استخراج و به برنامه شما ارائه میشوند، توضیح میدهند.
بخش قابل توجهی از برنامههای کاربردی در حال توسعه، نگاشت پارامترهای BII در اجرای تعریفشده شما است. این فرآیند معمولاً به شکل نگاشت ورودی های مورد انتظار عملکرد درون برنامه ای شما به پارامترهای معنایی BII است.
آزمایش اقدامات برنامه
در طول توسعه و آزمایش، از افزونه Google Assistant برای Android Studio برای ایجاد پیش نمایشی از App Actions خود در Assistant برای حساب Google خود استفاده می کنید. این افزونه به شما کمک میکند قبل از ارسال آن برای استقرار، نحوه عملکرد App Action خود را با پارامترهای مختلف بررسی کنید. هنگامی که پیش نمایشی از App Action خود را در ابزار تست ایجاد کردید، می توانید یک App Action را مستقیماً از پنجره ابزار تست در دستگاه آزمایشی خود راه اندازی کنید.
برنامه های رسانه ای
Assistant همچنین قابلیتهای داخلی را برای درک دستورات برنامه رسانه ارائه میکند، مانند «Hey Google، چیزی توسط Beyonce پخش کن» و از کنترلهای رسانه مانند مکث ، پرش ، سریع به جلو ، و شست بالا پشتیبانی میکند.
مراحل بعدی
مسیر App Actions را دنبال کنید تا با استفاده از نمونه برنامه Android ما یک App Action بسازید. سپس، به راهنمای ما ادامه دهید تا App Actions را برای برنامه خود بسازید . همچنین میتوانید این منابع اضافی را برای ایجاد «کنشهای برنامه» کاوش کنید:
- نمونه برنامه اندروید تناسب اندام ما را در GitHub دانلود و کاوش کنید.
- r/GoogleAssistantDev : انجمن رسمی Reddit برای توسعه دهندگانی که با Google Assistant کار می کنند.
- اگر در مورد App Actions سؤالی در برنامه نویسی دارید، با استفاده از تگ های «android» و «app-actions» یک پست به Stack Overflow ارسال کنید. قبل از ارسال، مطمئن شوید که سوال شما در مورد موضوع است و راهنمای نحوه پرسیدن یک سوال خوب را خوانده اید.
- اشکالات و مشکلات کلی مربوط به ویژگیهای App Actions را در ردیاب عمومی ما گزارش کنید.