Scene คือหน่วยพื้นฐานของขั้นตอนการควบคุมเมื่อออกแบบการสนทนา ภาพเหล่านี้สามารถเชื่อมโยงเข้ากับฉากอื่นๆ สร้างข้อความแจ้งสำหรับผู้ใช้ปลายทาง และกำหนดช่อง ชื่อโหมดจะระบุไว้ในชื่อไฟล์
การแทน YAML | |
---|---|
onEnter: object ( |
ช่อง | |
---|---|
onEnter |
เครื่องจัดการที่จะเรียกใช้เมื่อเปลี่ยนเข้าสู่โหมดนี้ |
intentEvents[] |
รายการเหตุการณ์ที่ทริกเกอร์โดยอิงตาม Intent เหตุการณ์เหล่านี้สามารถทริกเกอร์ได้ทุกเมื่อหลังจากมีการเรียก on_load Handler แล้ว สำคัญ - เหตุการณ์เหล่านี้จะกำหนดชุดของ Intent ที่กำหนดขอบเขตไว้ที่โหมดนี้และจะมีลำดับความสำคัญเหนือกว่าเหตุการณ์ที่กำหนดไว้ทั่วโลกซึ่งมี Intent เดียวกันหรือวลีสำหรับทริกเกอร์ ชื่อ Intent ภายในฉากต้องไม่ซ้ำกัน |
conditionalEvents[] |
รายการเหตุการณ์ที่จะเรียกโดยอิงตามคำสั่งแบบมีเงื่อนไข ระบบจะประเมินสิ่งเหล่านี้หลังจากกรอกแบบฟอร์มแล้วหรือทันทีหลังจาก on_load หากไม่มีแบบฟอร์ม (ประเมินเพียงครั้งเดียว) ระบบจะเรียกเฉพาะเหตุการณ์ที่ตรงกันรายการแรกเท่านั้น |
slots[] |
รายการสล็อตที่เรียงลำดับ แต่ละช่องจะกำหนดประเภทของข้อมูลที่จะแก้ไขและกำหนดค่าเพื่อปรับแต่งประสบการณ์ของความละเอียดนี้ (เช่น ข้อความแจ้ง) |
onSlotUpdated |
มีการเรียกตัวแฮนเดิลเมื่อมีการเปลี่ยนสถานะของช่องที่ไม่ได้เกิดจากการอัปเดตภายในเครื่องจัดการอื่น ซึ่งจะทำให้สล็อตใช้งานไม่ได้ ฉากใช้งานไม่ได้ หรือมีการเปลี่ยนแปลงสถานะฉากแบบอื่นๆ |
ช่อง
การกำหนดค่าสำหรับสล็อต สล็อตคือหน่วยข้อมูลเดียวที่เติมผ่านภาษาธรรมชาติ (เช่น พารามิเตอร์ Intent) พารามิเตอร์เซสชัน และแหล่งที่มาอื่นๆ ได้
การแทน YAML | |
---|---|
name: string type: object ( |
ช่อง | |
---|---|
name |
ต้องระบุ ชื่อของช่องโฆษณา |
type |
ต้องระบุ ประกาศประเภทข้อมูลของช่องนี้ |
required |
ไม่บังคับ ระบุว่าต้องเติมช่องโฆษณาก่อนที่จะเลื่อนไปยังช่องอื่นหรือไม่ ช่องโฆษณาที่จำเป็นที่ไม่ได้รับการเติมโฆษณาจะทริกเกอร์ข้อความแจ้งที่ปรับแต่งได้ให้แก่ผู้ใช้ |
promptSettings |
ไม่บังคับ ลงทะเบียน แจ้งเตือนสำหรับการใส่ข้อมูลในช่องระยะต่างๆ |
commitBehavior |
ไม่บังคับ ลักษณะการทำงานของคอมมิตที่เชื่อมโยงกับช่องโฆษณา |
config |
ไม่บังคับ การกำหนดค่าเพิ่มเติมที่เชื่อมโยงกับช่องโฆษณาซึ่งใช้สำหรับเติมช่องโฆษณา รูปแบบของการกำหนดค่าจะเฉพาะเจาะจงสำหรับประเภทสล็อต เพิ่มการอ้างอิงทรัพยากรไปยังผู้ใช้หรือพารามิเตอร์เซสชันลงในการกำหนดค่านี้ได้ ซึ่งจำเป็นต้องใช้การกำหนดค่านี้สำหรับการเติมเต็มช่องที่เกี่ยวข้องกับธุรกรรมและการมีส่วนร่วมของผู้ใช้ ตัวอย่างเช่น สำหรับสล็อตประเภท actions.type.CompletePurchaseValue การกำหนดค่าต่อไปนี้ให้คำสั่งซื้อสินค้าดิจิทัลที่มีการอ้างอิงไปยังพารามิเตอร์เซสชัน { "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" } } |
defaultValue |
ไม่บังคับ กำหนดค่าเพื่อเติมค่าเริ่มต้นสำหรับช่องนี้ |
PromptSettings
ตําแหน่งเดียวที่มีการกำหนดข้อความแจ้งของช่อง
การแทน YAML | |
---|---|
initialPrompt: object ( |
ช่อง | |
---|---|
initialPrompt |
พร้อมท์สำหรับค่าของช่องโฆษณา เช่น "ขนาดที่ต้องการ" |
noMatchPrompt1 |
แจ้งให้ระบุเมื่อข้อมูลของผู้ใช้ไม่ตรงกับประเภทค่าที่คาดไว้สำหรับช่องโฆษณาเป็นครั้งแรก เช่น "ขอโทษที ฉันไม่เข้าใจ" |
noMatchPrompt2 |
แจ้งให้ระบุเมื่ออินพุตของผู้ใช้ไม่ตรงกับประเภทค่าที่คาดไว้สำหรับช่องเป็นครั้งที่ 2 เช่น "ขอโทษที ฉันไม่เข้าใจ" |
noMatchFinalPrompt |
แจ้งให้ระบุเมื่ออินพุตของผู้ใช้ไม่ตรงกับประเภทค่าที่คาดไว้สำหรับช่องสำหรับครั้งล่าสุด เช่น "ขอโทษที ฉันไม่เข้าใจ" |
noInputPrompt1 |
แจ้งให้ระบุเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลเป็นครั้งแรก เช่น "ขอโทษที ฉันไม่เข้าใจ" |
noInputPrompt2 |
แจ้งให้ระบุเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลเป็นครั้งที่ 2 เช่น "ขอโทษที ฉันไม่เข้าใจ" |
noInputFinalPrompt |
แจ้งให้ระบุเมื่อผู้ใช้ไม่ได้ป้อนข้อมูลในครั้งล่าสุด เช่น "ขอโทษที ฉันไม่เข้าใจ" |
CommitBehavior
ข้อความที่อธิบายลักษณะการคอมมิตที่เชื่อมโยงกับช่องโฆษณาเรียบร้อยแล้ว
การแทน YAML | |
---|---|
writeSessionParam: string |
ช่อง | |
---|---|
writeSessionParam |
พารามิเตอร์เซสชันที่จะเขียนค่าช่องโฆษณาหลังจากเติมค่าแล้ว โปรดทราบว่าปัจจุบันยังไม่รองรับเส้นทางที่ซ้อนกัน "$$" ใช้ในการเขียนค่าของสล็อตลงในพารามิเตอร์เซสชันโดยใช้ชื่อเดียวกับช่องโฆษณา เช่น WriteSessionParam = "fruit" จะสอดคล้องกับ "$session.params.fruit" writeSessionParam = "ticket" จะสอดคล้องกับ "$session.params.ticket" |
DefaultValue
กำหนดค่าเพื่อเติมค่าเริ่มต้นสำหรับช่องนี้
การแทน YAML | |
---|---|
sessionParam: string constant: value |
ช่อง | |
---|---|
sessionParam |
ไม่บังคับ พารามิเตอร์เซสชันที่จะใช้เริ่มต้นค่าของสล็อต ถ้ามีค่าที่ไม่ว่างเปล่า ประเภทของค่าต้องตรงกับประเภทของช่องโฆษณา โปรดทราบว่าปัจจุบันยังไม่รองรับเส้นทางที่ซ้อนกัน เช่น |
constant |
ไม่บังคับ ค่าเริ่มต้นคงที่สำหรับช่อง ตัวเลือกนี้จะใช้ก็ต่อเมื่อไม่ได้ป้อนข้อมูลค่าสำหรับช่องนี้ผ่าน |