از اقدامات صوتی پشتیبانی کنید

عملکردهای صوتی را در برنامه رسانه‌ای خود ادغام کنید تا با به حداقل رساندن حواس‌پرتی، ایمنی و راحتی راننده را افزایش دهید. هنگامی که Android Auto یا Android Automotive OS (AAOS) یک عملکرد صوتی را تشخیص داده و تفسیر می‌کنند، آن عملکرد را از طریق فراخوانی onPlayFromSearch به برنامه شما ارسال می‌کنند.

پس از دریافت پاسخ فراخوانی، برنامه شما محتوایی را که با رشته پرس‌وجو مطابقت دارد پیدا می‌کند و سپس پخش را شروع می‌کند. برنامه شما باید دسته‌های مختلف پرس‌وجو مانند ژانر، هنرمند، آلبوم، نام آهنگ، ایستگاه رادیویی یا لیست پخش را در نظر بگیرد. علاوه بر این، برنامه شما باید یک رشته پرس‌وجوی خالی را مدیریت کند که نشان دهنده یک درخواست عمومی برای موسیقی است.

اگر برنامه شما در حال پخش یک آیتم رسانه‌ای است، کاربر می‌تواند با گفتن «Play [song title]» به برنامه شما بگوید که آهنگ دیگری را بدون نگاه کردن یا لمس کردن صفحه نمایش خودرو پخش کند. کاربران می‌توانند با کلیک کردن روی دکمه‌های مناسب روی فرمان یا گفتن عبارت کلیدی «OK Google» درخواست‌های خود را آغاز کنند.

وقتی Android Auto یا AAOS یک عملکرد صوتی را تشخیص داده و تفسیر می‌کند، Android Auto یا AAOS آن عملکرد صوتی را از طریق onPlayFromSearch به برنامه ارسال می‌کند. پس از دریافت این فراخوانی، برنامه محتوایی را پیدا می‌کند که با رشته query مطابقت داشته باشد و سپس پخش را شروع می‌کند.

کاربران می‌توانند دسته‌بندی‌های مختلفی از عبارات را در جستجوی خود مشخص کنند: ژانر، هنرمند، آلبوم، نام آهنگ، ایستگاه رادیویی یا لیست پخش و موارد دیگر. هنگام ایجاد پشتیبانی برای جستجو، تمام دسته‌بندی‌هایی را که برای برنامه شما منطقی هستند، در نظر بگیرید. اگر Android Auto یا AAOS تشخیص دهند که یک جستجوی مشخص در یک دسته‌بندی خاص قرار می‌گیرد، موارد اضافی در پارامتر extras اضافه می‌شوند. می‌توانید این موارد اضافی را ارسال کنید:

یک رشته query خالی را در نظر بگیرید که در صورت عدم مشخص کردن عبارات جستجو توسط کاربر، می‌تواند توسط Android Auto یا AAOS ارسال شود. برای مثال، اگر کاربر بگوید "Play some music". در این حالت، برنامه شما می‌تواند یک آهنگ اخیراً پخش شده یا آهنگ جدید را شروع کند.

اگر برنامه شما نمی‌تواند یک جستجو را به سرعت پردازش کند، onPlayFromSearch را مسدود نکنید. در عوض، وضعیت پخش را روی STATE_CONNECTING تنظیم کنید و جستجو را در یک نخ ناهمزمان انجام دهید.

وقتی پخش شروع می‌شود، می‌توانید صف پخش رسانه را با محتوای مرتبط پر کنید. برای مثال، اگر کاربر درخواست پخش یک آلبوم را داشته باشد، برنامه شما می‌تواند صف پخش را با لیست آهنگ‌های آلبوم پر کند.

علاوه بر درخواست‌های «پخش»، اندروید اتو و AAOS درخواست‌های صوتی برای کنترل پخش مانند «مکث موسیقی» و «آهنگ بعدی» را تشخیص می‌دهند و این دستورات را با فراخوانی‌های مناسب جلسه رسانه، مانند onPause و onSkipToNext مطابقت می‌دهند.

برای کسب اطلاعات بیشتر در مورد پیاده‌سازی عملکردهای پخش صوتی، به بخش «دستیار گوگل و برنامه‌های رسانه‌ای» مراجعه کنید.