Возможности поверхности (Dialogflow)

Попробуйте фрагменты: импортируйте, развертывайте и изучайте фрагменты кода в контексте с помощью нового агента Dialogflow.

Исследуйте в Dialogflow

Исследуйте в Dialogflow

Нажмите «Продолжить» , чтобы импортировать наш пример возможностей Surface в Dialogflow. Затем выполните следующие действия, чтобы развернуть и протестировать образец:

1. Введите имя агента и создайте новый агент Dialogflow для примера.
2. После завершения импорта агента нажмите Перейти к агенту .
3. В главном навигационном меню перейдите в раздел «Выполнение» .
4. Включите встроенный редактор и нажмите «Развернуть» . Редактор содержит пример кода.
5. В главном меню навигации выберите «Интеграции» и нажмите «Google Ассистент» .
6. В появившемся модальном окне включите автоматический просмотр изменений и нажмите «Тест» , чтобы открыть симулятор действий.
7. В симуляторе введите Talk to my test app чтобы протестировать образец!

Продолжить Отмена

Ваши действия могут отображаться на различных поверхностях, включая поверхности только для звука (умные колонки) и поверхности для звука и отображения (например, интеллектуальные дисплеи и мобильные устройства).

Чтобы проектировать и создавать беседы, которые хорошо работают на всех поверхностях, используйте возможности поверхности для правильного управления и масштабирования бесед.

Возможности Surface для действий

Действия в Google позволяют вам контролировать, могут ли пользователи вызывать ваше действие, в зависимости от используемой поверхности. Если пользователи попытаются вызвать ваше действие на неподдерживаемой поверхности, они получат сообщение об ошибке, сообщающее, что их устройство не поддерживается.

Вы определяете поверхностную поддержку вашего действия в своем проекте действий.

Примечание. Вам следует проверять опцию возможности поверхности воспроизведения мультимедиа только в том случае, если все ваше действие зависит от воспроизведения мультимедиа. Например, если ваше действие не делает ничего, кроме воспроизведения звуковой дорожки, которая выводит ответ мультимедиа, вы должны отметить эту опцию. Если ваше действие также предоставляет другую информацию, например данные фондового рынка, вы не будете выбирать эту опцию. В последнем случае вы должны программно проверить возможности поверхности воспроизведения мультимедиа и отреагировать соответствующим образом.

Ваше действие может отображаться на различных поверхностях, которые поддерживает Ассистент, например на смартфонах (Android и iOS) и устройствах Google Home.

Возможности поверхности среды выполнения

Вы можете обеспечить взаимодействие с пользователем с помощью возможностей поверхности среды выполнения двумя основными способами:

• Разветвление ответов . Предоставляйте пользователям разные ответы, но имеют одинаковую структуру и ход разговора на разных поверхностях. Например, действие «Погода» может отображать карточку с изображением на телефоне и воспроизводить аудиофайл в Google Home, но поток разговора одинаков на всех поверхностях.

• Разветвление разговора . Предоставляйте пользователям совершенно разные разговоры на каждой поверхности. Например, если вы создаете приложение для заказа еды, вы можете захотеть обеспечить процесс повторного заказа в Google Home, а полный процесс сборки корзины — на мобильных телефонах. Чтобы выполнить ветвление диалога, определите триггер намерения в Dialogflow для определенных поверхностных возможностей с контекстами Dialogflow. Фактические намерения Dialogflow не запускаются, если не удовлетворена конкретная поверхностная возможность.

  Примечание. Возможности поверхности устройства пользователя могут измениться во время разговора. Не полагайтесь на постоянный набор возможностей после начала разговора.

• Разговоры на нескольких поверхностях . Предоставьте пользователям возможность беседы на одной поверхности, которая в середине разговора переходит на другую поверхность. Например, если пользователь вызывает ваше действие с изображениями на поверхности только для звука, такой как Google Home, вы можете создать свое действие для поиска другой поверхности с визуальными возможностями и переместить разговор туда, если это возможно.

Ветвление ответа

Каждый раз, когда ваше выполнение получает запрос от Google Assistant, вы можете запросить следующие возможности поверхностей (например, Google Home или телефона Android):

Node.js

const hasScreen =
  conv.surface.capabilities.has('actions.capability.SCREEN_OUTPUT');
  // OR conv.screen;
const hasAudio =
  conv.surface.capabilities.has('actions.capability.AUDIO_OUTPUT');
const hasMediaPlayback =
  conv.surface.capabilities.has('actions.capability.MEDIA_RESPONSE_AUDIO');
const hasWebBrowser =
  conv.surface.capabilities.has('actions.capability.WEB_BROWSER');
// Interactive Canvas must be enabled in your project to see this
const hasInteractiveCanvas =
  conv.surface.capabilities.has('actions.capability.INTERACTIVE_CANVAS');
index.js

Ява

boolean hasScreen = request.hasCapability(Capability.SCREEN_OUTPUT.getValue());
boolean hasAudio = request.hasCapability(Capability.AUDIO_OUTPUT.getValue());
boolean hasMediaPlayback = request.hasCapability(Capability.MEDIA_RESPONSE_AUDIO.getValue());
boolean hasWebBrowser = request.hasCapability(Capability.WEB_BROWSER.getValue());
// Interactive Canvas must be enabled in your project to see this
boolean hasInteractiveCanvas = request.hasCapability("INTERACTIVE_CANVAS");
MyActionsApp.java

Node.js

const hasScreen =
  conv.surface.capabilities.has('actions.capability.SCREEN_OUTPUT');
  // OR conv.screen;
const hasAudio =
  conv.surface.capabilities.has('actions.capability.AUDIO_OUTPUT');
const hasMediaPlayback =
  conv.surface.capabilities.has('actions.capability.MEDIA_RESPONSE_AUDIO');
const hasWebBrowser =
  conv.surface.capabilities.has('actions.capability.WEB_BROWSER');
// Interactive Canvas must be enabled in your project to see this
const hasInteractiveCanvas =
  conv.surface.capabilities.has('actions.capability.INTERACTIVE_CANVAS');
index.js

Ява

boolean hasScreen = request.hasCapability(Capability.SCREEN_OUTPUT.getValue());
boolean hasAudio = request.hasCapability(Capability.AUDIO_OUTPUT.getValue());
boolean hasMediaPlayback = request.hasCapability(Capability.MEDIA_RESPONSE_AUDIO.getValue());
boolean hasWebBrowser = request.hasCapability(Capability.WEB_BROWSER.getValue());
// Interactive Canvas must be enabled in your project to see this
boolean hasInteractiveCanvas = request.hasCapability("INTERACTIVE_CANVAS");
MyActionsApp.java

JSON

Обратите внимание, что приведенный ниже JSON описывает запрос веб-перехватчика.

{
  "responseId": "206a66fb-a572-4cfc-9e41-8e2eb62fdf18-712767ed",
  "queryResult": {
    "queryText": "Current capabilities",
    "parameters": {},
    "allRequiredParamsPresent": true,
    "fulfillmentText": "Webhook failed for intent: Current Capabilities",
    "fulfillmentMessages": [
      {
        "text": {
          "text": [
            "Webhook failed for intent: Current Capabilities"
          ]
        }
      }
    ],
    "outputContexts": [
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_media_response_audio"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_audio_output"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_account_linking"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_web_browser"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_screen_output"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/google_assistant_input_type_touch"
      }
    ],
    "intent": {
      "name": "projects/df-surface-caps-kohler/agent/intents/4e191eef-ba17-4f68-8a97-85a43cbc9ed1",
      "displayName": "Current Capabilities"
    },
    "intentDetectionConfidence": 1,
    "languageCode": "en"
  },
  "originalDetectIntentRequest": {
    "source": "google",
    "version": "2",
    "payload": {
      "user": {
        "locale": "en-US",
        "userVerificationStatus": "VERIFIED"
      },
      "conversation": {
        "conversationId": "ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ",
        "type": "ACTIVE",
        "conversationToken": "[]"
      },
      "inputs": [
        {
          "intent": "actions.intent.TEXT",
          "rawInputs": [
            {
              "inputType": "TOUCH",
              "query": "Current capabilities"
            }
          ],
          "arguments": [
            {
              "name": "text",
              "rawText": "Current capabilities",
              "textValue": "Current capabilities"
            }
          ]
        }
      ],
      "surface": {
        "capabilities": [
          {
            "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
          },
          {
            "name": "actions.capability.AUDIO_OUTPUT"
          },
          {
            "name": "actions.capability.ACCOUNT_LINKING"
          },
          {
            "name": "actions.capability.WEB_BROWSER"
          },
          {
            "name": "actions.capability.SCREEN_OUTPUT"
          }
        ]
      },
      "availableSurfaces": [
        {
          "capabilities": [
            {
              "name": "actions.capability.AUDIO_OUTPUT"
            },
            {
              "name": "actions.capability.SCREEN_OUTPUT"
            },
            {
              "name": "actions.capability.WEB_BROWSER"
            }
          ]
        }
      ]
    }
  },
  "session": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ"
}

JSON

Обратите внимание, что приведенный ниже JSON описывает запрос веб-перехватчика.

{
  "user": {
    "locale": "en-US",
    "userVerificationStatus": "VERIFIED"
  },
  "conversation": {
    "conversationId": "ABwppHENuB8dw7LgVquXnW5Bmy9hwu1Qz4bsaL7uIb9vDSBYPAFhFgsMWnMV6m4JEDgaUWz9FUVuIhQqWh1KZ_jjTwKEIlza",
    "type": "NEW"
  },
  "inputs": [
    {
      "intent": "actions.intent.TEXT",
      "rawInputs": [
        {
          "inputType": "TOUCH",
          "query": "Current capabilities"
        }
      ],
      "arguments": [
        {
          "name": "text",
          "rawText": "Current capabilities",
          "textValue": "Current capabilities"
        }
      ]
    }
  ],
  "surface": {
    "capabilities": [
      {
        "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
      },
      {
        "name": "actions.capability.SCREEN_OUTPUT"
      },
      {
        "name": "actions.capability.WEB_BROWSER"
      },
      {
        "name": "actions.capability.ACCOUNT_LINKING"
      },
      {
        "name": "actions.capability.AUDIO_OUTPUT"
      }
    ]
  },
  "availableSurfaces": [
    {
      "capabilities": [
        {
          "name": "actions.capability.WEB_BROWSER"
        },
        {
          "name": "actions.capability.AUDIO_OUTPUT"
        },
        {
          "name": "actions.capability.SCREEN_OUTPUT"
        }
      ]
    }
  ]
}

Разветвление разговора

Вы можете настроить намерения Dialogflow на срабатывание только при определенных возможностях с помощью заранее определенных контекстов Dialogflow. Каждый раз, когда намерение совпадает, Dialogflow автоматически генерирует контексты из набора поверхностных возможностей, доступных устройству. Вы можете указать один или несколько из этих контекстов как «входные контексты» для своих намерений. Это позволяет вам контролировать срабатывание намерения на основе модальности.

Например, если вы хотите, чтобы намерение запускалось только на устройствах с выводом на экран, вы можете установить контекст ввода для намерения: actions_capability_screen_output .

Доступны следующие контексты:

• actions_capability_audio_output — в устройстве есть динамик.
• actions_capability_screen_output — устройство имеет экран вывода данных.
• actions_capability_media_response_audio — Устройство поддерживает воспроизведение медиаконтента.
• actions_capability_web_browser — устройство поддерживает веб-браузер. (Эта возможность в настоящее время недоступна для интеллектуальных дисплеев.)

Вот пример намерения, которое сработает только на поверхностях с экранами:

Разговоры на нескольких поверхностях

В любой момент выполнения вашего действия вы можете проверить, есть ли у пользователя какие-либо другие поверхности с определенными возможностями. Если доступна другая поверхность с запрошенной возможностью, вы можете перенести текущий разговор на эту новую поверхность.

Примечание. Перенос разговора возможен только в зависимости от возможностей экрана с телефоном Android/iOS в качестве конечной поверхности.

Поток для поверхностного переноса будет работать следующим образом:

1. Проверьте, есть ли у пользователя доступная поверхность

   В обработчике веб-перехватчика вы можете запросить, есть ли у пользователя доступная поверхность с определенной возможностью. Обратите внимание, что эта поверхность должна быть привязана к той же учетной записи Google, что и исходная поверхность.

   Node.js

   const screenAvailable =
     conv.available.surfaces.capabilities.has(
       'actions.capability.SCREEN_OUTPUT');
   index.js

   Ява

   String screen = Capability.SCREEN_OUTPUT.getValue();
   boolean screenAvailable = false;
   for (Surface surface : request.getAvailableSurfaces()) {
     for (com.google.api.services.actions_fulfillment.v2.model.Capability capability :
         surface.getCapabilities()) {
       if (capability.getName().equals(screen)) {
         screenAvailable = true;
         break;
       }
     }
   }
   MyActionsApp.java

   Node.js

   const screenAvailable =
     conv.available.surfaces.capabilities.has(
       'actions.capability.SCREEN_OUTPUT');
   index.js

   Ява

   String screen = Capability.SCREEN_OUTPUT.getValue();
   boolean screenAvailable = false;
   for (Surface surface : request.getAvailableSurfaces()) {
     for (com.google.api.services.actions_fulfillment.v2.model.Capability capability :
         surface.getCapabilities()) {
       if (capability.getName().equals(screen)) {
         screenAvailable = true;
         break;
       }
     }
   }
   MyActionsApp.java

   JSON

   Обратите внимание, что приведенный ниже JSON описывает запрос веб-перехватчика.

   {
     "responseId": "206a66fb-a572-4cfc-9e41-8e2eb62fdf18-712767ed",
     "queryResult": {
       "queryText": "Current capabilities",
       "parameters": {},
       "allRequiredParamsPresent": true,
       "fulfillmentText": "Webhook failed for intent: Current Capabilities",
       "fulfillmentMessages": [
         {
           "text": {
             "text": [
               "Webhook failed for intent: Current Capabilities"
             ]
           }
         }
       ],
       "outputContexts": [
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_media_response_audio"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_audio_output"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_account_linking"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_web_browser"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_screen_output"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/google_assistant_input_type_touch"
         }
       ],
       "intent": {
         "name": "projects/df-surface-caps-kohler/agent/intents/4e191eef-ba17-4f68-8a97-85a43cbc9ed1",
         "displayName": "Current Capabilities"
       },
       "intentDetectionConfidence": 1,
       "languageCode": "en"
     },
     "originalDetectIntentRequest": {
       "source": "google",
       "version": "2",
       "payload": {
         "user": {
           "locale": "en-US",
           "userVerificationStatus": "VERIFIED"
         },
         "conversation": {
           "conversationId": "ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ",
           "type": "ACTIVE",
           "conversationToken": "[]"
         },
         "inputs": [
           {
             "intent": "actions.intent.TEXT",
             "rawInputs": [
               {
                 "inputType": "TOUCH",
                 "query": "Current capabilities"
               }
             ],
             "arguments": [
               {
                 "name": "text",
                 "rawText": "Current capabilities",
                 "textValue": "Current capabilities"
               }
             ]
           }
         ],
         "surface": {
           "capabilities": [
             {
               "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
             },
             {
               "name": "actions.capability.AUDIO_OUTPUT"
             },
             {
               "name": "actions.capability.ACCOUNT_LINKING"
             },
             {
               "name": "actions.capability.WEB_BROWSER"
             },
             {
               "name": "actions.capability.SCREEN_OUTPUT"
             }
           ]
         },
         "availableSurfaces": [
           {
             "capabilities": [
               {
                 "name": "actions.capability.AUDIO_OUTPUT"
               },
               {
                 "name": "actions.capability.SCREEN_OUTPUT"
               },
               {
                 "name": "actions.capability.WEB_BROWSER"
               }
             ]
           }
         ]
       }
     },
     "session": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ"
   }

   JSON

   Обратите внимание, что приведенный ниже JSON описывает запрос веб-перехватчика.

   {
     "user": {
       "locale": "en-US",
       "userVerificationStatus": "VERIFIED"
     },
     "conversation": {
       "conversationId": "ABwppHENuB8dw7LgVquXnW5Bmy9hwu1Qz4bsaL7uIb9vDSBYPAFhFgsMWnMV6m4JEDgaUWz9FUVuIhQqWh1KZ_jjTwKEIlza",
       "type": "NEW"
     },
     "inputs": [
       {
         "intent": "actions.intent.TEXT",
         "rawInputs": [
           {
             "inputType": "TOUCH",
             "query": "Current capabilities"
           }
         ],
         "arguments": [
           {
             "name": "text",
             "rawText": "Current capabilities",
             "textValue": "Current capabilities"
           }
         ]
       }
     ],
     "surface": {
       "capabilities": [
         {
           "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
         },
         {
           "name": "actions.capability.SCREEN_OUTPUT"
         },
         {
           "name": "actions.capability.WEB_BROWSER"
         },
         {
           "name": "actions.capability.ACCOUNT_LINKING"
         },
         {
           "name": "actions.capability.AUDIO_OUTPUT"
         }
       ]
     },
     "availableSurfaces": [
       {
         "capabilities": [
           {
             "name": "actions.capability.WEB_BROWSER"
           },
           {
             "name": "actions.capability.AUDIO_OUTPUT"
           },
           {
             "name": "actions.capability.SCREEN_OUTPUT"
           }
         ]
       }
     ]
   }

2. Запрос на перенос пользователя на новую поверхность

   Если есть доступная поверхность с необходимыми возможностями, вашему действию необходимо будет спросить пользователя, хотят ли они перенести разговор.

   Node.js

   if (conv.screen) {
     conv.ask(`You're already on a screen device.`);
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Current Capabilities',
       'Check Audio Capability',
       'Check Screen Capability',
       'Check Media Capability',
       'Check Web Capability',
     ]));
     return;
   } else if (screenAvailable) {
     const context =
       `Let's move you to a screen device for cards and other visual responses`;
     const notification = 'Try your Action here!';
     const capabilities = ['actions.capability.SCREEN_OUTPUT'];
     return conv.ask(new NewSurface({context, notification, capabilities}));
   } else {
     conv.ask('It looks like there is no screen device ' +
       'associated with this user.');
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Current Capabilities',
       'Check Audio Capability',
       'Check Screen Capability',
       'Check Media Capability',
       'Check Web Capability',
     ]));
   };
   index.js

   Ява

   ResponseBuilder responseBuilder = getResponseBuilder(request);
   if (request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) {
     responseBuilder.add("You're already on a screen device");
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Transfer surface",
           "Check Audio Capability",
           "Check Screen Capability",
           "Check Media Capability",
           "Check Web Capability",
         });
     return responseBuilder.build();
   } else if (screenAvailable) {
     responseBuilder.add(
         new NewSurface()
             .setContext("Let's move you to a screen device for cards and other visual responses")
             .setNotificationTitle("Try your Action here!")
             .setCapabilities(Collections.singletonList(screen)));
     return responseBuilder.build();
   } else {
     responseBuilder.add("It looks like there is no screen device associated with this user.");
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Transfer surface",
           "Check Audio Capability",
           "Check Screen Capability",
           "Check Media Capability",
           "Check Web Capability",
         });
     return responseBuilder.build();
   }
   MyActionsApp.java

   Node.js

   if (conv.screen) {
     conv.ask(`You're already on a screen device.`);
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Transfer surface',
       'Current capabilities',
     ]));
     return;
   } else if (screenAvailable) {
     const context =
       `Let's move you to a screen device for cards and other visual responses`;
     const notification = 'Try your Action here!';
     const capabilities = ['actions.capability.SCREEN_OUTPUT'];
     return conv.ask(new NewSurface({context, notification, capabilities}));
   } else {
     conv.ask('It looks like there is no screen device ' +
       'associated with this user.');
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Transfer surface',
       'Current capabilities',
     ]));
   };
   index.js

   Ява

   ResponseBuilder responseBuilder = getResponseBuilder(request);
   if (request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) {
     responseBuilder.add("You're already on a screen device");
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Current capabilities", "Transfer surface",
         });
     return responseBuilder.build();
   } else if (screenAvailable) {
     responseBuilder.add(
         new NewSurface()
             .setContext("Let's move you to a screen device for cards and other visual responses")
             .setNotificationTitle("Try your Action here!")
             .setCapabilities(Collections.singletonList(screen)));
     return responseBuilder.build();
   } else {
     responseBuilder.add("It looks like there is no screen device associated with this user.");
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Current capabilities", "Transfer surface",
         });
     return responseBuilder.build();
   }
   MyActionsApp.java

   JSON

   Обратите внимание, что приведенный ниже JSON описывает ответ веб-перехватчика.

   {
     "payload": {
       "google": {
         "expectUserResponse": true,
         "systemIntent": {
           "intent": "actions.intent.NEW_SURFACE",
           "data": {
             "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValueSpec",
             "capabilities": [
               "actions.capability.SCREEN_OUTPUT"
             ],
             "context": "Let's move you to a screen device for cards and other visual responses",
             "notificationTitle": "Try your Action here!"
           }
         }
       }
     }
   }

   JSON

   Обратите внимание, что приведенный ниже JSON описывает ответ веб-перехватчика.

   {
     "expectUserResponse": true,
     "expectedInputs": [
       {
         "possibleIntents": [
           {
             "intent": "actions.intent.NEW_SURFACE",
             "inputValueData": {
               "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValueSpec",
               "capabilities": [
                 "actions.capability.SCREEN_OUTPUT"
               ],
               "context": "Let's move you to a screen device for cards and other visual responses",
               "notificationTitle": "Try your Action here!"
             }
           }
         ]
       }
     ]
   }

   Примечание. Ваш текущий сеанс и все связанные с ним данные сохраняются на новой поверхности. Это означает, что любое состояние из вашей предыдущей поверхности, включая conversationToken (если вы используете API веб-перехватчика HTTP/JSON диалога ) и любой выходной контекст Dialogflow, будет доступно на новой поверхности, а идентификатор диалога останется прежним. Если вы используете клиентскую библиотеку Node.js , вы можете использовать свойство conv.data для хранения данных.
   Предупреждение. Если вы запрашиваете возможности, которых нет ни на одной из доступных пользователю поверхностей, во время выполнения вы увидите ошибку.
3. Обработка ответа пользователя

   В зависимости от ответа пользователя на ваш запрос ваше действие либо облегчит передачу управления, либо вернет управление разговором на исходную поверхность. В любом случае следующий запрос к вашей конечной точке будет содержать намерение actions.intent.NEW_SURFACE , поэтому вам следует создать намерение, которое срабатывает по этому событию, с соответствующим обработчиком в вашем веб-перехватчике. В коде обработчика следует проверить, прошла ли передача успешно.

   Node.js

   app.intent('Transfer Surface - NEW_SURFACE', (conv, input, newSurface) => {
     if (newSurface.status === 'OK') {
       conv.ask('Welcome to a screen device!');
       conv.ask(new BasicCard({
         title: `You're on a screen device!`,
         text: `Screen devices support basic cards and other visual responses!`,
       }));
     } else {
       conv.ask(`Ok, no problem.`);
     }
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Current Capabilities',
       'Check Audio Capability',
       'Check Screen Capability',
       'Check Media Capability',
       'Check Web Capability',
     ]));
   });
   index.js

   Ява

   @ForIntent("Transfer Surface - NEW_SURFACE")
   public ActionResponse newSurface(ActionRequest request) {
     ResponseBuilder responseBuilder = getResponseBuilder(request);
     Map<String, Object> newSurfaceStatus = request.getArgument("NEW_SURFACE").getExtension();
     if (newSurfaceStatus.get("status").equals("OK")) {
       responseBuilder.add("Welcome to a screen device!");
       responseBuilder.add(
           new BasicCard()
               .setTitle("You're on a screened device!")
               .setFormattedText("Screen devices support basic cards and other visual responses!"));
     } else {
       responseBuilder.add("Ok, no problem.");
     }
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Transfer surface",
           "Check Audio Capability",
           "Check Screen Capability",
           "Check Media Capability",
           "Check Web Capability",
         });
     return responseBuilder.build();
   }
   MyActionsApp.java

   Node.js

   app.intent('actions.intent.NEW_SURFACE', (conv) => {
     if (conv.arguments.get('NEW_SURFACE').status === 'OK') {
       conv.ask('Welcome to a screen device!');
       conv.ask(new BasicCard({
         title: `You're on a screen device!`,
         text: `Screen devices support basic cards and other visual responses!`,
       }));
     } else {
       conv.ask(`Ok, no problem.`);
     }
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Transfer surface',
       'Current capabilities',
     ]));
   });
   index.js

   Ява

   @ForIntent("actions.intent.NEW_SURFACE")
   public ActionResponse newSurface(ActionRequest request) {
     ResponseBuilder responseBuilder = getResponseBuilder(request);
     Map<String, Object> newSurfaceStatus = request.getArgument("NEW_SURFACE").getExtension();
     if (newSurfaceStatus.get("status").equals("OK")) {
       responseBuilder.add("Welcome to a screen device!");
       responseBuilder.add(
           new BasicCard()
               .setTitle("You're on a screened device!")
               .setFormattedText("Screen devices support basic cards and other visual responses!"));
     } else {
       responseBuilder.add("Ok, no problem.");
     }
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Current capabilities", "Transfer surface",
         });
     return responseBuilder.build();
   }
   MyActionsApp.java

   JSON

   Обратите внимание, что приведенный ниже JSON описывает запрос веб-перехватчика.

   {
     "responseId": "94b74485-cd7a-4b3b-b96a-fec15f3a496c-712767ed",
     "queryResult": {
       "queryText": "actions_intent_NEW_SURFACE",
       "parameters": {},
       "allRequiredParamsPresent": true,
       "fulfillmentText": "Webhook failed for intent: Transfer Surface - NEW_SURFACE",
       "fulfillmentMessages": [
         {
           "text": {
             "text": [
               "Webhook failed for intent: Transfer Surface - NEW_SURFACE"
             ]
           }
         }
       ],
       "outputContexts": [
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_screen_output"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_web_browser"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_audio_output"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_media_response_audio"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_account_linking"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/google_assistant_input_type_voice"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_intent_new_surface",
           "parameters": {
             "NEW_SURFACE": {
               "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValue",
               "status": "OK"
             },
             "text": ""
           }
         }
       ],
       "intent": {
         "name": "projects/df-surface-caps-kohler/agent/intents/9db3798d-bdac-4dc8-a8e7-52349a3af0e8",
         "displayName": "Transfer Surface - NEW_SURFACE"
       },
       "intentDetectionConfidence": 1,
       "languageCode": "en"
     },
     "originalDetectIntentRequest": {
       "source": "google",
       "version": "2",
       "payload": {
         "user": {
           "locale": "en-US",
           "userVerificationStatus": "VERIFIED"
         },
         "conversation": {
           "conversationId": "ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q",
           "type": "ACTIVE",
           "conversationToken": "[]"
         },
         "inputs": [
           {
             "intent": "actions.intent.NEW_SURFACE",
             "rawInputs": [
               {
                 "inputType": "VOICE"
               }
             ],
             "arguments": [
               {
                 "name": "NEW_SURFACE",
                 "extension": {
                   "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValue",
                   "status": "OK"
                 }
               },
               {
                 "name": "text"
               }
             ]
           }
         ],
         "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"
             }
           ]
         },
         "availableSurfaces": [
           {
             "capabilities": [
               {
                 "name": "actions.capability.SCREEN_OUTPUT"
               },
               {
                 "name": "actions.capability.WEB_BROWSER"
               },
               {
                 "name": "actions.capability.AUDIO_OUTPUT"
               }
             ]
           }
         ]
       }
     },
     "session": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q"
   }

   JSON

   Обратите внимание, что приведенный ниже JSON описывает запрос веб-перехватчика.

   {
     "user": {
       "locale": "en-US",
       "userVerificationStatus": "VERIFIED"
     },
     "conversation": {
       "conversationId": "ABwppHENAOzBH5swn9iKb5QgUliTw4JLu5f86gS373tGtNvYcz1C3qHdorjcIb77o_PUleXGzIEFdPsl3-kmIAARvx67A7Ym",
       "type": "NEW"
     },
     "inputs": [
       {
         "intent": "actions.intent.NEW_SURFACE",
         "rawInputs": [
           {
             "inputType": "VOICE"
           }
         ],
         "arguments": [
           {
             "name": "NEW_SURFACE",
             "extension": {
               "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValue",
               "status": "OK"
             }
           },
           {
             "name": "text"
           }
         ]
       }
     ],
     "surface": {
       "capabilities": [
         {
           "name": "actions.capability.SCREEN_OUTPUT"
         },
         {
           "name": "actions.capability.ACCOUNT_LINKING"
         },
         {
           "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
         },
         {
           "name": "actions.capability.AUDIO_OUTPUT"
         },
         {
           "name": "actions.capability.WEB_BROWSER"
         }
       ]
     },
     "availableSurfaces": [
       {
         "capabilities": [
           {
             "name": "actions.capability.WEB_BROWSER"
           },
           {
             "name": "actions.capability.AUDIO_OUTPUT"
           },
           {
             "name": "actions.capability.SCREEN_OUTPUT"
           }
         ]
       }
     ]
   }