EventHandler

candidates: 
  - object (StaticPromptCandidate)

object (StaticPromptCandidate)

Danh sách lời nhắc ứng viên cần gửi cho khách hàng. Mỗi câu lệnh có một bộ chọn để xác định thời điểm có thể sử dụng câu lệnh đó. Bộ chọn đầu tiên khớp với yêu cầu sẽ được gửi và bộ chọn còn lại sẽ bị bỏ qua.

selector: 
  object (Selector)
promptResponse: 
  object (StaticPromptResponse)

object (Selector)

Không bắt buộc. Tiêu chí để xác định xem lời nhắc này có khớp với một yêu cầu hay không. Nếu bộ chọn trống, lời nhắc này sẽ luôn được kích hoạt.

object (StaticPromptResponse)

Câu trả lời ngay lập tức được liên kết với bộ chọn.

surfaceCapabilities: 
  object (SurfaceCapabilities)

object (SurfaceCapabilities)

Tập hợp các chức năng bắt buộc của nền tảng.

capabilities: 
  - enum (Capability)

enum (Capability)

Bắt buộc. Các tính năng của nền tảng đưa ra yêu cầu cho Hành động.

firstSimple: 
  object (StaticSimplePrompt)
content: 
  object (StaticContentPrompt)
lastSimple: 
  object (StaticSimplePrompt)
suggestions: 
  - object (Suggestion)
link: 
  object (StaticLinkPrompt)
override: boolean
canvas: 
  object (StaticCanvasPrompt)

object (StaticSimplePrompt)

Không bắt buộc. Câu trả lời đầu tiên chỉ có văn bản và giọng nói.

object (StaticContentPrompt)

Không bắt buộc. Một nội dung như thẻ, danh sách hoặc nội dung nghe nhìn để hiển thị với người dùng.

object (StaticSimplePrompt)

Không bắt buộc. Câu trả lời gần đây nhất chỉ có văn bản và giọng nói.

object (Suggestion)

Không bắt buộc. Nội dung đề xuất sẽ hiển thị với người dùng và sẽ luôn xuất hiện ở cuối câu trả lời. Nếu trường append trong câu lệnh chứa là true thì tiêu đề được xác định trong trường này sẽ được thêm vào các tiêu đề đã xác định trong mọi câu lệnh đề xuất đã xác định trước đó và các giá trị trùng lặp sẽ bị xoá.

object (StaticLinkPrompt)

Không bắt buộc. Một khối đề xuất bổ sung có thể liên kết đến ứng dụng hoặc trang web được liên kết. Khối sẽ được hiển thị với tiêu đề "Mở ". Tối đa 20 ký tự.

boolean

Không bắt buộc. Chế độ cho biết cách hợp nhất tin nhắn này với tin nhắn đã xác định trước đó. true sẽ xoá mọi thông báo đã xác định trước đó (đơn giản đầu tiên và cuối cùng, nội dung, đường liên kết đề xuất và canvas) và thêm các thông báo được xác định trong câu lệnh này. false sẽ thêm các tin nhắn được xác định trong câu lệnh này vào các tin nhắn được xác định trong các câu trả lời trước đó. Việc đặt trường này thành false cũng sẽ cho phép thêm một số trường bên trong câu lệnh Đơn giản, lời nhắc Đề xuất và lời nhắc Canvas (một phần của lời nhắc Nội dung). Các nội dung Nội dung và Đường liên kết sẽ luôn bị ghi đè nếu được xác định trong câu lệnh. Giá trị mặc định là false.

object (StaticCanvasPrompt)

Câu trả lời dùng cho trải nghiệm canvas tương tác.

variants: 
  - object (Variant)

object (Variant)

Danh sách các biến thể có thể có.

speech: string
text: string

string

Không bắt buộc. Biểu thị lời nói sẽ được đọc với người dùng. Có thể là SSML hoặc chuyển văn bản sang lời nói. Theo mặc định, lời nói sẽ được thêm vào lời nói của câu lệnh Đơn giản trước đó. Nếu trường override trong câu lệnh chứa câu lệnh là true thì lời nói được xác định trong trường này sẽ ghi đè lời nói của câu lệnh Đơn giản trước đó.

string

Không bắt buộc. Văn bản hiển thị trong bong bóng trò chuyện. Nếu không cung cấp, hình ảnh kết xuất hiển thị của trường lời nói ở trên sẽ được sử dụng. Tối đa 640 ký tự. Theo mặc định, văn bản sẽ được thêm vào văn bản của Câu lệnh đơn giản trước đó. Nếu trường override trong câu lệnh chứa câu lệnh là true, thì văn bản được xác định trong trường này sẽ ghi đè văn bản của câu lệnh Đơn giản trước đó.

# Union field content can be only one of the following:
card: 
  object (StaticCardPrompt)
image: 
  object (StaticImagePrompt)
table: 
  object (StaticTablePrompt)
media: 
  object (StaticMediaPrompt)
list: 
  object (StaticListPrompt)
collection: 
  object (StaticCollectionPrompt)
collectionBrowse: 
  object (StaticCollectionBrowsePrompt)
# End of list of possible types for union field content.

object (StaticCardPrompt)

Một thẻ cơ bản.

object (StaticImagePrompt)

Một hình ảnh.

object (StaticTablePrompt)

Thẻ bảng.

object (StaticMediaPrompt)

Phản hồi cho biết một nhóm nội dung nghe nhìn sẽ phát.

object (StaticListPrompt)

Thẻ để trình bày danh sách các lựa chọn.

object (StaticCollectionPrompt)

Một thẻ trình bày danh sách các lựa chọn để bạn lựa chọn.

object (StaticCollectionBrowsePrompt)

Thẻ trình bày một tập hợp các trang web cần mở.

title: string
subtitle: string
text: string
image: 
  object (StaticImagePrompt)
imageFill: enum (ImageFill)
button: 
  object (StaticLinkPrompt)

string

Không bắt buộc. Tiêu đề chung của thẻ.

string

Không bắt buộc. Tiêu đề phụ của thẻ.

string

Bắt buộc. Văn bản nội dung của thẻ, cần thiết, trừ phi có hình ảnh. Hỗ trợ một số cú pháp đánh dấu có giới hạn để định dạng.

object (StaticImagePrompt)

Không bắt buộc. Hình ảnh chính cho thẻ. Chiều cao được cố định là 192 dp.

enum (ImageFill)

Không bắt buộc. Cách tô nền hình ảnh.

object (StaticLinkPrompt)

Không bắt buộc. Một nút có thể nhấp vào sẽ xuất hiện trong Thẻ.

url: string
alt: string
height: integer
width: integer

string

Bắt buộc. URL nguồn của hình ảnh. Hình ảnh có thể ở định dạng JPG, PNG và GIF (ảnh động và tĩnh). Ví dụ: https://www.agentx.com/logo.png.

string

Bắt buộc. Nội dung mô tả bằng văn bản của hình ảnh dùng để tăng khả năng tiếp cận, ví dụ: trình đọc màn hình.

integer

Không bắt buộc. Chiều cao của hình ảnh tính bằng pixel.

integer

Không bắt buộc. Chiều rộng của hình ảnh tính bằng pixel.

name: string
open: 
  object (OpenUrl)

string

Tên của đường liên kết

object (OpenUrl)

Xác định hành vi khi người dùng mở đường liên kết.

url: string
hint: enum (UrlHint)

string

Trường URL có thể là bất kỳ trường hợp nào sau đây: – URL http/https để mở một Ứng dụng liên kết với ứng dụng hoặc một trang web

enum (UrlHint)

Cho biết gợi ý về loại url.

title: string
subtitle: string
image: 
  object (StaticImagePrompt)
columns: 
  - object (TableColumn)
rows: 
  - object (TableRow)
button: 
  object (StaticLinkPrompt)

string

Không bắt buộc. Tiêu đề chung của bảng. Bạn phải đặt tiêu đề phụ nếu đã đặt tiêu đề phụ.

string

Không bắt buộc. Tiêu đề phụ cho bảng.

object (StaticImagePrompt)

Không bắt buộc. Hình ảnh được liên kết với bảng.

object (TableColumn)

Không bắt buộc. Tiêu đề và căn chỉnh cột.

object (TableRow)

Không bắt buộc. Dữ liệu về hàng của bảng. 3 hàng đầu tiên được đảm bảo sẽ xuất hiện, nhưng các hàng khác có thể bị cắt bớt trên một số nền tảng nhất định. Vui lòng kiểm tra với trình mô phỏng để xem những hàng nào sẽ hiển thị cho một nền tảng nhất định. Trên các nền tảng hỗ trợ chức năng WEB_BROWSER, bạn có thể hướng người dùng đến một trang web có nhiều dữ liệu hơn.

object (StaticLinkPrompt)

Không bắt buộc. Nút.

header: string
align: enum (HorizontalAlignment)

string

Văn bản tiêu đề cho cột.

enum (HorizontalAlignment)

Căn chỉnh theo chiều ngang của cột nội dung. Nếu bạn chưa chỉ định, nội dung sẽ được căn chỉnh theo cạnh trên.

cells: 
  - object (TableCell)
divider: boolean

object (TableCell)

Các ô trong hàng này. 3 ô đầu tiên được đảm bảo sẽ xuất hiện, nhưng các ô khác có thể bị cắt trên một số bề mặt. Vui lòng kiểm tra với trình mô phỏng để xem những ô nào sẽ hiển thị cho một bề mặt nhất định.

boolean

Cho biết có cần có dải phân cách sau mỗi hàng hay không.

text: string

string

Nội dung văn bản của ô.

mediaType: enum (MediaType)
startOffset: string
optionalMediaControls: 
  - enum (OptionalMediaControls)
mediaObjects: 
  - object (MediaObject)
repeatMode: enum (RepeatMode)

enum (MediaType)

Loại nội dung nghe nhìn của câu trả lời này.

string (Duration format)

Độ lệch bắt đầu của đối tượng nội dung nghe nhìn đầu tiên.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

enum (OptionalMediaControls)

Các loại chế độ điều khiển nội dung nghe nhìn (không bắt buộc) mà phiên phản hồi nội dung nghe nhìn này có thể hỗ trợ. Nếu bạn đặt chính sách này, yêu cầu sẽ được gửi đến bên thứ ba khi một sự kiện đa phương tiện nhất định xảy ra. Nếu không được thiết lập, ứng dụng 3p vẫn phải xử lý hai loại điều khiển mặc định là FinishED (KẾT THÚC) và FAILED (KHÔNG THÀNH CÔNG).

object (MediaObject)

Danh sách đối tượng nội dung nghe nhìn.

enum (RepeatMode)

Chế độ lặp lại cho danh sách Đối tượng nội dung đa phương tiện.

name: string
description: string
url: string
image: 
  object (MediaImage)

string

Tên của đối tượng nội dung đa phương tiện này.

string

Nội dung mô tả về đối tượng nội dung nghe nhìn này.

string

URL trỏ đến nội dung đa phương tiện.

object (MediaImage)

Hình ảnh sẽ hiển thị với thẻ nội dung nghe nhìn.

# Union field image can be only one of the following:
large: 
  object (StaticImagePrompt)
icon: 
  object (StaticImagePrompt)
# End of list of possible types for union field image.

object (StaticImagePrompt)

Một hình ảnh lớn, chẳng hạn như ảnh bìa đĩa nhạc, v.v.

object (StaticImagePrompt)

Một biểu tượng hình ảnh nhỏ hiển thị ở bên phải tiêu đề. Kích thước đã đổi kích thước thành 36x36 dp.

title: string
subtitle: string
items: 
  - object (ListItem)

string

Không bắt buộc. Tiêu đề của danh sách.

string

Không bắt buộc. Tiêu đề phụ của danh sách.

object (ListItem)

Bắt buộc. Mục trong danh sách.

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

Bắt buộc. Khoá NLU khớp với tên khoá kết nối trong loại được liên kết. Khi bạn nhấn vào mục, khoá này sẽ được đăng lại dưới dạng thông số lựa chọn.

string

Bắt buộc. Tiêu đề của mặt hàng. Khi được nhấn, văn bản này sẽ được đăng lại nguyên văn vào cuộc trò chuyện như thể người dùng đã nhập văn bản đó. Mỗi tiêu đề phải là duy nhất trong tập hợp các mục.

string

Không bắt buộc. Văn bản nội dung của mặt hàng.

object (StaticImagePrompt)

Không bắt buộc. Hình ảnh mục.

title: string
subtitle: string
items: 
  - object (CollectionItem)
imageFill: enum (ImageFill)

string

Không bắt buộc. Tiêu đề của bộ sưu tập.

string

Không bắt buộc. Tiêu đề phụ của bộ sưu tập.

object (CollectionItem)

Bắt buộc. Các mục trong bộ sưu tập.

enum (ImageFill)

Không bắt buộc. Loại hình ảnh hiển thị.

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

Bắt buộc. Khoá NLU khớp với tên khoá kết nối trong Loại được liên kết. Khi bạn nhấn vào mục, khoá này sẽ được đăng lại dưới dạng thông số lựa chọn.

string

Bắt buộc. Tiêu đề của mặt hàng. Khi được nhấn, văn bản này sẽ được đăng lại nguyên văn vào cuộc trò chuyện như thể người dùng đã nhập văn bản đó. Mỗi tiêu đề phải là duy nhất trong tập hợp các mục.

string

Không bắt buộc. Văn bản nội dung của mặt hàng.

object (StaticImagePrompt)

Không bắt buộc. Hình ảnh mục.

items: 
  - object (CollectionBrowseItem)
imageFill: enum (ImageFill)

object (CollectionBrowseItem)

Các mục trong bộ sưu tập duyệt xem. Kích thước danh sách phải nằm trong khoảng [2, 10].

enum (ImageFill)

Tuỳ chọn hiển thị hình ảnh cho các hình ảnh trong bộ sưu tập.

title: string
description: string
footer: string
image: 
  object (StaticImagePrompt)
openUriAction: 
  object (OpenUrl)

string

Bắt buộc. Tiêu đề của mục trong bộ sưu tập.

string

Nội dung mô tả về mục trong bộ sưu tập.

string

Văn bản chân trang cho mục bộ sưu tập, hiển thị bên dưới nội dung mô tả. Một dòng văn bản, được cắt ngắn bằng dấu ba chấm.

object (StaticImagePrompt)

Hình ảnh cho mục bộ sưu tập.

object (OpenUrl)

Bắt buộc. URI sẽ mở nếu mục được chọn.

title: string

string

Bắt buộc. Văn bản xuất hiện trong khối đề xuất. Khi được nhấn, văn bản này sẽ được đăng lại nguyên văn vào cuộc trò chuyện như thể người dùng đã nhập văn bản đó. Mỗi tiêu đề phải là duy nhất trong tập hợp các khối đề xuất. Tối đa 25 ký tự

url: string
data: 
  - value
suppressMic: boolean
sendStateDataToCanvasApp: boolean
enableFullScreen: boolean
continueTtsDuringTouch: boolean

string

Bắt buộc. URL của chế độ xem trên web cần tải.

value (Value format)

Không bắt buộc. Dữ liệu JSON được truyền đến trang web trải nghiệm sống động dưới dạng sự kiện. Nếu trường override trong câu lệnh chứa false thì giá trị dữ liệu được xác định trong lời nhắc Canvas này sẽ được thêm vào sau giá trị dữ liệu được xác định trong các lời nhắc Canvas trước đó.

boolean

Không bắt buộc. Giá trị true có nghĩa là micrô sẽ không bật để ghi nhận dữ liệu đầu vào sau khi người dùng nhìn thấy phản hồi sống động này.

boolean

Không bắt buộc. Nếu là true, siêu dữ liệu liên quan đến cuộc trò chuyện sẽ được đưa vào và gửi lại cho ứng dụng canvas.

boolean

Không bắt buộc. Nếu true, ứng dụng canvas sẽ chiếm toàn màn hình và không có tiêu đề ở trên cùng. Một thông báo ngắn cũng sẽ xuất hiện trên màn hình tải, bao gồm tên hiển thị của Hành động, tên nhà phát triển và hướng dẫn thoát khỏi Hành động đó. Giá trị mặc định: false.

boolean

Không bắt buộc. Nếu đặt là true, thì các thao tác nhấn vào màn hình sẽ không dừng TTS trong toàn bộ phiên canvas. Giá trị mặc định: false.