با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
اقدامات صوتی را در برنامه رسانه خود ادغام کنید تا با به حداقل رساندن حواس پرتی، ایمنی و راحتی راننده را افزایش دهید. هنگامی که Android Auto یا Android Automotive OS (AAOS) یک کنش صوتی را شناسایی و تفسیر می‌کنند، آن عملکرد را از طریق پاسخ به تماس onPlayFromSearch به برنامه شما تحویل می‌دهند.
پس از دریافت پاسخ تماس، برنامه شما محتوایی را پیدا می‌کند که با رشته جستجو مطابقت دارد و سپس پخش را شروع می‌کند. برنامه شما باید برای دسته‌های جستجوی مختلف، مانند ژانر، هنرمند، آلبوم، نام آهنگ، ایستگاه رادیویی، یا لیست پخش در نظر گرفته شود. علاوه بر این، برنامه شما باید یک رشته پرس و جو خالی را مدیریت کند، که یک درخواست کلی برای موسیقی را نشان می دهد.
اگر برنامه شما در حال پخش یک آیتم رسانه ای است، کاربر می تواند با گفتن «پخش [عنوان آهنگ]» به برنامه شما بگوید که آهنگ دیگری را بدون نگاه کردن یا لمس کردن نمایشگر خودرو پخش کند. کاربران می‌توانند با کلیک کردن روی دکمه‌های مربوطه روی فرمان خود یا بیان کلمات کلیدی «OK Google» سؤالات را آغاز کنند.
وقتی Android Auto یا AAOS یک کنش صوتی را شناسایی و تفسیر می‌کند، Android Auto یا AAOS آن عملکرد صوتی را از طریق onPlayFromSearch به برنامه ارائه می‌کند. پس از دریافت این تماس، برنامه محتوای مطابق با رشته query را پیدا می کند و سپس پخش را شروع می کند.
کاربران می‌توانند دسته‌های مختلفی از اصطلاحات را در جست‌وجوی خود مشخص کنند: ژانر، هنرمند، آلبوم، نام آهنگ، ایستگاه رادیویی یا لیست پخش و غیره. هنگام ایجاد پشتیبانی برای جستجو، تمام دسته بندی هایی را که برای برنامه شما منطقی هستند در نظر بگیرید. اگر Android Auto یا AAOS تشخیص دهد که یک جستجوی داده شده در یک دسته خاص قرار می گیرد، موارد اضافی به پارامتر extras اضافه می شوند. شما می توانید این موارد اضافی را ارسال کنید:
یک رشته query خالی را حساب کنید که اگر کاربر عبارات جستجو را مشخص نکرده باشد، می تواند توسط Android Auto یا AAOS ارسال شود. به عنوان مثال، اگر کاربر بگوید "Play some music." در این صورت، برنامه شما می‌تواند آهنگی که اخیراً پخش شده یا آهنگ جدیدی را شروع کند.
اگر برنامه شما نمی تواند به سرعت جستجو را پردازش کند، در onPlayFromSearch را مسدود نکنید. درعوض، وضعیت پخش را روی STATE_CONNECTING تنظیم کنید و جستجو را در یک رشته ناهمگام انجام دهید.
وقتی پخش شروع می‌شود، صف جلسه رسانه را با محتوای مرتبط پر کنید. به عنوان مثال، اگر کاربر درخواست پخش یک آلبوم را داشته باشد، برنامه شما می تواند صف را با لیست آهنگ آلبوم پر کند.
علاوه بر جستارهای «پخش»، Android Auto و AAOS عبارت‌های صوتی را برای کنترل بازپخش مانند «مکث موسیقی» و «آهنگ بعدی» تشخیص می‌دهند و این دستورات را با تماس‌های جلسه رسانه مناسب، مانند onPause و onSkipToNext مطابقت می‌دهند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-12 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-12 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Support voice actions\n\nIntegrate voice actions into your media app to enhance driver safety and\nconvenience by minimizing distractions. When Android Auto or Android Automotive\nOS (AAOS) detects and interprets a voice action, they deliver the action to your\napp through the `onPlayFromSearch` callback.\n\nUpon receiving the callback, your app finds content that matches the query\nstring and then starts playback. Your app must account for various query\ncategories, such as genre, artist, album, song name, radio station, or playlist.\nAdditionally, your app must handle an empty query string, which indicates a\ngeneral request for music.\n\nIf your app is playing one media item, the user can say \"Play \\[song title\\]\"\nto tell your app to play a different song without looking at or touching the\ncar's display. Users can initiate queries by clicking the appropriate buttons\non their steering wheel or speaking the hotwords \"OK Google.\"\n| **Design guidelines:** To learn more, see [Create apps](/cars/design/create-apps).\n\nWhen Android Auto or AAOS detects and interprets a voice action, Android Auto or\nAAOS delivers that voice action to the app through [`onPlayFromSearch`](/reference/android/support/v4/media/session/MediaSessionCompat.Callback#onPlayFromSearch(java.lang.String,%20android.os.Bundle)). Upon\nreceiving this callback, the app finds content to match the `query` string and\nthen starts playback.\n\nUsers can specify different categories of terms in their query: genre, artist,\nalbum, song name, radio station, or playlist, among others. When building\nsupport for search, account for all the categories that make sense for your app.\nIf Android Auto or AAOS detects that a given query fits into a specific\ncategory, extras are appended in the `extras` parameter. You can send these\nextras:\n\n- [`EXTRA_MEDIA_ALBUM`](/reference/android/provider/MediaStore#EXTRA_MEDIA_ALBUM)\n- [`EXTRA_MEDIA_ARTIST`](/reference/android/provider/MediaStore#EXTRA_MEDIA_ARTIST)\n- [`EXTRA_MEDIA_GENRE`](/reference/android/provider/MediaStore#EXTRA_MEDIA_GENRE)\n- [`EXTRA_MEDIA_PLAYLIST`](/reference/android/provider/MediaStore#EXTRA_MEDIA_PLAYLIST)\n- [`EXTRA_MEDIA_TITLE`](/reference/android/provider/MediaStore#EXTRA_MEDIA_TITLE)\n\nAccount for an empty `query` string, which can be sent by Android Auto or AAOS\nif the user doesn't specify search terms. For example, if the user says\n\"Play some music.\" In this case, your app can start a recently played or new\ntrack.\n\nIf your app can't process a search quickly, don't block in `onPlayFromSearch`.\nInstead, set the playback state to [`STATE_CONNECTING`](/reference/android/support/v4/media/session/PlaybackStateCompat#STATE_CONNECTING()) and perform the\nsearch on an async thread.\n\nWhen playback starts, consider populating the media session's queue with\nrelated content. For example, if the user requests an album to be played, your\napp could fill the queue with the album's tracklist.\n\nIn addition to \"Play\" queries, Android Auto and AAOS recognize voice queries to\ncontrol playback like \"pause music\" and \"next song\" and match these commands to\nthe appropriate media session callbacks, such as `onPause` and `onSkipToNext`.\n\nTo learn more about implementing voice-enabled playback actions, see\n[Google Assistant and media apps](/media/implement/assistant)."]]
