تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بعد تشغيل "مساعد Google" على مشروعك، جرِّب تنفيذ ما يلي:
تخصيص طريقة تفاعل مشروعك مع "مساعد Google". على سبيل المثال، يمكنك تشغيل "مساعد Google" بضغطة زرّ أو وميض مصباح LED عند إعادة تشغيل الصوت. يمكنك أيضًا عرض نص خاص بميزة التعرّف على الكلام من "مساعد Google" على الشاشة.
التحكّم في مشروعك باستخدام أوامر مخصّصة على سبيل المثال، يمكنك أن تطلب من آلة تحضير مشروبات الكوكتيل المستندة إلى "مساعد Google" تحضير مشروبك المفضّل.
تخصيص طريقة تفاعل مشروعك مع "مساعد Google"
تشغيل "مساعد Google"
من خلال واجهة برمجة تطبيقات خدمة مساعد Google، يمكنك التحكم في حالات تشغيل طلب لخدمة "مساعد Google". عدِّل نموذج الرمز للتحكّم في ذلك (على سبيل المثال، بضغطة زرّ). يتم تنفيذ طلب من "مساعد Google" من خلال إرسال طلب إلى EmbeddedAssistant.Assist.
الحصول على نص طلب المستخدم
تمنحك حزمة تطوير البرامج (SDK) لخدمة "مساعد Google" نصًا نصيًا لطلب المستخدم. يمكنك استخدام هذه المعلومات لتقديم ملاحظات للمستخدم من خلال عرض النص على الشاشة أو حتى لشيء أكثر إبداعًا مثل تنفيذ بعض الإجراءات المحلية على الجهاز.
تتيح حزمة تطوير البرامج (SDK) الخاصة بـ "مساعد Google" عرض استجابة "مساعد Google" على شاشة في حال ظهور ردود مرئية على طلبات بحث معيّنة. على سبيل المثال، سيعرض طلب البحث ما حالة الطقس في ماونتن فيو؟ درجة الحرارة الحالية، بالإضافة إلى تمثيل مصوَّر للطقس واقتراحات لطلبات البحث ذات الصلة. تتوفّر بيانات HTML5 هذه (في حال توفّرها) في الحقل ScreenOut.data في حال تفعيل هذه الميزة.
يمكن تفعيل هذا الخيار في نماذجpushtotalk.py وtextinput.py باستخدام علامة سطر الأوامر --display. يتم عرض البيانات في نافذة متصفّح.
إرسال الطلبات عبر إدخال النص
إذا كانت لديك واجهة نصية (مثل لوحة مفاتيح) متصلة بالجهاز، اضبط الحقل text_query في حقل config (راجِع AssistConfig). ولا تضبط الحقل audio_in_config.
يتضمّن نموذج الرمز الملف textinput.py. يمكنك تشغيل هذا الملف لإرسال الاستعلامات عبر إدخال النص.
إرسال طلبات البحث عبر إدخال الملف الصوتي
يتضمّن نموذج الرمز الملف audiofileinput.py. يمكنك تشغيل هذا الملف لإرسال استعلام عبر ملف صوتي. يؤدي ذلك إلى إنشاء ملف صوتي يتضمّن ردّ "مساعد Google".
التحكّم في مشروعك باستخدام أوامر مخصّصة
يمكنك إضافة أوامر مخصصة إلى مساعد Google تتيح لك التحكم في مشروعك عبر الصوت.
أنشِئ وصفة طعام IFTTT لخدمة "مساعد Google". بعد ذلك، يمكنك ضبط IFTTT لتقديم طلب HTTP مخصّص إلى نقطة نهاية تختارها استجابةً لطلب بحث من "مساعد Google". لتنفيذ ذلك، استخدِم إجراءات IFTTT الخاصة بأداة Maker.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCustomize interactions with the Google Assistant, such as triggering it with a button or displaying speech recognition transcripts.\u003c/p\u003e\n"],["\u003cp\u003eControl your projects using custom commands through Device Actions or IFTTT recipes.\u003c/p\u003e\n"],["\u003cp\u003eAccess the Assistant's response in various formats like text, HTML for visual responses, and audio.\u003c/p\u003e\n"],["\u003cp\u003eSubmit queries to the Assistant using either text input (like a keyboard) or audio files.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the provided sample code and documentation to integrate these features into your projects.\u003c/p\u003e\n"]]],[],null,["Once you have the Google Assistant running on your project, give these a try:\n\n1. [Customize](#custom-interaction) how your project interacts with the\n Assistant. For example, trigger the Assistant with the push of a button or\n blink an LED when playing back audio. You can even show a speech recognition\n transcript from the Assistant on a display.\n\n2. [Control](#device-control) your project with custom commands.\n For example, ask your Assistant-enabled [mocktail maker](http://deeplocal.com/mocktailsmixer/)\n to make your favorite drink.\n\nCustomize how your project interacts with the Assistant\n\nTrigger the Assistant\n\nWith the Google Assistant Service API, you control when to trigger an Assistant\nrequest. Modify the [sample code](https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-sdk/googlesamples/assistant/grpc)\nto control this (for example, at the push of a button). Triggering\nan Assistant request is done by sending a request to [`EmbeddedAssistant.Assist`](/assistant/sdk/reference/rpc/google.assistant.embedded.v1alpha2#google.assistant.embedded.v1alpha2.EmbeddedAssistant.Assist).\n\nGet the transcript of the user request\n\nThe Google Assistant SDK gives you a text transcript of the user request. Use\nthis to provide feedback to the user by rendering the text to a display, or even\nfor something more creative such as performing some local actions on the device.\n\nThis transcript is located in the [`SpeechRecognitionResult.transcript`](/assistant/sdk/reference/rpc/google.assistant.embedded.v1alpha2#speechrecognitionresult) field.\n\nGet the text of the Assistant's response\n\nThe Google Assistant SDK gives you the plain text of the Assistant response. Use this\nto provide feedback to the user by rendering the text to a display.\n\nThis text is located in the [`DialogStateOut.supplemental_display_text`](/assistant/sdk/reference/rpc/google.assistant.embedded.v1alpha2#dialogstateout)\nfield.\n\nGet the Assistant's visual response\n\nThe Google Assistant SDK supports rendering the Assistant response to a\ndisplay in the case of visual responses to certain queries. For example,\nthe query *What is the weather in Mountain View?* will render the current\ntemperature, a pictorial representation of the weather, and suggestions for\nrelated queries. This HTML5 data (if present) is located in the\n[`ScreenOut.data`](/assistant/sdk/reference/rpc/google.assistant.embedded.v1alpha2#screenout) field if this feature is [enabled](/assistant/sdk/guides/service/integrate#text-response).\n\nThis can be enabled in the `pushtotalk.py` and `textinput.py` [samples](https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-sdk/googlesamples/assistant/grpc)\nwith the `--display` command line flag. The data is rendered in a browser window.\n| **Note:** If you are sending commands over SSH to a Raspberry Pi with a connected display, make sure you run `export DISPLAY=:0` before running the sample with the `--display` command line flag.\n\nSubmitting queries via text input\n\nIf you have a text interface (for example, a keyboard) attached to the device,\nset the `text_query` field in the `config` field (see [`AssistConfig`](/assistant/sdk/reference/rpc/google.assistant.embedded.v1alpha2#assistconfig)).\nDo not set the `audio_in_config` field.\n\nThe [sample code](https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-sdk/googlesamples/assistant/grpc)\nincludes the file `textinput.py`. You can run this file to submit queries via\ntext input.\n\nSubmitting queries via audio file input\n\nThe [sample code](https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-sdk/googlesamples/assistant/grpc)\nincludes the file `audiofileinput.py`. You can run this file to submit a query\nvia an audio file. The sample outputs an audio file with the Assistant's response.\n\nControl your project with custom commands\n\nYou can add custom commands to the Assistant that allow you to control your\nproject via voice.\n\nHere are two ways to do this:\n\n- Extend the Google Assistant Service sample to include [Device Actions](/assistant/sdk/guides/service/python/extend/install-hardware).\n\n- Create an [IFTTT recipe](https://support.google.com/googlehome/answer/7194656)\n for the Assistant. Then configure IFTTT to make a custom HTTP request to an\n endpoint you choose in response to an Assistant command. To do so, use\n [Maker IFTTT actions](http://maker.ifttt.com)."]]
