تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك دمج الإجراءات الصوتية في تطبيق الوسائط لتحسين سلامة السائق وراحته من خلال الحدّ من مصادر التشتيت. عندما يرصد نظاما التشغيل 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
إذا لم يحدّد المستخدم عبارات بحث. على سبيل المثال، إذا قال المستخدم "تشغيل بعض الموسيقى"، في هذه الحالة، يمكن لتطبيقك تشغيل مقطع صوتي جديد أو مقطع تم تشغيله مؤخرًا.
إذا كان تطبيقك لا يمكنه معالجة طلب بحث بسرعة، لا تحظر في onPlayFromSearch.
بدلاً من ذلك، اضبط حالة التشغيل على STATE_CONNECTING ونفِّذ عملية البحث على سلسلة محادثات غير متزامنة.
عند بدء التشغيل، ننصحك بتعبئة قائمة انتظار جلسة الوسائط بالمحتوى ذي الصلة. على سبيل المثال، إذا طلب المستخدم تشغيل ألبوم، يمكن لتطبيقك ملء قائمة الانتظار بقائمة الأغاني في الألبوم.
بالإضافة إلى طلبات البحث "تشغيل"، يتعرّف كل من Android Auto وAAOS على طلبات البحث الصوتية للتحكّم في التشغيل، مثل "إيقاف الموسيقى مؤقتًا" و "الأغنية التالية"، ويطابق هذه الأوامر مع عمليات رد الاتصال المناسبة لجلسة الوسائط، مثل onPause وonSkipToNext.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-22 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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)."]]
