کاوش در Dialogflow
برای وارد کردن نمونه «پاسخهای» ما در Dialogflow، روی ادامه کلیک کنید. سپس، مراحل زیر را برای استقرار و آزمایش نمونه دنبال کنید:
- نام عاملی را وارد کنید و عامل Dialogflow جدیدی برای نمونه ایجاد کنید.
- پساز اینکه وارد کردن عامل تمام شد، روی رفتن به عامل کلیک کنید.
- از منو پیمایش اصلی، به انجام سفارش بروید.
- ویرایشگر درونخطی را فعال کنید، سپس روی استقرار کلیک کنید. ویرایشگر حاوی کد نمونه است.
- از منو پیمایش اصلی، به ادغامها بروید، سپس روی دستیار Google کلیک کنید.
- در پنجره مقیدی که ظاهر میشود، پیشنمایش خودکار تغییرات را فعال کنید و روی آزمایش کلیک کنید تا شبیهساز «کنشها» باز شود.
- در شبیهساز،
Talk to my test appرا برای آزمایش نمونه وارد کنید!
اگر میخواهید عناصر دیداری را برای بهبود تعاملات کاربر با «کنش» خود نمایش دهید، از پاسخ غنی استفاده کنید. این عناصر دیداری میتوانند نکاتی درباره نحوه ادامه مکالمه ارائه دهند.
پاسخهای غنی میتوانند در تجربههای فقط صفحهنمایش یا صوتی و صفحهنمایش نشان داده شوند. این آگهیها میتوانند شامل مؤلفههای زیر باشند:
- یک یا دو پاسخ ساده (حبابک گپ).
- کارت پایه اختیاری.
- تراشههای پیشنهاد اختیاری.
- تراشه پیوند خروجی اختیاری.
همچنین میتوانید رهنمودهای طراحی مکالمه ما را مرور کنید تا با نحوه گنجاندن این عناصر دیداری در «کنش» خود آشنا شوید.
مشخصات
پاسخهای غنی الزامات و ویژگیهای اختیاری زیر را دارند که میتوانید پیکربندی کنید:
- در سطوح دارای قابلیت
actions.capability.SCREEN_OUTPUTپشتیبانی میشود. - اولین مورد در پاسخ غنی باید پاسخ ساده باشد.
- حداکثر دو پاسخ ساده.
- حداکثر یک کارت پایه یا
StructuredResponse. - حداکثر ۸ تراشه پیشنهاد.
- تراشههای پیشنهاد در
FinalResponseمجاز نیستند - درحالحاضر پیوند دادن به وب از نمایشگرهای هوشمند پشتیبانی نمیشود.
بخشهای زیر نحوه ساخت انواع مختلف پاسخهای غنی را نشان میدهد.
کارت پایه
کارت پایه اطلاعاتی را نمایش میدهد که میتواند شامل موارد زیر باشد:
- تصویر
- عنوان
- عنوان فرعی
- متن نوشتار
- دکمه پیوند
- حاشیه
از کارتهای پایه عمدتاً برای اهداف نمایشی استفاده کنید. این کارتها بهگونهای طراحی شدهاند که مختصر باشند، اطلاعات کلیدی (یا خلاصه) را به کاربران ارائه دهند، و به کاربران اجازه دهند درصورت تمایل (بااستفاده از پیوند وب) اطلاعات بیشتری کسب کنند.
در اکثر موارد، باید تراشههای پیشنهاد را در زیر کارتها اضافه کنید تا مکالمه را ادامه دهید یا تغییر دهید.
بههیچوجه اطلاعات ارائهشده در کارت را در حبابک گپ تکرار نکنید.
مشخصات
نوع پاسخ کارت پایه دارای الزامات و ویژگیهای اختیاری زیر است که میتوانید پیکربندی کنید:
- در سطوح دارای قابلیت
actions.capability.SCREEN_OUTPUTپشتیبانی میشود. - نوشتار قالببندیشده (اگر تصویری وجود نداشته باشد، الزامی است)
- نوشتار ساده بهطور پیشفرض.
- نباید حاوی پیوند باشد.
- با تصویر حداکثر ۱۰ خط، بدون تصویر حداکثر ۱۵ خط. این مقدار حدود ۵۰۰ نویسه (با تصویر) یا ۷۵۰ نویسه (بدون تصویر) است. تلفنهای دارای صفحهنمایش کوچکتر همچنین نوشتار را زودتر از تلفنهای دارای صفحهنمایش بزرگتر کوتاه میکنند. اگر نوشتار خطوط زیادی داشته باشد، در آخرین شکست کلمه با سهنقطه کوتاه میشود.
- زیرمجموعه محدودی از markdown پشتیبانی میشود:
- خط جدید با فاصله دوگانه و بهدنبال آن \n
**bold***italics*
- تصویر (اگر نوشتار قالببندیشده وجود نداشته باشد، الزامی است)
- همه تصاویر باید ۱۹۲ dp ارتفاع داشته باشند.
- اگر نسبت ابعادی تصویر با صفحهنمایش متفاوت باشد، تصویر در مرکز قرار میگیرد و نوارهای خاکستری در لبههای عمودی یا افقی آن نمایش داده میشود.
- منبع تصویر نشانی وب است.
- گیفهای حرکتی مجاز است.
اختیاری
- عنوان
- نوشتار ساده.
- قلم و اندازه ثابت.
- حداکثر یک خط؛ نویسههای اضافی کوتاه میشوند.
- اگر عنوانی مشخص نشده باشد، ارتفاع کارت جمع میشود.
- عنوان فرعی
- نوشتار ساده.
- قلم و اندازه قلم ثابت.
- حداکثر یک خط؛ نویسههای اضافی کوتاه میشوند.
- اگر زیرنویسی مشخص نشده باشد، ارتفاع کارت جمع میشود.
- دکمه پیوند
- عنوان پیوند الزامی است
- حداکثر یک پیوند
- پیوند به سایتهای خارج از دامنه توسعهدهنده مجاز است.
- نوشتار پیوند نباید گمراهکننده باشد. این مورد در فرایند تأیید بررسی میشود.
- کارت پایه بدون پیوند هیچ قابلیت تعاملی ندارد. با تکضرب زدن روی پیوند، کاربر به پیوند هدایت میشود، درحالیکه بدنه اصلی کارت غیرفعال میماند.
- حاشیه
- حاشیه بین کارت و محفظه تصویر را میتوان برای سفارشیسازی ارائه کارت پایه تنظیم کرد.
- با تنظیم ویژگی رشته JSON پیکربندی شده است
imageDisplayOptions
کدگذاری نمونه
Node.js
app.intent('Basic Card', (conv) => { if (!conv.screen) { conv.ask('Sorry, try this on a screen device or select the ' + 'phone surface in the simulator.'); conv.ask('Which response would you like to see next?'); return; } conv.ask(`Here's an example of a basic card.`); conv.ask(new BasicCard({ text: `This is a basic card. Text in a basic card can include "quotes" and most other unicode characters including emojis. Basic cards also support some markdown formatting like *emphasis* or _italics_, **strong** or __bold__, and ***bold itallic*** or ___strong emphasis___ as well as other things like line \nbreaks`, // Note the two spaces before '\n' required for // a line break to be rendered in the card. subtitle: 'This is a subtitle', title: 'Title: this is a title', buttons: new Button({ title: 'This is a button', url: 'https://assistant.google.com/', }), image: new Image({ url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png', alt: 'Image alternate text', }), display: 'CROPPED', })); conv.ask('Which response would you like to see next?'); });
جاوا
@ForIntent("Basic Card") public ActionResponse basicCard(ActionRequest request) { ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) { return responseBuilder .add("Sorry, try ths on a screen device or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } // Prepare formatted text for card String text = "This is a basic card. Text in a basic card can include \"quotes\" and\n" + " most other unicode characters including emoji \uD83D\uDCF1. Basic cards also support\n" + " some markdown formatting like *emphasis* or _italics_, **strong** or\n" + " __bold__, and ***bold itallic*** or ___strong emphasis___ as well as other\n" + " things like line \\nbreaks"; // Note the two spaces before '\n' required for // a line break to be rendered in the card. responseBuilder .add("Here's an example of a basic card.") .add( new BasicCard() .setTitle("Title: this is a title") .setSubtitle("This is a subtitle") .setFormattedText(text) .setImage( new Image() .setUrl( "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png") .setAccessibilityText("Image alternate text")) .setImageDisplayOptions("CROPPED") .setButtons( new ArrayList<Button>( Arrays.asList( new Button() .setTitle("This is a Button") .setOpenUrlAction( new OpenUrlAction().setUrl("https://assistant.google.com")))))) .add("Which response would you like to see next?"); return responseBuilder.build(); }
Node.js
if (!conv.screen) { conv.ask('Sorry, try this on a screen device or select the ' + 'phone surface in the simulator.'); conv.ask('Which response would you like to see next?'); return; } conv.ask(`Here's an example of a basic card.`); conv.ask(new BasicCard({ text: `This is a basic card. Text in a basic card can include "quotes" and most other unicode characters including emojis. Basic cards also support some markdown formatting like *emphasis* or _italics_, **strong** or __bold__, and ***bold itallic*** or ___strong emphasis___ as well as other things like line \nbreaks`, // Note the two spaces before '\n' required for // a line break to be rendered in the card. subtitle: 'This is a subtitle', title: 'Title: this is a title', buttons: new Button({ title: 'This is a button', url: 'https://assistant.google.com/', }), image: new Image({ url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png', alt: 'Image alternate text', }), display: 'CROPPED', })); conv.ask('Which response would you like to see next?');
جاوا
ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) { return responseBuilder .add("Sorry, try ths on a screen device or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } // Prepare formatted text for card String text = "This is a basic card. Text in a basic card can include \"quotes\" and\n" + " most other unicode characters including emoji \uD83D\uDCF1. Basic cards also support\n" + " some markdown formatting like *emphasis* or _italics_, **strong** or\n" + " __bold__, and ***bold itallic*** or ___strong emphasis___ as well as other\n" + " things like line \\nbreaks"; // Note the two spaces before '\n' required for // a line break to be rendered in the card. responseBuilder .add("Here's an example of a basic card.") .add( new BasicCard() .setTitle("Title: this is a title") .setSubtitle("This is a subtitle") .setFormattedText(text) .setImage( new Image() .setUrl( "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png") .setAccessibilityText("Image alternate text")) .setImageDisplayOptions("CROPPED") .setButtons( new ArrayList<Button>( Arrays.asList( new Button() .setTitle("This is a Button") .setOpenUrlAction( new OpenUrlAction().setUrl("https://assistant.google.com")))))) .add("Which response would you like to see next?"); return responseBuilder.build();
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "payload": { "google": { "expectUserResponse": true, "richResponse": { "items": [ { "simpleResponse": { "textToSpeech": "Here's an example of a basic card." } }, { "basicCard": { "title": "Title: this is a title", "subtitle": "This is a subtitle", "formattedText": "This is a basic card. Text in a basic card can include \"quotes\" and\n most other unicode characters including emojis. Basic cards also support\n some markdown formatting like *emphasis* or _italics_, **strong** or\n __bold__, and ***bold itallic*** or ___strong emphasis___ as well as other\n things like line \nbreaks", "image": { "url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png", "accessibilityText": "Image alternate text" }, "buttons": [ { "title": "This is a button", "openUrlAction": { "url": "https://assistant.google.com/" } } ], "imageDisplayOptions": "CROPPED" } }, { "simpleResponse": { "textToSpeech": "Which response would you like to see next?" } } ] } } } }
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "expectUserResponse": true, "expectedInputs": [ { "possibleIntents": [ { "intent": "actions.intent.TEXT" } ], "inputPrompt": { "richInitialPrompt": { "items": [ { "simpleResponse": { "textToSpeech": "Here's an example of a basic card." } }, { "basicCard": { "title": "Title: this is a title", "subtitle": "This is a subtitle", "formattedText": "This is a basic card. Text in a basic card can include \"quotes\" and\n most other unicode characters including emojis. Basic cards also support\n some markdown formatting like *emphasis* or _italics_, **strong** or\n __bold__, and ***bold itallic*** or ___strong emphasis___ as well as other\n things like line \nbreaks", "image": { "url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png", "accessibilityText": "Image alternate text" }, "buttons": [ { "title": "This is a button", "openUrlAction": { "url": "https://assistant.google.com/" } } ], "imageDisplayOptions": "CROPPED" } }, { "simpleResponse": { "textToSpeech": "Which response would you like to see next?" } } ] } } } ] }
گردونه مرور کردن
گردونه مرور یک پاسخ غنی است که به کاربران اجازه میدهد بهصورت عمودی پیمایش کنند و کاشیای را در مجموعه انتخاب کنند. گردونههای مرور بهطور خاص برای محتوای وب طراحی شدهاند و کاشی انتخابشده را در مرورگر وب (یا مرورگر AMP، اگر همه کاشیها AMP-فعال باشند) باز میکنند. گردونه مرور نیز در سطح «دستیار» کاربر برای مرور بعدی باقی میماند.
مشخصات
نوع پاسخ گردونه مرور الزامات و ویژگیهای اختیاری زیر را دارد که میتوانید پیکربندی کنید:
- در سطوحی که هر دو قابلیت
actions.capability.SCREEN_OUTPUTوactions.capability.WEB_BROWSERرا دارند پشتیبانی میشود. این نوع پاسخ درحالحاضر در نمایشگرهای هوشمند دردسترس نیست. - گردونه مرور
- حداکثر ده کاشی.
- حداقل دو کاشی.
- همه کاشیهای گردونه باید به محتوای وب پیوند داده شوند (محتوای AMP توصیه میشود).
- برای اینکه کاربر به نمایشگر AMP هدایت شود،
urlHintTypeدر کاشیهای محتوای AMP باید روی «AMP_CONTENT» تنظیم شود.
- برای اینکه کاربر به نمایشگر AMP هدایت شود،
- درحال مرور کاشیهای گردونه
- سازگاری کاشی (الزامی):
- همه کاشیها در گردونه مرور باید مؤلفههای یکسانی داشته باشند. برای مثال، اگر یک کاشی فیلد تصویر داشته باشد، بقیه کاشیها در گردونه نیز باید فیلد تصویر داشته باشند.
- اگر همه کاشیهای گردونه مرور به محتوای AMP-فعال پیوند داشته باشند، کاربر به مرورگر AMP با عملکرد اضافی هدایت میشود. اگر هرکاشی به محتوای غیر AMP پیوند داشته باشد، همه کاشیها کاربران را به مرورگر وب هدایت میکنند.
- تصویر (اختیاری)
- تصویر باید ۱۲۸ دیپی ارتفاع و ۲۳۲ دیپی عرض داشته باشد.
- اگر نسبت ابعادی تصویر با کادر محدودکننده تصویر مطابقت نداشته باشد، تصویر در مرکز قرار میگیرد و در دو طرف آن نوار قرار میگیرد. در تلفنهای هوشمند، تصویر در مرکز مربعی با گوشههای گرد قرار میگیرد.
- اگر پیوند تصویر خراب باشد، بهجای آن از تصویر جایبان استفاده میشود.
- متن جایگزین برای تصویر الزامی است.
- عنوان (الزامی)
- گزینههای قالببندی مشابه با کارت نوشتاری پایه.
- عنوانها باید منحصربهفرد باشند (برای پشتیبانی از انتخاب صوتی).
- حداکثر دو خط نوشتار.
- اندازه قلم ۱۶ sp.
- توضیحات (اختیاری)
- گزینههای قالببندی مشابه با کارت نوشتاری پایه.
- حداکثر چهار خط نوشتار.
- با سهنقطه (...) کوتاه شده است
- اندازه قلم ۱۴sp، رنگ خاکستری.
- پانویس (اختیاری)
- قلم و اندازه قلم ثابت.
- حداکثر یک خط نوشتار.
- با سهنقطه (...) کوتاه شده است
- در پایین لنگر شده است، بنابراین کاشیهایی که خطوط کمتری از نوشتار اصلی دارند ممکن است فضای سفید بالای زیرنوشتار داشته باشند.
- اندازه قلم ۱۴sp، رنگ خاکستری.
- سازگاری کاشی (الزامی):
- تعامل
- کاربر میتواند برای مشاهده موارد، بهصورت عمودی پیمایش کند.
- کارت تکضرب: تکضرب زدن روی یک مورد، کاربر را به مرورگر هدایت میکند و صفحه پیوندشده را نمایش میدهد.
- ورودی گفتاری
- رفتار میکروفون
- وقتی گردونه مرور برای کاربر ارسال میشود، میکروفون دوباره باز نمیشود.
- کاربر همچنان میتواند روی میکروفون تکضرب بزند یا «دستیار» را فراخوانی کند («Ok Google») تا میکروفون دوباره باز شود.
- رفتار میکروفون
راهنمایی
بهطور پیشفرض، پساز ارسال گردونه مرور، میکروفون بسته میماند. اگر میخواهید مکالمه را بعداز آن ادامه دهید، اکیداً توصیه میکنیم تراشههای پیشنهاد را زیر گردونه اضافه کنید.
هرگز گزینههای ارائهشده در فهرست را بهعنوان تراشههای پیشنهادی تکرار نکنید. تراشهها در این بافت برای تغییر جهت مکالمه استفاده میشوند (نه برای انتخاب گزینه).
همانند فهرستها، حبابک گپی که همراه با کارت گردونه است، زیرمجموعهای از صدا (تبدیل نوشتار به گفتار/ SSML) است. صدای (نوشتار به گفتار/ SSML) اینجا اولین کاشی را در گردونه ادغام میکند، و همچنین اکیداً توصیه میکنیم که همه عناصر را از گردونه نخوانید. بهتر است اولین مورد و دلیل وجود آن را ذکر کنید (برای مثال، محبوبترین، جدیدترین خرید، موردی که بیشتر درباره آن صحبت شده است).
کدگذاری نمونه
Node.js
app.intent('Browsing Carousel', (conv) => { if (!conv.screen || !conv.surface.capabilities.has('actions.capability.WEB_BROWSER')) { conv.ask('Sorry, try this on a phone or select the ' + 'phone surface in the simulator.'); conv.ask('Which response would you like to see next?'); return; } conv.ask(`Here's an example of a browsing carousel.`); conv.ask(new BrowseCarousel({ items: [ new BrowseCarouselItem({ title: 'Title of item 1', url: 'https://example.com', description: 'Description of item 1', image: new Image({ url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png', alt: 'Image alternate text', }), footer: 'Item 1 footer', }), new BrowseCarouselItem({ title: 'Title of item 2', url: 'https://example.com', description: 'Description of item 2', image: new Image({ url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png', alt: 'Image alternate text', }), footer: 'Item 2 footer', }), ], })); });
جاوا
@ForIntent("Browsing Carousel") public ActionResponse browseCarousel(ActionRequest request) { ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue()) || !request.hasCapability(Capability.WEB_BROWSER.getValue())) { return responseBuilder .add("Sorry, try this on a phone or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("Here's an example of a browsing carousel.") .add( new CarouselBrowse() .setItems( new ArrayList<CarouselBrowseItem>( Arrays.asList( new CarouselBrowseItem() .setTitle("Title of item 1") .setDescription("Description of item 1") .setOpenUrlAction(new OpenUrlAction().setUrl("https://example.com")) .setImage( new Image() .setUrl( "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png") .setAccessibilityText("Image alternate text")) .setFooter("Item 1 footer"), new CarouselBrowseItem() .setTitle("Title of item 2") .setDescription("Description of item 2") .setOpenUrlAction(new OpenUrlAction().setUrl("https://example.com")) .setImage( new Image() .setUrl( "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png") .setAccessibilityText("Image alternate text")) .setFooter("Item 2 footer"))))); return responseBuilder.build(); }
Node.js
if (!conv.screen || !conv.surface.capabilities.has('actions.capability.WEB_BROWSER')) { conv.ask('Sorry, try this on a phone or select the ' + 'phone surface in the simulator.'); conv.ask('Which response would you like to see next?'); return; } conv.ask(`Here's an example of a browsing carousel.`); conv.ask(new BrowseCarousel({ items: [ new BrowseCarouselItem({ title: 'Title of item 1', url: 'https://example.com', description: 'Description of item 1', image: new Image({ url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png', alt: 'Image alternate text', }), footer: 'Item 1 footer', }), new BrowseCarouselItem({ title: 'Title of item 2', url: 'https://example.com', description: 'Description of item 2', image: new Image({ url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png', alt: 'Image alternate text', }), footer: 'Item 2 footer', }), ], }));
جاوا
ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue()) || !request.hasCapability(Capability.WEB_BROWSER.getValue())) { return responseBuilder .add("Sorry, try this on a phone or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("Here's an example of a browsing carousel.") .add( new CarouselBrowse() .setItems( new ArrayList<CarouselBrowseItem>( Arrays.asList( new CarouselBrowseItem() .setTitle("Title of item 1") .setDescription("Description of item 1") .setOpenUrlAction(new OpenUrlAction().setUrl("https://example.com")) .setImage( new Image() .setUrl( "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png") .setAccessibilityText("Image alternate text")) .setFooter("Item 1 footer"), new CarouselBrowseItem() .setTitle("Title of item 2") .setDescription("Description of item 2") .setOpenUrlAction(new OpenUrlAction().setUrl("https://example.com")) .setImage( new Image() .setUrl( "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png") .setAccessibilityText("Image alternate text")) .setFooter("Item 2 footer"))))); return responseBuilder.build();
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "payload": { "google": { "expectUserResponse": true, "richResponse": { "items": [ { "simpleResponse": { "textToSpeech": "Here's an example of a browsing carousel." } }, { "carouselBrowse": { "items": [ { "title": "Title of item 1", "openUrlAction": { "url": "https://example.com" }, "description": "Description of item 1", "footer": "Item 1 footer", "image": { "url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png", "accessibilityText": "Image alternate text" } }, { "title": "Title of item 2", "openUrlAction": { "url": "https://example.com" }, "description": "Description of item 2", "footer": "Item 2 footer", "image": { "url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png", "accessibilityText": "Image alternate text" } } ] } } ] } } } }
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "expectUserResponse": true, "expectedInputs": [ { "inputPrompt": { "richInitialPrompt": { "items": [ { "simpleResponse": { "textToSpeech": "Here's an example of a browsing carousel." } }, { "carouselBrowse": { "items": [ { "description": "Description of item 1", "footer": "Item 1 footer", "image": { "accessibilityText": "Image alternate text", "url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png" }, "openUrlAction": { "url": "https://example.com" }, "title": "Title of item 1" }, { "description": "Description of item 2", "footer": "Item 2 footer", "image": { "accessibilityText": "Image alternate text", "url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png" }, "openUrlAction": { "url": "https://example.com" }, "title": "Title of item 2" } ] } } ] } }, "possibleIntents": [ { "intent": "actions.intent.TEXT" } ] } ] }
درحال رسیدگی به مورد انتخابشده
برای تعاملات کاربر با موارد گردونه مرور، نیازی به برآوردهسازی پیگیری نیست، زیرا گردونه انتقال مرورگر را مدیریت میکند. بهخاطر داشته باشید که پساز تعامل کاربر با مورد گردونه مرور، میکروفون دوباره باز نخواهد شد، بنابراین باید مکالمه را پایان دهید یا طبق راهنمایی بالا، تراشههای پیشنهادی را در پاسخ خود بگنجانید.
تراشههای پیشنهاد
از تراشههای پیشنهاد برای اشاره به پاسخها برای ادامه یا تغییر جهت مکالمه استفاده کنید. اگر درطول مکالمه، درخواست اصلی برای اقدام وجود دارد، آن را بهعنوان اولین تراشه پیشنهادی فهرست کنید.
هرزمان ممکن بود، باید یک پیشنهاد کلیدی را بهعنوان بخشی از حبابک گپ بگنجانید، اما این کار را فقط درصورتی انجام دهید که پاسخ یا مکالمه گپ طبیعی بهنظر برسد.
مشخصات
تراشههای پیشنهاد الزامات و ویژگیهای اختیاری زیر را دارند که میتوانید پیکربندی کنید:
- در سطوح دارای قابلیت
actions.capability.SCREEN_OUTPUTپشتیبانی میشود. - برای پیوند دادن تراشههای پیشنهادی به وب، سطوح باید قابلیت
actions.capability.WEB_BROWSERرا نیز داشته باشند. این قابلیت درحالحاضر در نمایشگرهای هوشمند دردسترس نیست. - حداکثر هشت تراشه.
- حداکثر طول نوشتار ۲۵ نویسه است.
فقط از نوشتار ساده پشتیبانی میکند.
کدگذاری نمونه
Node.js
app.intent('Suggestion Chips', (conv) => { if (!conv.screen) { conv.ask('Chips can be demonstrated on screen devices.'); conv.ask('Which response would you like to see next?'); return; } conv.ask('These are suggestion chips.'); conv.ask(new Suggestions('Suggestion 1')); conv.ask(new Suggestions(['Suggestion 2', 'Suggestion 3'])); conv.ask(new LinkOutSuggestion({ name: 'Suggestion Link', url: 'https://assistant.google.com/', })); conv.ask('Which type of response would you like to see next?'); ; });
جاوا
@ForIntent("Suggestion Chips") public ActionResponse suggestionChips(ActionRequest request) { ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) { return responseBuilder .add("Sorry, try ths on a screen device or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("These are suggestion chips.") .addSuggestions(new String[] {"Suggestion 1", "Suggestion 2", "Suggestion 3"}) .add( new LinkOutSuggestion() .setDestinationName("Suggestion Link") .setUrl("https://assistant.google.com/")) .add("Which type of response would you like to see next?"); return responseBuilder.build(); }
Node.js
if (!conv.screen) { conv.ask('Chips can be demonstrated on screen devices.'); conv.ask('Which response would you like to see next?'); return; } conv.ask('These are suggestion chips.'); conv.ask(new Suggestions('Suggestion 1')); conv.ask(new Suggestions(['Suggestion 2', 'Suggestion 3'])); conv.ask(new LinkOutSuggestion({ name: 'Suggestion Link', url: 'https://assistant.google.com/', })); conv.ask('Which type of response would you like to see next?');
جاوا
ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) { return responseBuilder .add("Sorry, try ths on a screen device or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("These are suggestion chips.") .addSuggestions(new String[] {"Suggestion 1", "Suggestion 2", "Suggestion 3"}) .add( new LinkOutSuggestion() .setDestinationName("Suggestion Link") .setUrl("https://assistant.google.com/")) .add("Which type of response would you like to see next?"); return responseBuilder.build();
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "payload": { "google": { "expectUserResponse": true, "richResponse": { "items": [ { "simpleResponse": { "textToSpeech": "These are suggestion chips." } }, { "simpleResponse": { "textToSpeech": "Which type of response would you like to see next?" } } ], "suggestions": [ { "title": "Suggestion 1" }, { "title": "Suggestion 2" }, { "title": "Suggestion 3" } ], "linkOutSuggestion": { "destinationName": "Suggestion Link", "url": "https://assistant.google.com/" } } } } }
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "expectUserResponse": true, "expectedInputs": [ { "possibleIntents": [ { "intent": "actions.intent.TEXT" } ], "inputPrompt": { "richInitialPrompt": { "items": [ { "simpleResponse": { "textToSpeech": "These are suggestion chips." } }, { "simpleResponse": { "textToSpeech": "Which type of response would you like to see next?" } } ], "suggestions": [ { "title": "Suggestion 1" }, { "title": "Suggestion 2" }, { "title": "Suggestion 3" } ], "linkOutSuggestion": { "destinationName": "Suggestion Link", "url": "https://assistant.google.com/" } } } } ] }
پاسخهای رسانهای
پاسخهای رسانه به «کنشهای» شما اجازه میدهد محتوای صوتی را با مدت زمان بازپخش بیشتر از محدودیت ۲۴۰ ثانیهای SSML پخش کنند. جزء اصلی پاسخ رسانه، کارت تکآهنگ است. این کارت به کاربر اجازه میدهد این عملیات را انجام دهد:
- ۱۰ ثانیه آخر را بازپخش کن.
- ۳۰ ثانیه به جلو بروید.
- مشاهده کل مدت محتوای رسانه.
- نشانگر پیشرفت را برای بازپخش صوتی مشاهده کنید.
- مشاهده زمان سپریشده بازپخش.
پاسخهای رسانهای از کنترلهای صوتی زیر برای تعامل صوتی پشتیبانی میکنند:
- «Ok Google, play» (Ok Google، پخش کن).
- «Ok Google, pause» (Ok Google، موقتاً متوقف کن).
- «Ok Google، متوقف کن.»
- «Ok Google، از اول شروع کن.»
کاربران همچنین میتوانند با گفتن عبارتهایی مثل «Ok Google، صدا را زیاد کن» یا «Ok Google، صدا را روی ۵۰ درصد تنظیم کن» میزان صدا را کنترل کنند. اگر «هدفها» در «کنش» شما عبارتهای آموزشی مشابهی را مدیریت کنند، اولویت دارند. اجازه دهید «دستیار» این درخواستهای کاربر را مدیریت کند، مگراینکه «کنش» شما دلیل خاصی برای انجام این کار داشته باشد.
مشخصات
پاسخهای رسانهای الزامات و ویژگیهای اختیاری زیر را دارند که میتوانید پیکربندی کنید:
- در سطوح دارای قابلیت
actions.capability.MEDIA_RESPONSE_AUDIOپشتیبانی میشود. - صدای بازپخش باید در فایل
.mp3با قالببندی صحیح باشد. جاریسازی زنده پشتیبانی نمیشود. - فایل رسانه برای بازپخش باید بهعنوان نشانی وب HTTPS مشخص شود.
- تصویر (اختیاری)
- درصورت تمایل میتوانید نماد یا تصویر اضافه کنید.
- نماد
- نمادتان بهصورت ریزعکس بدون حاشیه در سمت راست کارت پخشکننده رسانه نشان داده میشود.
- اندازه باید ۳۶ × ۳۶ دیپی باشد. اندازه تصاویر بزرگتر تغییر میکند تا در قاب جا شود.
- تصویر
- ارتفاع محتوی تصویر ۱۹۲ dp خواهد بود.
- تصویرتان در بالای کارت پخشکننده رسانه نشان داده میشود و کل عرض کارت را دربرمیگیرد. اکثر تصاویر با نوارهایی در بالا یا اطراف ظاهر میشوند.
- گیفهای حرکتی مجاز است.
- باید منبع تصویر را بهصورت نشانی وب مشخص کنید.
- متن جایگزین برای همه تصاویر الزامی است.
رفتار در سطوح
پاسخهای رسانهای در تلفنهای Android و Google Home پشتیبانی میشود. رفتار پاسخهای رسانهای به سطحی بستگی دارد که کاربران در آن با «کنشهای» شما تعامل میکنند.
در تلفنهای Android، کاربران میتوانند پاسخهای رسانهای را درصورت برآورده شدن هرکدام از این شرایط ببینند:
- «دستیار Google» در پیشزمینه باشد و صفحهنمایش تلفن روشن باشد.
- کاربر درحین پخش صدا از «دستیار Google» خارج میشود و ظرف ۱۰ دقیقه پساز تکمیل بازپخش به «دستیار Google» برمیگردد. هنگام بازگشت به «دستیار Google»، کاربر کارت رسانه و تراشههای پیشنهاد را میبیند.
- «دستیار» به کاربران اجازه میدهد میزان صدای دستگاه را در «کنش مکالمهای» شما با گفتن چیزهایی مثل «صدا را زیاد کن» یا «میزان صدا را روی ۵۰ درصد تنظیم کن» کنترل کنند. اگر قصدهایی دارید که عبارتهای آموزشی مشابهی را مدیریت میکنند، قصدهای شما اولویت دارند. توصیه میکنیم اجازه دهید «دستیار» این درخواستهای کاربر را مدیریت کند، مگراینکه «کنش» شما دلیل خاصی برای انجام این کار داشته باشد.
کنترلهای رسانه درحین قفل بودن تلفن دردسترس است. در Android، کنترلها در بخش اعلان نیز نشان داده میشود.
کدگذاری نمونه
نمونه کد زیر نشان میدهد که چگونه میتوانید پاسخهای غنی خود را بهروز کنید تا رسانه را شامل شود.
Node.js
app.intent('Media Response', (conv) => { if (!conv.surface.capabilities .has('actions.capability.MEDIA_RESPONSE_AUDIO')) { conv.ask('Sorry, this device does not support audio playback.'); conv.ask('Which response would you like to see next?'); return; } conv.ask('This is a media response example.'); conv.ask(new MediaObject({ name: 'Jazz in Paris', url: 'https://storage.googleapis.com/automotive-media/Jazz_In_Paris.mp3', description: 'A funky Jazz tune', icon: new Image({ url: 'https://storage.googleapis.com/automotive-media/album_art.jpg', alt: 'Album cover of an ocean view', }), })); conv.ask(new Suggestions(['Basic Card', 'List', 'Carousel', 'Browsing Carousel'])); });
جاوا
@ForIntent("Media Response") public ActionResponse mediaResponse(ActionRequest request) { ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.MEDIA_RESPONSE_AUDIO.getValue())) { return responseBuilder .add("Sorry, this device does not support audio playback.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("This is a media response example.") .add( new MediaResponse() .setMediaObjects( new ArrayList<MediaObject>( Arrays.asList( new MediaObject() .setName("Jazz in Paris") .setDescription("A funky Jazz tune") .setContentUrl( "https://storage.googleapis.com/automotive-media/Jazz_In_Paris.mp3") .setIcon( new Image() .setUrl( "https://storage.googleapis.com/automotive-media/album_art.jpg") .setAccessibilityText("Album cover of an ocean view"))))) .setMediaType("AUDIO")) .addSuggestions(new String[] {"Basic Card", "List", "Carousel", "Browsing Carousel"}); return responseBuilder.build(); }
Node.js
if (!conv.surface.capabilities .has('actions.capability.MEDIA_RESPONSE_AUDIO')) { conv.ask('Sorry, this device does not support audio playback.'); conv.ask('Which response would you like to see next?'); return; } conv.ask('This is a media response example.'); conv.ask(new MediaObject({ name: 'Jazz in Paris', url: 'https://storage.googleapis.com/automotive-media/Jazz_In_Paris.mp3', description: 'A funky Jazz tune', icon: new Image({ url: 'https://storage.googleapis.com/automotive-media/album_art.jpg', alt: 'Album cover of an ocean view', }), })); conv.ask(new Suggestions(['Basic Card', 'List', 'Carousel', 'Browsing Carousel']));
جاوا
ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.MEDIA_RESPONSE_AUDIO.getValue())) { return responseBuilder .add("Sorry, this device does not support audio playback.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("This is a media response example.") .add( new MediaResponse() .setMediaObjects( new ArrayList<MediaObject>( Arrays.asList( new MediaObject() .setName("Jazz in Paris") .setDescription("A funky Jazz tune") .setContentUrl( "https://storage.googleapis.com/automotive-media/Jazz_In_Paris.mp3") .setIcon( new Image() .setUrl( "https://storage.googleapis.com/automotive-media/album_art.jpg") .setAccessibilityText("Album cover of an ocean view"))))) .setMediaType("AUDIO")) .addSuggestions(new String[] {"Basic Card", "List", "Carousel", "Browsing Carousel"}); return responseBuilder.build();
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "payload": { "google": { "expectUserResponse": true, "richResponse": { "items": [ { "simpleResponse": { "textToSpeech": "This is a media response example." } }, { "mediaResponse": { "mediaType": "AUDIO", "mediaObjects": [ { "contentUrl": "https://storage.googleapis.com/automotive-media/Jazz_In_Paris.mp3", "description": "A funky Jazz tune", "icon": { "url": "https://storage.googleapis.com/automotive-media/album_art.jpg", "accessibilityText": "Album cover of an ocean view" }, "name": "Jazz in Paris" } ] } } ], "suggestions": [ { "title": "Basic Card" }, { "title": "List" }, { "title": "Carousel" }, { "title": "Browsing Carousel" } ] } } } }
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "expectUserResponse": true, "expectedInputs": [ { "possibleIntents": [ { "intent": "actions.intent.TEXT" } ], "inputPrompt": { "richInitialPrompt": { "items": [ { "simpleResponse": { "textToSpeech": "This is a media response example." } }, { "mediaResponse": { "mediaType": "AUDIO", "mediaObjects": [ { "contentUrl": "https://storage.googleapis.com/automotive-media/Jazz_In_Paris.mp3", "description": "A funky Jazz tune", "icon": { "url": "https://storage.googleapis.com/automotive-media/album_art.jpg", "accessibilityText": "Album cover of an ocean view" }, "name": "Jazz in Paris" } ] } } ], "suggestions": [ { "title": "Basic Card" }, { "title": "List" }, { "title": "Carousel" }, { "title": "Browsing Carousel" } ] } } } ] }
راهنمایی
پاسخ شما باید شامل mediaResponse با mediaType از AUDIO باشد و
حاوی mediaObject در آرایه مورد پاسخ غنی باشد. پاسخ رسانهای از یک شیء رسانهای پشتیبانی میکند. شیء رسانه باید حاوی نشانی وب محتوای فایل صوتی باشد. شیء رسانه میتواند بهصورت اختیاری شامل نام، زیرمتن (توضیحات)، و نماد یا نشانی وب تصویر باشد.
در تلفنها و Google Home، وقتی «کنش» شما بازپخش صدا را تکمیل میکند،
«دستیار Google» بررسی میکند که آیا پاسخ رسانه FinalResponse است یا نه.
اگر نه، یک فراخوانی برگشتی به تحقق شما ارسال میکند، که به شما اجازه میدهد به کاربر پاسخ دهید.
اگر پاسخ FinalResponse نباشد، «کنش» شما باید شامل تراشههای پیشنهاد باشد.
مدیریت تماس برگشتی پساز تکمیل بازپخش
«کنش» شما باید قصد actions.intent.MEDIA_STATUS را برای درخواست از کاربر برای پیگیری (مثلاً برای پخش آهنگ دیگر) مدیریت کند. «کنش» شما این فراخوانی برگشتی را پساز تکمیل بازپخش رسانه دریافت میکند. در فراخوانی برگشتی،
آرگومان MEDIA_STATUS حاوی اطلاعات وضعیت درباره رسانه فعلی است. مقدار
وضعیت FINISHED یا STATUS_UNSPECIFIED خواهد بود.
استفاده از Dialogflow
اگر میخواهید انشعاب مکالمهای را در Dialogflow انجام دهید، باید
بافت ورودی actions_capability_media_response_audio را در
هدف تنظیم کنید تا مطمئن شوید فقط در سطوحی که از پاسخ رسانهای پشتیبانی میکنند راهاندازی میشود.
درحال آمادهسازی سفارش
تکهکد زیر نشان میدهد که چگونه میتوانید کد برآوردهسازی را برای «کنش» خود بنویسید. اگر از Dialogflow استفاده میکنید، actions.intent.MEDIA_STATUS را با نام کنش مشخصشده در هدفی که رویداد actions_intent_MEDIA_STATUS را دریافت میکند جایگزین کنید (برای مثال، «media.status.update»).
Node.js
app.intent('Media Status', (conv) => { const mediaStatus = conv.arguments.get('MEDIA_STATUS'); let response = 'Unknown media status received.'; if (mediaStatus && mediaStatus.status === 'FINISHED') { response = 'Hope you enjoyed the tune!'; } conv.ask(response); conv.ask('Which response would you like to see next?'); });
جاوا
@ForIntent("Media Status") public ActionResponse mediaStatus(ActionRequest request) { ResponseBuilder responseBuilder = getResponseBuilder(request); String mediaStatus = request.getMediaStatus(); String response = "Unknown media status received."; if (mediaStatus != null && mediaStatus.equals("FINISHED")) { response = "Hope you enjoyed the tune!"; } responseBuilder.add(response); responseBuilder.add("Which response would you like to see next?"); return responseBuilder.build(); }
Node.js
app.intent('actions.intent.MEDIA_STATUS', (conv) => { const mediaStatus = conv.arguments.get('MEDIA_STATUS'); let response = 'Unknown media status received.'; if (mediaStatus && mediaStatus.status === 'FINISHED') { response = 'Hope you enjoyed the tune!'; } conv.ask(response); conv.ask('Which response would you like to see next?'); });
جاوا
@ForIntent("actions.intent.MEDIA_STATUS") public ActionResponse mediaStatus(ActionRequest request) { ResponseBuilder responseBuilder = getResponseBuilder(request); String mediaStatus = request.getMediaStatus(); String response = "Unknown media status received."; if (mediaStatus != null && mediaStatus.equals("FINISHED")) { response = "Hope you enjoyed the tune!"; } responseBuilder.add(response); responseBuilder.add("Which response would you like to see next?"); return responseBuilder.build(); }
JSON
توجه داشته باشید که JSON زیر درخواست وبقلاب را شرح میدهد.
{ "responseId": "151b68df-98de-41fb-94b5-caeace90a7e9-21947381", "queryResult": { "queryText": "actions_intent_MEDIA_STATUS", "parameters": {}, "allRequiredParamsPresent": true, "fulfillmentText": "Webhook failed for intent: Media Status", "fulfillmentMessages": [ { "text": { "text": [ "Webhook failed for intent: Media Status" ] } } ], "outputContexts": [ { "name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_media_response_audio" }, { "name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_account_linking" }, { "name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_web_browser" }, { "name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_screen_output" }, { "name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_audio_output" }, { "name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/google_assistant_input_type_voice" }, { "name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_intent_media_status", "parameters": { "MEDIA_STATUS": { "@type": "type.googleapis.com/google.actions.v2.MediaStatus", "status": "FINISHED" } } } ], "intent": { "name": "projects/df-responses-kohler/agent/intents/068b27d3-c148-4044-bfab-dfa37eebd90d", "displayName": "Media Status" }, "intentDetectionConfidence": 1, "languageCode": "en" }, "originalDetectIntentRequest": { "source": "google", "version": "2", "payload": { "user": { "locale": "en-US", "lastSeen": "2019-08-04T23:57:15Z", "userVerificationStatus": "VERIFIED" }, "conversation": { "conversationId": "ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA", "type": "ACTIVE", "conversationToken": "[]" }, "inputs": [ { "intent": "actions.intent.MEDIA_STATUS", "rawInputs": [ { "inputType": "VOICE" } ], "arguments": [ { "name": "MEDIA_STATUS", "extension": { "@type": "type.googleapis.com/google.actions.v2.MediaStatus", "status": "FINISHED" } } ] } ], "surface": { "capabilities": [ { "name": "actions.capability.MEDIA_RESPONSE_AUDIO" }, { "name": "actions.capability.ACCOUNT_LINKING" }, { "name": "actions.capability.WEB_BROWSER" }, { "name": "actions.capability.SCREEN_OUTPUT" }, { "name": "actions.capability.AUDIO_OUTPUT" } ] }, "isInSandbox": true, "availableSurfaces": [ { "capabilities": [ { "name": "actions.capability.WEB_BROWSER" }, { "name": "actions.capability.AUDIO_OUTPUT" }, { "name": "actions.capability.SCREEN_OUTPUT" } ] } ], "requestType": "SIMULATOR" } }, "session": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA" }
JSON
توجه داشته باشید که JSON زیر درخواست وبقلاب را شرح میدهد.
{ "user": { "locale": "en-US", "lastSeen": "2019-08-06T07:38:40Z", "userVerificationStatus": "VERIFIED" }, "conversation": { "conversationId": "ABwppHGcqunXh1M6IE0lu2sVqXdpJfdpC5FWMkMSXQskK1nzb4IkSUSRqQzoEr0Ly0z_G3mwyZlk5rFtd1w", "type": "NEW" }, "inputs": [ { "intent": "actions.intent.MEDIA_STATUS", "rawInputs": [ { "inputType": "VOICE" } ], "arguments": [ { "name": "MEDIA_STATUS", "extension": { "@type": "type.googleapis.com/google.actions.v2.MediaStatus", "status": "FINISHED" } } ] } ], "surface": { "capabilities": [ { "name": "actions.capability.SCREEN_OUTPUT" }, { "name": "actions.capability.WEB_BROWSER" }, { "name": "actions.capability.AUDIO_OUTPUT" }, { "name": "actions.capability.MEDIA_RESPONSE_AUDIO" }, { "name": "actions.capability.ACCOUNT_LINKING" } ] }, "isInSandbox": true, "availableSurfaces": [ { "capabilities": [ { "name": "actions.capability.WEB_BROWSER" }, { "name": "actions.capability.AUDIO_OUTPUT" }, { "name": "actions.capability.SCREEN_OUTPUT" } ] } ], "requestType": "SIMULATOR" }
کارتهای جدول
کارتهای جدولی به شما امکان میدهند دادههای جدولی را در پاسخ خود نمایش دهید (برای مثال، جایگاههای ورزشی، نتایج انتخابات، و پروازها). میتوانید ستونها و ردیفهایی (حداکثر ۳ مورد برای هرکدام) را که «دستیار» باید در کارت جدول شما نشان دهد تعریف کنید. همچنین میتوانید ستونها و ردیفهای اضافی را بههمراه اولویتبندی آنها تعریف کنید.
جدولها با فهرستهای عمودی متفاوت هستند زیرا جدولها دادههای ایستا را نمایش میدهند و مانند عناصر فهرست تعاملی نیستند.
مشخصات
کارتهای جدول الزامات و ویژگیهای اختیاری زیر را دارند که میتوانید پیکربندی کنید:
- در سطوح دارای قابلیت
actions.capability.SCREEN_OUTPUTپشتیبانی میشود.
بخش زیر خلاصه میکند که چگونه میتوانید عناصر را در کارت جدول سفارشیسازی کنید.
| نام | اختیاری است | قابلسفارشیسازی است | یادداشتهای سفارشیسازی |
|---|---|---|---|
title |
بله | بله | عنوان کلی جدول. اگر زیرنویس تنظیم شده باشد، باید تنظیم شود. میتوانید خانواده قلم و رنگ را سفارشیسازی کنید. |
subtitle |
بله | نه | زیرنویس جدول. |
image |
بله | بله | تصویر مرتبط با جدول. |
Row |
نه | بله |
دادههای ردیف جدول. شامل آرایهای از اشیاء نمایش ۳ ردیف اول تضمین میشود، اما ممکن است ردیفهای دیگر در برخی سطوح نشان داده نشود. لطفاً با شبیهساز آزمایش کنید تا ببینید کدام ردیفها برای سطح مشخصی نشان داده میشود. در سطوحی که از قابلیت |
ColumnProperties |
بله | بله | سرصفحه و تراز برای ستون. شامل یک ویژگی header (که نشاندهنده متن سرصفحه برای یک ستون است) و یک ویژگی horizontal_alignment (از نوع HorizontalAlignment) است. |
Cell |
نه | بله | سلولی را در یک ردیف شرح میدهد. هر سلول حاوی رشتهای است که مقدار نوشتاری را نشان میدهد. میتوانید نوشتار را در سلول سفارشیسازی کنید. |
Button |
بله | بله | شیء دکمهای که معمولاً در پایین کارت نشان داده میشود. کارت جدول فقط میتواند ۱ دکمه داشته باشد. میتوانید رنگ دکمه را سفارشیسازی کنید. |
HorizontalAlignment |
بله | بله | تراز افقی محتوا در سلول. مقادیر میتوانند
LEADING، CENTER، یا TRAILING باشند. اگر
مشخص نشده باشد، محتوا با لبه ابتدایی سلول تراز میشود. |
کدگذاری نمونه
تکهکدهای زیر نحوه پیادهسازی کارت جدول ساده را نشان میدهد:
Node.js
app.intent('Simple Table Card', (conv) => { if (!conv.screen) { conv.ask('Sorry, try this on a screen device or select the ' + 'phone surface in the simulator.'); conv.ask('Which response would you like to see next?'); return; } conv.ask('This is a simple table example.'); conv.ask(new Table({ dividers: true, columns: ['header 1', 'header 2', 'header 3'], rows: [ ['row 1 item 1', 'row 1 item 2', 'row 1 item 3'], ['row 2 item 1', 'row 2 item 2', 'row 2 item 3'], ], })); conv.ask('Which response would you like to see next?'); });
جاوا
@ForIntent("Simple Table Card") public ActionResponse simpleTable(ActionRequest request) { ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) { return responseBuilder .add("Sorry, try ths on a screen device or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("This is a simple table example.") .add( new TableCard() .setColumnProperties( Arrays.asList( new TableCardColumnProperties().setHeader("header 1"), new TableCardColumnProperties().setHeader("header 2"), new TableCardColumnProperties().setHeader("header 3"))) .setRows( Arrays.asList( new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 1 item 1"), new TableCardCell().setText("row 1 item 2"), new TableCardCell().setText("row 1 item 3"))), new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 2 item 1"), new TableCardCell().setText("row 2 item 2"), new TableCardCell().setText("row 2 item 3")))))); return responseBuilder.build(); }
Node.js
if (!conv.screen) { conv.ask('Sorry, try this on a screen device or select the ' + 'phone surface in the simulator.'); conv.ask('Which response would you like to see next?'); return; } conv.ask('This is a simple table example.'); conv.ask(new Table({ dividers: true, columns: ['header 1', 'header 2', 'header 3'], rows: [ ['row 1 item 1', 'row 1 item 2', 'row 1 item 3'], ['row 2 item 1', 'row 2 item 2', 'row 2 item 3'], ], })); conv.ask('Which response would you like to see next?');
جاوا
ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) { return responseBuilder .add("Sorry, try ths on a screen device or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("This is a simple table example.") .add( new TableCard() .setColumnProperties( Arrays.asList( new TableCardColumnProperties().setHeader("header 1"), new TableCardColumnProperties().setHeader("header 2"), new TableCardColumnProperties().setHeader("header 3"))) .setRows( Arrays.asList( new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 1 item 1"), new TableCardCell().setText("row 1 item 2"), new TableCardCell().setText("row 1 item 3"))), new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 2 item 1"), new TableCardCell().setText("row 2 item 2"), new TableCardCell().setText("row 2 item 3")))))); return responseBuilder.build();
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "payload": { "google": { "expectUserResponse": true, "richResponse": { "items": [ { "simpleResponse": { "textToSpeech": "This is a simple table example." } }, { "tableCard": { "rows": [ { "cells": [ { "text": "row 1 item 1" }, { "text": "row 1 item 2" }, { "text": "row 1 item 3" } ], "dividerAfter": true }, { "cells": [ { "text": "row 2 item 1" }, { "text": "row 2 item 2" }, { "text": "row 2 item 3" } ], "dividerAfter": true } ], "columnProperties": [ { "header": "header 1" }, { "header": "header 2" }, { "header": "header 3" } ] } }, { "simpleResponse": { "textToSpeech": "Which response would you like to see next?" } } ] } } } }
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "expectUserResponse": true, "expectedInputs": [ { "inputPrompt": { "richInitialPrompt": { "items": [ { "simpleResponse": { "textToSpeech": "This is a simple table example." } }, { "tableCard": { "columnProperties": [ { "header": "header 1" }, { "header": "header 2" }, { "header": "header 3" } ], "rows": [ { "cells": [ { "text": "row 1 item 1" }, { "text": "row 1 item 2" }, { "text": "row 1 item 3" } ], "dividerAfter": true }, { "cells": [ { "text": "row 2 item 1" }, { "text": "row 2 item 2" }, { "text": "row 2 item 3" } ], "dividerAfter": true } ] } }, { "simpleResponse": { "textToSpeech": "Which response would you like to see next?" } } ] } }, "possibleIntents": [ { "intent": "actions.intent.TEXT" } ] } ] }
قطعههای زیر نحوه پیادهسازی کارت جدول پیچیده را نشان میدهد:
Node.js
app.intent('Advanced Table Card', (conv) => { if (!conv.screen) { conv.ask('Sorry, try this on a screen device or select the ' + 'phone surface in the simulator.'); conv.ask('Which response would you like to see next?'); return; } conv.ask('This is a table with all the possible fields.'); conv.ask(new Table({ title: 'Table Title', subtitle: 'Table Subtitle', image: new Image({ url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png', alt: 'Alt Text', }), columns: [ { header: 'header 1', align: 'CENTER', }, { header: 'header 2', align: 'LEADING', }, { header: 'header 3', align: 'TRAILING', }, ], rows: [ { cells: ['row 1 item 1', 'row 1 item 2', 'row 1 item 3'], dividerAfter: false, }, { cells: ['row 2 item 1', 'row 2 item 2', 'row 2 item 3'], dividerAfter: true, }, { cells: ['row 3 item 1', 'row 3 item 2', 'row 3 item 3'], }, ], buttons: new Button({ title: 'Button Text', url: 'https://assistant.google.com', }), })); conv.ask('Which response would you like to see next?'); });
جاوا
@ForIntent("Advanced Table Card") public ActionResponse advancedTable(ActionRequest request) { ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) { return responseBuilder .add("Sorry, try ths on a screen device or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("This is a table with all the possible fields.") .add( new TableCard() .setTitle("Table Title") .setSubtitle("Table Subtitle") .setImage( new Image() .setUrl( "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png") .setAccessibilityText("Alt text")) .setButtons( Arrays.asList( new Button() .setTitle("Button Text") .setOpenUrlAction( new OpenUrlAction().setUrl("https://assistant.google.com")))) .setColumnProperties( Arrays.asList( new TableCardColumnProperties() .setHeader("header 1") .setHorizontalAlignment("CENTER"), new TableCardColumnProperties() .setHeader("header 2") .setHorizontalAlignment("LEADING"), new TableCardColumnProperties() .setHeader("header 3") .setHorizontalAlignment("TRAILING"))) .setRows( Arrays.asList( new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 1 item 1"), new TableCardCell().setText("row 1 item 2"), new TableCardCell().setText("row 1 item 3"))) .setDividerAfter(false), new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 2 item 1"), new TableCardCell().setText("row 2 item 2"), new TableCardCell().setText("row 2 item 3"))) .setDividerAfter(true), new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 2 item 1"), new TableCardCell().setText("row 2 item 2"), new TableCardCell().setText("row 2 item 3")))))); return responseBuilder.build(); }
Node.js
if (!conv.screen) { conv.ask('Sorry, try this on a screen device or select the ' + 'phone surface in the simulator.'); conv.ask('Which response would you like to see next?'); return; } conv.ask('This is a table with all the possible fields.'); conv.ask(new Table({ title: 'Table Title', subtitle: 'Table Subtitle', image: new Image({ url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png', alt: 'Alt Text', }), columns: [ { header: 'header 1', align: 'CENTER', }, { header: 'header 2', align: 'LEADING', }, { header: 'header 3', align: 'TRAILING', }, ], rows: [ { cells: ['row 1 item 1', 'row 1 item 2', 'row 1 item 3'], dividerAfter: false, }, { cells: ['row 2 item 1', 'row 2 item 2', 'row 2 item 3'], dividerAfter: true, }, { cells: ['row 3 item 1', 'row 3 item 2', 'row 3 item 3'], }, ], buttons: new Button({ title: 'Button Text', url: 'https://assistant.google.com', }), })); conv.ask('Which response would you like to see next?');
جاوا
ResponseBuilder responseBuilder = getResponseBuilder(request); if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) { return responseBuilder .add("Sorry, try ths on a screen device or select the phone surface in the simulator.") .add("Which response would you like to see next?") .build(); } responseBuilder .add("This is a table with all the possible fields.") .add( new TableCard() .setTitle("Table Title") .setSubtitle("Table Subtitle") .setImage( new Image() .setUrl( "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png") .setAccessibilityText("Alt text")) .setButtons( Arrays.asList( new Button() .setTitle("Button Text") .setOpenUrlAction( new OpenUrlAction().setUrl("https://assistant.google.com")))) .setColumnProperties( Arrays.asList( new TableCardColumnProperties() .setHeader("header 1") .setHorizontalAlignment("CENTER"), new TableCardColumnProperties() .setHeader("header 2") .setHorizontalAlignment("LEADING"), new TableCardColumnProperties() .setHeader("header 3") .setHorizontalAlignment("TRAILING"))) .setRows( Arrays.asList( new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 1 item 1"), new TableCardCell().setText("row 1 item 2"), new TableCardCell().setText("row 1 item 3"))) .setDividerAfter(false), new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 2 item 1"), new TableCardCell().setText("row 2 item 2"), new TableCardCell().setText("row 2 item 3"))) .setDividerAfter(true), new TableCardRow() .setCells( Arrays.asList( new TableCardCell().setText("row 2 item 1"), new TableCardCell().setText("row 2 item 2"), new TableCardCell().setText("row 2 item 3")))))); return responseBuilder.build();
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "payload": { "google": { "expectUserResponse": true, "richResponse": { "items": [ { "simpleResponse": { "textToSpeech": "This is a table with all the possible fields." } }, { "tableCard": { "title": "Table Title", "subtitle": "Table Subtitle", "image": { "url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png", "accessibilityText": "Alt Text" }, "rows": [ { "cells": [ { "text": "row 1 item 1" }, { "text": "row 1 item 2" }, { "text": "row 1 item 3" } ], "dividerAfter": false }, { "cells": [ { "text": "row 2 item 1" }, { "text": "row 2 item 2" }, { "text": "row 2 item 3" } ], "dividerAfter": true }, { "cells": [ { "text": "row 3 item 1" }, { "text": "row 3 item 2" }, { "text": "row 3 item 3" } ] } ], "columnProperties": [ { "header": "header 1", "horizontalAlignment": "CENTER" }, { "header": "header 2", "horizontalAlignment": "LEADING" }, { "header": "header 3", "horizontalAlignment": "TRAILING" } ], "buttons": [ { "title": "Button Text", "openUrlAction": { "url": "https://assistant.google.com" } } ] } }, { "simpleResponse": { "textToSpeech": "Which response would you like to see next?" } } ] } } } }
JSON
توجه داشته باشید که JSON زیر پاسخ وبقلاب را شرح میدهد.
{ "expectUserResponse": true, "expectedInputs": [ { "possibleIntents": [ { "intent": "actions.intent.TEXT" } ], "inputPrompt": { "richInitialPrompt": { "items": [ { "simpleResponse": { "textToSpeech": "This is a table with all the possible fields." } }, { "tableCard": { "title": "Table Title", "subtitle": "Table Subtitle", "image": { "url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png", "accessibilityText": "Alt Text" }, "rows": [ { "cells": [ { "text": "row 1 item 1" }, { "text": "row 1 item 2" }, { "text": "row 1 item 3" } ], "dividerAfter": false }, { "cells": [ { "text": "row 2 item 1" }, { "text": "row 2 item 2" }, { "text": "row 2 item 3" } ], "dividerAfter": true }, { "cells": [ { "text": "row 3 item 1" }, { "text": "row 3 item 2" }, { "text": "row 3 item 3" } ] } ], "columnProperties": [ { "header": "header 1", "horizontalAlignment": "CENTER" }, { "header": "header 2", "horizontalAlignment": "LEADING" }, { "header": "header 3", "horizontalAlignment": "TRAILING" } ], "buttons": [ { "title": "Button Text", "openUrlAction": { "url": "https://assistant.google.com" } } ] } }, { "simpleResponse": { "textToSpeech": "Which response would you like to see next?" } } ] } } } ] }
درحال سفارشیسازی کردن پاسخهای شما
با ایجاد زمینهای سفارشی میتوانید ظاهر پاسخهای غنی را تغییر دهید. اگر زمینهای برای پروژه «کنشهای» خود تعریف کنید، پاسخهای غنی در سراسر «کنشهای» پروژه شما مطابق با زمینه شما سبکبندی خواهند شد. این نمانامسازی سفارشی میتواند برای تعریف ظاهر و احساسی منحصربهفرد برای مکالمه مفید باشد، وقتی کاربران «کنشهای» شما را در سطحی با صفحهنمایش فراخوانی میکنند.
برای تنظیم زمینه پاسخ سفارشی، کارهای زیر را انجام دهید:
- در کنسول Actions، به توسعه > سفارشیسازی زمینه بروید.
- هریک یا همه موارد زیر را تنظیم کنید:
- رنگ پسزمینه برای استفاده بهعنوان پسزمینه کارتهایتان. بهطور کلی، باید از رنگ روشن برای پسزمینه استفاده کنید تا محتوای کارت بهراحتی خوانده شود.
- رنگ اصلی رنگ اصلی برای نوشتار سرصفحه کارتها و عناصر میانای کاربر است. بهطور کلی، باید از رنگ اصلی تیرهتری استفاده کنید تا با پسزمینه تضاد داشته باشد.
- خانواده قلم نوع قلم مورداستفاده برای عنوانها و دیگر عناصر نوشتاری برجسته را توصیف میکند.
- سبک گوشه تصویر میتواند ظاهر گوشههای کارتهایتان را تغییر دهد.
- تصویر پسزمینه از تصویر سفارشی بهجای رنگ پسزمینه استفاده میکند. باید دو تصویر متفاوت برای زمانی که دستگاه Surface در حالت افقی یا عمودی است ارائه دهید. توجه داشته باشید که اگر از تصویر پسزمینه استفاده کنید، رنگ اصلی روی سفید تنظیم میشود.
- روی ذخیره کلیک کنید.