Scene

Scene คือหน่วยพื้นฐานของขั้นตอนการควบคุมเมื่อออกแบบการสนทนา ภาพเหล่านี้สามารถเชื่อมโยงเข้ากับฉากอื่นๆ สร้างข้อความแจ้งสำหรับผู้ใช้ปลายทาง และกำหนดช่อง ชื่อโหมดจะระบุไว้ในชื่อไฟล์

การแทน YAML 
onEnter: 
  object (EventHandler)
intentEvents: 
  - object (IntentEvent)
conditionalEvents: 
  - object (ConditionalEvent)
slots: 
  - object (Slot)
onSlotUpdated: 
  object (EventHandler)
ช่อง
onEnter

object (EventHandler)

เครื่องจัดการที่จะเรียกใช้เมื่อเปลี่ยนเข้าสู่โหมดนี้
intentEvents[]

object (IntentEvent)

รายการเหตุการณ์ที่ทริกเกอร์โดยอิงตาม Intent เหตุการณ์เหล่านี้สามารถทริกเกอร์ได้ทุกเมื่อหลังจากมีการเรียก on_load Handler แล้ว สำคัญ - เหตุการณ์เหล่านี้จะกำหนดชุดของ Intent ที่กำหนดขอบเขตไว้ที่โหมดนี้และจะมีลำดับความสำคัญเหนือกว่าเหตุการณ์ที่กำหนดไว้ทั่วโลกซึ่งมี Intent เดียวกันหรือวลีสำหรับทริกเกอร์ ชื่อ Intent ภายในฉากต้องไม่ซ้ำกัน
conditionalEvents[]

object (ConditionalEvent)

รายการเหตุการณ์ที่จะเรียกโดยอิงตามคำสั่งแบบมีเงื่อนไข ระบบจะประเมินสิ่งเหล่านี้หลังจากกรอกแบบฟอร์มแล้วหรือทันทีหลังจาก on_load หากไม่มีแบบฟอร์ม (ประเมินเพียงครั้งเดียว) ระบบจะเรียกเฉพาะเหตุการณ์ที่ตรงกันรายการแรกเท่านั้น
slots[]

object (Slot)

รายการสล็อตที่เรียงลำดับ แต่ละช่องจะกำหนดประเภทของข้อมูลที่จะแก้ไขและกำหนดค่าเพื่อปรับแต่งประสบการณ์ของความละเอียดนี้ (เช่น ข้อความแจ้ง)
onSlotUpdated

object (EventHandler)

มีการเรียกตัวแฮนเดิลเมื่อมีการเปลี่ยนสถานะของช่องที่ไม่ได้เกิดจากการอัปเดตภายในเครื่องจัดการอื่น ซึ่งจะทำให้สล็อตใช้งานไม่ได้ ฉากใช้งานไม่ได้ หรือมีการเปลี่ยนแปลงสถานะฉากแบบอื่นๆ

ช่อง

การกำหนดค่าสำหรับสล็อต สล็อตคือหน่วยข้อมูลเดียวที่เติมผ่านภาษาธรรมชาติ (เช่น พารามิเตอร์ Intent) พารามิเตอร์เซสชัน และแหล่งที่มาอื่นๆ ได้

การแทน YAML 
name: string
type: 
  object (ClassReference)
required: boolean
promptSettings: 
  object (PromptSettings)
commitBehavior: 
  object (CommitBehavior)
config: value
defaultValue: 
  object (DefaultValue)
ช่อง
name

string

ต้องระบุ ชื่อของช่องโฆษณา
type

object (ClassReference)

ต้องระบุ ประกาศประเภทข้อมูลของช่องนี้
required

boolean

ไม่บังคับ ระบุว่าต้องเติมช่องโฆษณาก่อนที่จะเลื่อนไปยังช่องอื่นหรือไม่ ช่องโฆษณาที่จำเป็นที่ไม่ได้รับการเติมโฆษณาจะทริกเกอร์ข้อความแจ้งที่ปรับแต่งได้ให้แก่ผู้ใช้
promptSettings

object (PromptSettings)

ไม่บังคับ ลงทะเบียน แจ้งเตือนสำหรับการใส่ข้อมูลในช่องระยะต่างๆ
commitBehavior

object (CommitBehavior)

ไม่บังคับ ลักษณะการทำงานของคอมมิตที่เชื่อมโยงกับช่องโฆษณา
config

value (Value format)

ไม่บังคับ การกำหนดค่าเพิ่มเติมที่เชื่อมโยงกับช่องโฆษณาซึ่งใช้สำหรับเติมช่องโฆษณา รูปแบบของการกำหนดค่าจะเฉพาะเจาะจงสำหรับประเภทสล็อต เพิ่มการอ้างอิงทรัพยากรไปยังผู้ใช้หรือพารามิเตอร์เซสชันลงในการกำหนดค่านี้ได้ ซึ่งจำเป็นต้องใช้การกำหนดค่านี้สำหรับการเติมเต็มช่องที่เกี่ยวข้องกับธุรกรรมและการมีส่วนร่วมของผู้ใช้

ตัวอย่างเช่น สำหรับสล็อตประเภท actions.type.CompletePurchaseValue การกำหนดค่าต่อไปนี้ให้คำสั่งซื้อสินค้าดิจิทัลที่มีการอ้างอิงไปยังพารามิเตอร์เซสชัน userSelectedSkuId ที่ลูกค้ากำหนด

{ "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" } }
defaultValue

object (DefaultValue)

ไม่บังคับ กำหนดค่าเพื่อเติมค่าเริ่มต้นสำหรับช่องนี้

PromptSettings

ตําแหน่งเดียวที่มีการกำหนดข้อความแจ้งของช่อง

การแทน YAML 
initialPrompt: 
  object (EventHandler)
noMatchPrompt1: 
  object (EventHandler)
noMatchPrompt2: 
  object (EventHandler)
noMatchFinalPrompt: 
  object (EventHandler)
noInputPrompt1: 
  object (EventHandler)
noInputPrompt2: 
  object (EventHandler)
noInputFinalPrompt: 
  object (EventHandler)
ช่อง
initialPrompt

object (EventHandler)

พร้อมท์สำหรับค่าของช่องโฆษณา เช่น "ขนาดที่ต้องการ"
noMatchPrompt1

object (EventHandler)

แจ้งให้ระบุเมื่อข้อมูลของผู้ใช้ไม่ตรงกับประเภทค่าที่คาดไว้สำหรับช่องโฆษณาเป็นครั้งแรก เช่น "ขอโทษที ฉันไม่เข้าใจ"
noMatchPrompt2

object (EventHandler)

แจ้งให้ระบุเมื่ออินพุตของผู้ใช้ไม่ตรงกับประเภทค่าที่คาดไว้สำหรับช่องเป็นครั้งที่ 2 เช่น "ขอโทษที ฉันไม่เข้าใจ"
noMatchFinalPrompt

object (EventHandler)

แจ้งให้ระบุเมื่ออินพุตของผู้ใช้ไม่ตรงกับประเภทค่าที่คาดไว้สำหรับช่องสำหรับครั้งล่าสุด เช่น "ขอโทษที ฉันไม่เข้าใจ"
noInputPrompt1

object (EventHandler)

แจ้งให้ระบุเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลเป็นครั้งแรก เช่น "ขอโทษที ฉันไม่เข้าใจ"
noInputPrompt2

object (EventHandler)

แจ้งให้ระบุเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลเป็นครั้งที่ 2 เช่น "ขอโทษที ฉันไม่เข้าใจ"
noInputFinalPrompt

object (EventHandler)

แจ้งให้ระบุเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลในครั้งล่าสุด เช่น "ขอโทษที ฉันไม่เข้าใจ"

CommitBehavior

ข้อความที่อธิบายลักษณะการคอมมิตที่เชื่อมโยงกับช่องโฆษณาเรียบร้อยแล้ว

การแทน YAML 
writeSessionParam: string
ช่อง
writeSessionParam

string

พารามิเตอร์เซสชันที่จะเขียนค่าช่องโฆษณาหลังจากเติมค่าแล้ว โปรดทราบว่าปัจจุบันยังไม่รองรับเส้นทางที่ซ้อนกัน "$$" ใช้ในการเขียนค่าของสล็อตลงในพารามิเตอร์เซสชันโดยใช้ชื่อเดียวกับช่องโฆษณา เช่น WriteSessionParam = "fruit" จะสอดคล้องกับ "$session.params.fruit" writeSessionParam = "ticket" จะสอดคล้องกับ "$session.params.ticket"

DefaultValue

กำหนดค่าเพื่อเติมค่าเริ่มต้นสำหรับช่องนี้

การแทน YAML 
sessionParam: string
constant: value
ช่อง
sessionParam

string

ไม่บังคับ พารามิเตอร์เซสชันที่จะใช้เริ่มต้นค่าของสล็อต ถ้ามีค่าที่ไม่ว่างเปล่า ประเภทของค่าต้องตรงกับประเภทของช่องโฆษณา โปรดทราบว่าปัจจุบันยังไม่รองรับเส้นทางที่ซ้อนกัน เช่น sessionParam = "fruit" สอดคล้องกับ $session.params.fruit sessionParam = "ticket" สอดคล้องกับ $session.params.ticket
constant

value (Value format)

ไม่บังคับ ค่าเริ่มต้นคงที่สำหรับช่อง ตัวเลือกนี้จะใช้ก็ต่อเมื่อไม่ได้ป้อนข้อมูลค่าสำหรับช่องนี้ผ่าน sessionParam เท่านั้น ประเภทของค่านี้ต้องตรงกับประเภทของช่องโฆษณา