به عنوان یک توسعه دهنده، می توانید میانبرهایی را برای انجام اقدامات خاص در برنامه خود تعریف کنید. می‌توانید این میانبرها را در راه‌انداز یا دستیار پشتیبانی‌شده (مانند Google Assistant) نمایش دهید و به کاربران خود کمک کنید تا کارهای رایج یا توصیه‌شده را به سرعت در برنامه‌تان شروع کنند.
این اسناد به شما نحوه ایجاد و مدیریت میانبرهای برنامه را نشان می دهد. همچنین می توانید برخی از بهترین روش ها را برای بهبود میانبرهای خود بیاموزید.
انواع میانبر
هر میانبر به یک یا چند هدف ارجاع می‌دهد، که هرکدام از آنها با انتخاب میانبر، عملکرد خاصی را در برنامه شما اجرا می‌کنند. انواع میانبرهایی که برای برنامه خود ایجاد می کنید به موارد استفاده برنامه بستگی دارد. نمونه هایی از اقداماتی که می توانید به عنوان میانبر بیان کنید عبارتند از:
- نوشتن یک ایمیل جدید در یک برنامه ایمیل.
- هدایت کاربران به یک مکان خاص در یک برنامه نقشه برداری.
- ارسال پیام به مخاطب کاربر در یک برنامه ارتباطی.
- پخش قسمت بعدی یک برنامه تلویزیونی در یک برنامه رسانه.
- بارگیری آخرین نقطه ذخیره در یک برنامه بازی.
- اجازه دادن به کاربر برای سفارش نوشیدنی در برنامه تحویل با استفاده از دستورات گفتاری.
می توانید انواع میانبرهای زیر را برای برنامه خود منتشر کنید:
- میانبرهای ایستا در یک فایل منبعی که در یک APK یا بسته برنامه بسته بندی شده است، تعریف می شوند.
- میانبرهای پویا را می توان تنها در زمان اجرا توسط برنامه شما فشار داد، به روز کرد و حذف کرد.
- اگر کاربر اجازه دهد، می‌توان میانبرهای پین‌شده را در زمان اجرا به راه‌اندازهای پشتیبانی‌شده اضافه کرد.
نمایش میانبرها در دستیارها با استفاده از قابلیت ها
قابلیت‌های shortcuts.xml به شما امکان می‌دهد انواع اقداماتی را که کاربران می‌توانند برای راه‌اندازی برنامه‌تان انجام دهند و مستقیماً به انجام یک کار خاص انجام دهند، اعلام کنید. برای مثال، می‌توانید با اعلام عناصر capability که عملکرد درون‌برنامه شما را به Actions App Assistant گسترش می‌دهد، کنترل صوتی برنامه‌تان را از طریق Google Assistant به کاربران بدهید. برای جزئیات بیشتر، به مستندات مربوط به افزودن قابلیت ها مراجعه کنید.
محدودیت های میانبر
اکثر لانچرهای پشتیبانی شده حداکثر چهار میانبر را در یک زمان نمایش می دهند که شامل میانبرهای ایستا و پویا می شود. هنگام فشار دادن میانبرهای پویا برای نمایش در سطوح Google، مانند Google Assistant، از کتابخانه ادغام میانبرهای Google استفاده کنید تا در معرض محدودیت میانبر قرار نگیرید.
اگر انتخاب کنید که از کتابخانه یکپارچه سازی میانبرهای Google استفاده نکنید، برنامه شما مشمول محدودیت دستگاه برای تعداد میانبرهایی است که در یک زمان پشتیبانی می کند. میانبرهای منتشر شده به این روش فقط در لانچرهای اندروید ظاهر می‌شوند و در سطوح Google مانند Assistant قابل شناسایی نیستند.
هیچ محدودیتی برای تعداد میانبرهای پین شده ای که کاربران می توانند برای برنامه شما ایجاد کنند وجود ندارد. برنامه شما نمی تواند میانبرهای پین شده را حذف کند، اما می تواند آنها را غیرفعال کند .
برای شروع ایجاد میانبر برای برنامه خود، به مستندات زیر مراجعه کنید:
برای جزئیات بیشتر در مورد عملیاتی که می توانید روی میانبرها انجام دهید، به مستندات مرجع ShortcutManager API مراجعه کنید.
به عنوان یک توسعه دهنده، می توانید میانبرهایی را برای انجام اقدامات خاص در برنامه خود تعریف کنید. می‌توانید این میانبرها را در راه‌انداز یا دستیار پشتیبانی‌شده (مانند Google Assistant) نمایش دهید و به کاربران خود کمک کنید تا کارهای رایج یا توصیه‌شده را به سرعت در برنامه‌تان شروع کنند.
این اسناد به شما نحوه ایجاد و مدیریت میانبرهای برنامه را نشان می دهد. همچنین می توانید برخی از بهترین روش ها را برای بهبود میانبرهای خود بیاموزید.
انواع میانبر
هر میانبر به یک یا چند هدف ارجاع می‌دهد، که هرکدام از آنها با انتخاب میانبر، عملکرد خاصی را در برنامه شما اجرا می‌کنند. انواع میانبرهایی که برای برنامه خود ایجاد می کنید به موارد استفاده برنامه بستگی دارد. نمونه هایی از اقداماتی که می توانید به عنوان میانبر بیان کنید عبارتند از:
- نوشتن یک ایمیل جدید در یک برنامه ایمیل.
- هدایت کاربران به یک مکان خاص در یک برنامه نقشه برداری.
- ارسال پیام به مخاطب کاربر در یک برنامه ارتباطی.
- پخش قسمت بعدی یک برنامه تلویزیونی در یک برنامه رسانه.
- بارگیری آخرین نقطه ذخیره در یک برنامه بازی.
- اجازه دادن به کاربر برای سفارش نوشیدنی در برنامه تحویل با استفاده از دستورات گفتاری.
می توانید انواع میانبرهای زیر را برای برنامه خود منتشر کنید:
- میانبرهای ایستا در یک فایل منبعی که در یک APK یا بسته برنامه بسته بندی شده است، تعریف می شوند.
- میانبرهای پویا را می توان تنها در زمان اجرا توسط برنامه شما فشار داد، به روز کرد و حذف کرد.
- اگر کاربر اجازه دهد، می‌توان میانبرهای پین‌شده را در زمان اجرا به راه‌اندازهای پشتیبانی‌شده اضافه کرد.
نمایش میانبرها در دستیارها با استفاده از قابلیت ها
قابلیت‌های shortcuts.xml به شما امکان می‌دهد انواع اقداماتی را که کاربران می‌توانند برای راه‌اندازی برنامه‌تان انجام دهند و مستقیماً به انجام یک کار خاص انجام دهند، اعلام کنید. برای مثال، می‌توانید با اعلام عناصر capability که عملکرد درون‌برنامه شما را به Actions App Assistant گسترش می‌دهد، کنترل صوتی برنامه‌تان را از طریق Google Assistant به کاربران بدهید. برای جزئیات بیشتر، به مستندات مربوط به افزودن قابلیت ها مراجعه کنید.
محدودیت های میانبر
اکثر لانچرهای پشتیبانی شده حداکثر چهار میانبر را در یک زمان نمایش می دهند که شامل میانبرهای ایستا و پویا می شود. هنگام فشار دادن میانبرهای پویا برای نمایش در سطوح Google، مانند Google Assistant، از کتابخانه ادغام میانبرهای Google استفاده کنید تا در معرض محدودیت میانبر قرار نگیرید.
اگر انتخاب کنید که از کتابخانه یکپارچه سازی میانبرهای Google استفاده نکنید، برنامه شما مشمول محدودیت دستگاه برای تعداد میانبرهایی است که در یک زمان پشتیبانی می کند. میانبرهای منتشر شده به این روش فقط در لانچرهای اندروید ظاهر می‌شوند و در سطوح Google مانند Assistant قابل شناسایی نیستند.
هیچ محدودیتی برای تعداد میانبرهای پین شده ای که کاربران می توانند برای برنامه شما ایجاد کنند وجود ندارد. برنامه شما نمی تواند میانبرهای پین شده را حذف کند، اما می تواند آنها را غیرفعال کند .
برای شروع ایجاد میانبر برای برنامه خود، به مستندات زیر مراجعه کنید:
برای جزئیات بیشتر در مورد عملیاتی که می توانید روی میانبرها انجام دهید، به مستندات مرجع ShortcutManager API مراجعه کنید.